nansen-cli 1.0.2 → 1.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +9 -4
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -125,13 +125,15 @@ Deep analytics for any token.
125
125
  | Option | Description |
126
126
  |--------|-------------|
127
127
  | `--pretty` | Format JSON output for readability |
128
+ | `--table` | Format output as human-readable table |
128
129
  | `--chain <chain>` | Blockchain to query |
129
130
  | `--chains <json>` | Multiple chains as JSON array |
130
131
  | `--limit <n>` | Number of results |
131
132
  | `--days <n>` | Date range in days (default: 30) |
133
+ | `--sort <field:dir>` | Sort results (e.g., `--sort value_usd:desc`) |
132
134
  | `--symbol <sym>` | Token symbol for perp endpoints (e.g., BTC, ETH) |
133
135
  | `--filters <json>` | Filter criteria as JSON |
134
- | `--order-by <json>` | Sort order as JSON array |
136
+ | `--order-by <json>` | Sort order as JSON array (advanced) |
135
137
  | `--labels <label>` | Smart Money label filter |
136
138
  | `--smart-money` | Filter for Smart Money only |
137
139
  | `--timeframe <tf>` | Time window (5m, 10m, 1h, 6h, 24h, 7d, 30d) |
@@ -171,8 +173,11 @@ The CLI is designed for AI agents and automation:
171
173
  ## Examples
172
174
 
173
175
  ```bash
176
+ # Get trending tokens as a table, sorted by volume
177
+ nansen token screener --chain solana --sort buy_volume:desc --table
178
+
174
179
  # Get Smart Money DEX trades from Funds only
175
- nansen smart-money dex-trades --chain ethereum --labels Fund
180
+ nansen smart-money dex-trades --chain ethereum --labels Fund --table
176
181
 
177
182
  # Get token holders with Smart Money filter
178
183
  nansen token holders --token So11111111111111111111111111111111111111112 --chain solana --smart-money
@@ -183,8 +188,8 @@ nansen smart-money historical-holdings --chain solana --days 7
183
188
  # Get BTC perpetual positions on Hyperliquid
184
189
  nansen token perp-positions --symbol BTC --pretty
185
190
 
186
- # Get top PnL traders for a token
187
- nansen token pnl --token JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN --chain solana --days 30
191
+ # Get top PnL traders for a token, sorted by realized PnL
192
+ nansen token pnl --token JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN --chain solana --days 30 --sort pnl_usd:desc --table
188
193
  ```
189
194
 
190
195
  ## Development
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "nansen-cli",
3
- "version": "1.0.2",
3
+ "version": "1.0.3",
4
4
  "description": "Command-line interface for Nansen API - designed for AI agents",
5
5
  "main": "src/index.js",
6
6
  "type": "module",