nansen-cli 1.11.0 → 1.11.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.11.1
+
+### Patch Changes
+
+- [#194](https://github.com/nansen-ai/nansen-cli/pull/194) [`89225f5`](https://github.com/nansen-ai/nansen-cli/commit/89225f5d5b566f7eda77b1876c77545c2feb6a1c) Thanks [@TimNooren](https://github.com/TimNooren)! - fix: --help on trade subcommands and wallet subcommands now shows full help identical to the no-args case
+
+- [#199](https://github.com/nansen-ai/nansen-cli/pull/199) [`9ae981e`](https://github.com/nansen-ai/nansen-cli/commit/9ae981e6dcf7fa663e47a3608afab7f12e0a9463) Thanks [@TimNooren](https://github.com/TimNooren)! - fix: replace misleading `walletconnect connect` command reference in x402 payment error with actionable guidance mentioning both local wallet (`nansen wallet create`) and external WalletConnect CLI options
+
 ## 1.11.0
 
 ### Minor Changes

package/package.json

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

package/src/api.js

@@ -578,9 +578,20 @@ export class NansenAPI {
                     return await paidResponse.json();
                   }
                 } catch (x402Err) {
-                  message = `x402 auto-payment failed: ${x402Err.message}`;
+                  if (!this.apiKey) {
+                    // No API key and no payment wallet — guide the user to login rather than
+                    // showing a confusing x402 payment dump they can't act on.
+                    // TODO: full fix would skip x402 entirely when no apiKey is set — see PR #<this PR number>
+                    message = 'No API key configured. Run: nansen login --api-key <key>. Get your key at https://app.nansen.ai/api';
+                  } else {
+                    message = `x402 auto-payment failed: ${x402Err.message}`;
+                  }
+                }
+                // Only include raw payment requirements in the error details when the user
+                // has an API key — for unauthenticated users they add noise, not signal.
+                if (this.apiKey) {
+                  data.paymentRequirements = paymentRequirements;
                 }
-                data.paymentRequirements = paymentRequirements;
               }
             }
           }

package/src/cli.js

@@ -642,9 +642,10 @@ EXAMPLES:
   nansen research smart-money netflow --chain solana
   nansen research token screener --chain solana --timeframe 24h
   nansen research profiler balance --address 0x... --chain ethereum
-  nansen trade quote --chain ethereum --from ETH --to USDC --amount 1
+  nansen trade quote --chain base --from ETH --to USDC --amount 1
 
-Chains: ethereum, solana, base, bnb, arbitrum, polygon, optimism, avalanche, linea, scroll, mantle, ronin, sei, plasma, sonic, monad, hyperevm, iotaevm
+Research chains: ethereum, solana, base, bnb, arbitrum, polygon, optimism, avalanche, linea, scroll, mantle, ronin, sei, plasma, sonic, monad, hyperevm, iotaevm
+Trade chains: solana, base
 Labels: Fund, Smart Trader, 30D/90D/180D Smart Trader, Smart HL Perps Trader
 
 Docs: https://docs.nansen.ai
@@ -1079,6 +1080,28 @@ export function buildCommands(deps = {}) {
 
       let result = await handlers[subcommand]();
 
+      // Warn when OHLCV price data is null (backend coverage gap)
+      // Volume comes from on-chain DEX data and is always available, but price/market_cap
+      // requires a price oracle — some tokens are not tracked and return all-null price fields.
+      if (subcommand === 'ohlcv') {
+        const candles = Array.isArray(result?.data) ? result.data : [];
+        if (candles.length === 0) {
+          process.stderr.write(`⚠️  No OHLCV data returned for token ${tokenAddress} on ${chain}.\n`);
+        } else {
+          const hasPrice = candles.some(c => c.open !== null || c.close !== null);
+          const hasVolume = candles.some(c => c.volume !== null);
+          if (!hasPrice && hasVolume) {
+            process.stderr.write(
+              `⚠️  Price data unavailable for token ${tokenAddress} on ${chain}.\n` +
+              `   open/high/low/close, volume_usd, and market_cap are null.\n` +
+              `   Volume (raw token units) is available. This token may not be tracked by Nansen's price oracle.\n`
+            );
+          } else if (!hasPrice && !hasVolume) {
+            process.stderr.write(`⚠️  No OHLCV data available for token ${tokenAddress} on ${chain}.\n`);
+          }
+        }
+      }
+
       // Enrich transfers with Nansen labels for from/to addresses
       if (subcommand === 'transfers' && (options.enrich || flags.enrich)) {
         result = await enrichTransfers(result, apiInstance, chain);
@@ -1360,17 +1383,9 @@ export async function runCLI(rawArgs, deps = {}) {
           return { type: 'command-help', command: `research ${category}` };
         }
       }
-      // Handle 'trade <sub> --help'
-      if (command === 'trade' && subcommand) {
-        const tradeSchema = SCHEMA.commands.trade?.subcommands?.[subcommand];
-        if (tradeSchema) {
-          output(`\ntrade ${subcommand} - ${tradeSchema.description}\n`);
-          notify();
-          return { type: 'subcommand-help', command: 'trade', subcommand };
-        }
-      }
       // First try subcommand help
-      if (command && subcommand) {
+      // Skip for 'trade' — its handlers show their own rich usage when required args are missing
+      if (command && subcommand && command !== 'trade') {
         const subHelp = generateSubcommandHelp(command, subcommand);
         if (subHelp) {
           output(subHelp);
@@ -1379,7 +1394,8 @@ export async function runCLI(rawArgs, deps = {}) {
         }
       }
       // Then try command-level help (list subcommands)
-      const cmdSchemaLookup = SCHEMA.commands[command] || SCHEMA.commands.research.subcommands[command];
+      // Skip for 'trade' — let the handler show its own usage
+      const cmdSchemaLookup = command !== 'trade' && (SCHEMA.commands[command] || SCHEMA.commands.research.subcommands[command]);
       if (command && cmdSchemaLookup) {
         const cmdSchema = cmdSchemaLookup;
         const lines = [`${command} — ${cmdSchema.description}`];

package/src/schema.json

@@ -157,6 +157,14 @@
                 "page": {
                   "type": "number",
                   "description": "Page number for paginated results (default: 1)"
+                },
+                "sort": {
+                  "type": "string",
+                  "description": "Sort field:direction (e.g., value_usd:desc)"
+                },
+                "filters": {
+                  "type": "object",
+                  "description": "Additional filters as JSON"
                 }
               },
               "returns": [
@@ -178,6 +186,14 @@
                 "limit": {
                   "type": "number"
                 },
+                "labels": {
+                  "type": "string|array",
+                  "description": "Smart Money label filter"
+                },
+                "sort": {
+                  "type": "string",
+                  "description": "Sort field:direction (e.g., deposit_value_usd:desc)"
+                },
                 "filters": {
                   "type": "object"
                 },
@@ -224,6 +240,18 @@
                 "page": {
                   "type": "number",
                   "description": "Page number for paginated results (default: 1)"
+                },
+                "labels": {
+                  "type": "string|array",
+                  "description": "Smart Money label filter"
+                },
+                "sort": {
+                  "type": "string",
+                  "description": "Sort field:direction (e.g., value_usd:desc)"
+                },
+                "filters": {
+                  "type": "object",
+                  "description": "Additional filters as JSON"
                 }
               },
               "returns": [

package/src/wallet.js

@@ -753,6 +753,11 @@ EXAMPLES:
         return;
       }
 
+      // --help on any wallet subcommand shows wallet help instead of executing
+      if (flags.help || flags.h) {
+        return handlers['help']();
+      }
+
       return handlers[subcommand]();
     },
   };

package/src/walletconnect-x402.js

@@ -142,7 +142,9 @@ export async function handleX402Payment(paymentRequirements) {
   const wallet = await checkWalletConnection();
   if (!wallet) {
     throw new NansenError(
-      'x402 payment required but no wallet connected. Run `walletconnect connect` first.',
+      'x402 payment required but no wallet connected. ' +
+        'To pay automatically: create a local wallet with `nansen wallet create` (then set NANSEN_WALLET_PASSWORD), ' +
+        'or connect an external wallet via the `walletconnect` CLI (`walletconnect connect`).',
       ErrorCode.PAYMENT_REQUIRED,
       402
     );