nansen-cli 1.0.1 → 1.0.3

package/README.md

@@ -125,13 +125,15 @@ Deep analytics for any token.
 | Option | Description |
 |--------|-------------|
 | `--pretty` | Format JSON output for readability |
+| `--table` | Format output as human-readable table |
 | `--chain <chain>` | Blockchain to query |
 | `--chains <json>` | Multiple chains as JSON array |
 | `--limit <n>` | Number of results |
 | `--days <n>` | Date range in days (default: 30) |
+| `--sort <field:dir>` | Sort results (e.g., `--sort value_usd:desc`) |
 | `--symbol <sym>` | Token symbol for perp endpoints (e.g., BTC, ETH) |
 | `--filters <json>` | Filter criteria as JSON |
-| `--order-by <json>` | Sort order as JSON array |
+| `--order-by <json>` | Sort order as JSON array (advanced) |
 | `--labels <label>` | Smart Money label filter |
 | `--smart-money` | Filter for Smart Money only |
 | `--timeframe <tf>` | Time window (5m, 10m, 1h, 6h, 24h, 7d, 30d) |
@@ -171,8 +173,11 @@ The CLI is designed for AI agents and automation:
 ## Examples
 
 ```bash
+# Get trending tokens as a table, sorted by volume
+nansen token screener --chain solana --sort buy_volume:desc --table
+
 # Get Smart Money DEX trades from Funds only
-nansen smart-money dex-trades --chain ethereum --labels Fund
+nansen smart-money dex-trades --chain ethereum --labels Fund --table
 
 # Get token holders with Smart Money filter
 nansen token holders --token So11111111111111111111111111111111111111112 --chain solana --smart-money
@@ -183,8 +188,8 @@ nansen smart-money historical-holdings --chain solana --days 7
 # Get BTC perpetual positions on Hyperliquid
 nansen token perp-positions --symbol BTC --pretty
 
-# Get top PnL traders for a token
-nansen token pnl --token JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN --chain solana --days 30
+# Get top PnL traders for a token, sorted by realized PnL
+nansen token pnl --token JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN --chain solana --days 30 --sort pnl_usd:desc --table
 ```
 
 ## Development

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nansen-cli",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Command-line interface for Nansen API - designed for AI agents",
   "main": "src/index.js",
   "type": "module",

package/src/index.js

@@ -156,6 +156,22 @@ function errorOutput(error, pretty = false, table = false) {
   process.exit(1);
 }
 
+// Parse simple sort syntax: "field:direction" or "field" (defaults to DESC)
+function parseSort(sortOption, orderByOption) {
+  // If --order-by is provided, use it (full JSON control)
+  if (orderByOption) return orderByOption;
+  
+  // If no --sort, return undefined
+  if (!sortOption) return undefined;
+  
+  // Parse --sort field:direction or --sort field
+  const parts = sortOption.split(':');
+  const field = parts[0];
+  const direction = (parts[1] || 'desc').toUpperCase();
+  
+  return [{ field, direction }];
+}
+
 // Help text
 const HELP = `
 Nansen CLI - Command-line interface for Nansen API
@@ -180,7 +196,8 @@ GLOBAL OPTIONS:
   --chains       Multiple chains as JSON array
   --limit        Number of results (shorthand for pagination)
   --filters      JSON object with filters
-  --order-by     JSON array with sort order
+  --sort         Sort by field (e.g., --sort value_usd:desc)
+  --order-by     JSON array with sort order (advanced)
   --days         Date range in days (default: 30 for most endpoints)
   --symbol       Token symbol (for perp endpoints)
 
@@ -316,7 +333,7 @@ const commands = {
     const chain = options.chain || 'solana';
     const chains = options.chains || [chain];
     const filters = options.filters || {};
-    const orderBy = options['order-by'];
+    const orderBy = parseSort(options.sort, options['order-by']);
     const pagination = options.limit ? { page: 1, per_page: options.limit } : undefined;
 
     // Add smart money label filter if specified
@@ -355,7 +372,7 @@ const commands = {
     const entityName = options.entity || options['entity-name'];
     const chain = options.chain || 'ethereum';
     const filters = options.filters || {};
-    const orderBy = options['order-by'];
+    const orderBy = parseSort(options.sort, options['order-by']);
     const pagination = options.limit ? { page: 1, recordsPerPage: options.limit } : undefined;
     const days = options.days ? parseInt(options.days) : 30;
 
@@ -393,7 +410,7 @@ const commands = {
     const chains = options.chains || [chain];
     const timeframe = options.timeframe || '24h';
     const filters = options.filters || {};
-    const orderBy = options['order-by'];
+    const orderBy = parseSort(options.sort, options['order-by']);
     const pagination = options.limit ? { page: 1, per_page: options.limit } : undefined;
     const days = options.days ? parseInt(options.days) : 30;