nansen-cli 1.18.0 → 1.20.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 1.20.0
+
+### Minor Changes
+
+- [#302](https://github.com/nansen-ai/nansen-cli/pull/302) [`3f0a5ab`](https://github.com/nansen-ai/nansen-cli/commit/3f0a5abad463c0386122efbe746809913aa823ba) Thanks [@arein](https://github.com/arein)! - Add post-install onboarding that interactively offers to install the Nansen AI coding skill and run a test query after `npm install -g nansen-cli`. Non-interactive environments (CI, piped stdin) receive a one-liner tip and are never blocked.
+
+### Patch Changes
+
+- [#313](https://github.com/nansen-ai/nansen-cli/pull/313) [`bb4d9e4`](https://github.com/nansen-ai/nansen-cli/commit/bb4d9e475158147645cae9b8bdd2555568a1e515) Thanks [@0xlaveen](https://github.com/0xlaveen)! - Update API key setup URL from app.nansen.ai/api to app.nansen.ai/auth/agent-setup across CLI help text, error messages, README, and postinstall script.
+
+## 1.19.0
+
+### Minor Changes
+
+- [#306](https://github.com/nansen-ai/nansen-cli/pull/306) [`f685eb8`](https://github.com/nansen-ai/nansen-cli/commit/f685eb8b87d2915a7a94e8c1a3d92f84e4802e4a) Thanks [@0xlaveen](https://github.com/0xlaveen)! - Rename 30 skills for clarity and clawhub slug uniqueness. Abbreviations expanded (`pm` → `polymarket`, `sm` prefix added where relevant), ambiguous names made specific (`nansen-wallet` → `nansen-wallet-manager`, `nansen-profiler` → `nansen-wallet-profiler`, `nansen-search` → `nansen-general-search`, `nansen-trade` → `nansen-trading`, etc.).
+
+### Patch Changes
+
+- [#308](https://github.com/nansen-ai/nansen-cli/pull/308) [`569d7d4`](https://github.com/nansen-ai/nansen-cli/commit/569d7d43e428732d3c10b4e57368cb12ef0086c3) Thanks [@kome12](https://github.com/kome12)! - fix: include src subdirectories in npm package
+
+  The `files` field in package.json used `src/*.js` which only matched files directly in `src/`, causing `src/commands/` to be missing from the 1.18.0 publish. Changed to `src/**/*.js` to include all subdirectories recursively, and added `!src/__tests__/**` to exclude test files from the package.
+
 ## 1.18.0
 
 ### Minor Changes

package/README.md

@@ -15,11 +15,13 @@ npx skills add nansen-ai/nansen-cli  # load agent skill files
 ## Auth
 
 ```bash
-nansen login              # interactive — saves to ~/.nansen/config.json
-export NANSEN_API_KEY=... # or env var (highest priority)
+nansen login --api-key <key>   # save key to ~/.nansen/config.json
+nansen login --human           # interactive prompt
+export NANSEN_API_KEY=...      # env var (highest priority)
+nansen logout                  # remove saved key
 ```
 
-Get your API key at [app.nansen.ai/api](https://app.nansen.ai/api). AI agents can use the [Agent Setup](https://app.nansen.ai/auth/agent-setup) flow instead.
+Get your API key at [app.nansen.ai/auth/agent-setup](https://app.nansen.ai/auth/agent-setup).
 
 ## Commands
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nansen-cli",
-  "version": "1.18.0",
+  "version": "1.20.0",
   "description": "Command-line interface for Nansen API - designed for AI agents",
   "main": "src/index.js",
   "type": "module",
@@ -8,12 +8,15 @@
     "nansen": "./src/index.js"
   },
   "files": [
-    "src/*.js",
-    "src/*.json",
+    "src/**/*.js",
+    "src/**/*.json",
+    "!src/__tests__/**",
     "skills/**",
+    "scripts/postinstall.js",
     "CHANGELOG.md"
   ],
   "scripts": {
+    "postinstall": "node scripts/postinstall.js",
     "start": "node src/index.js",
     "pretest": "node scripts/check-changeset.js",
     "test": "vitest run",

package/scripts/postinstall.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install onboarding for nansen-cli.
+ *
+ * Runs after `npm install -g nansen-cli` and offers two optional steps:
+ *   1. Install the Nansen AI coding skill (`npx skills add nansen-ai/nansen-cli`)
+ *   2. Check account status to verify the API key works (0 credits)
+ *
+ * Non-interactive environments (CI, piped stdin) get a one-liner tip instead.
+ * Always exits 0 — onboarding failures must never break installation.
+ */
+
+import { createInterface } from "readline";
+import { execFileSync, spawn } from "child_process";
+import { existsSync, readFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+const BOLD = "\x1b[1m";
+const DIM = "\x1b[2m";
+const GREEN = "\x1b[32m";
+const YELLOW = "\x1b[33m";
+const CYAN = "\x1b[36m";
+const RESET = "\x1b[0m";
+
+const SKILL_REPO = "nansen-ai/nansen-cli";
+const TEST_QUERY = ["account"];
+const TEST_QUERY_DISPLAY = "nansen account";
+
+// Path to the CLI entry point (works even if `nansen` bin isn't linked yet)
+const CLI_ENTRY = join(__dirname, "..", "src", "index.js");
+
+function log(msg = "") {
+  process.stderr.write(`  ${msg}\n`);
+}
+
+function hasTTY() {
+  return process.stdin.isTTY && process.stderr.isTTY;
+}
+
+function hasNpx() {
+  try {
+    execFileSync("npx", ["--version"], { stdio: "ignore", shell: process.platform === "win32" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function isLoggedIn() {
+  const home = process.env.HOME || process.env.USERPROFILE || "";
+  const configFile = join(home, ".nansen", "config.json");
+  if (!existsSync(configFile)) return false;
+  try {
+    const config = JSON.parse(readFileSync(configFile, "utf8"));
+    return !!(config.apiKey || config.api_key);
+  } catch {
+    return false;
+  }
+}
+
+function isSkillInstalled() {
+  const home = process.env.HOME || process.env.USERPROFILE || "";
+  const locations = [
+    join(home, ".claude", "skills", "nansen-cli"),
+    join(home, ".claude", "skills", "nansen-ai--nansen-cli"),
+  ];
+  return locations.some((loc) => existsSync(loc));
+}
+
+function prompt(question) {
+  return new Promise((resolve) => {
+    const rl = createInterface({ input: process.stdin, output: process.stderr });
+    let answered = false;
+    rl.on("close", () => { if (!answered) resolve(""); });
+    rl.question(question, (answer) => {
+      answered = true;
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+function runCommand(cmd, args) {
+  return new Promise((resolve) => {
+    const child = spawn(cmd, args, { stdio: "inherit", shell: process.platform === "win32" });
+    child.on("close", (code) => resolve(code === 0));
+    child.on("error", () => resolve(false));
+  });
+}
+
+async function installSkill() {
+  if (isSkillInstalled()) {
+    log(`${GREEN}✓${RESET} Nansen skill already installed.`);
+    return;
+  }
+
+  if (!hasNpx()) {
+    log(`${DIM}Tip: Run 'npx skills add ${SKILL_REPO}' to install the Nansen AI coding skill.${RESET}`);
+    return;
+  }
+
+  log(`The Nansen skill lets AI coding agents (Cursor, Claude Code, etc.) query`);
+  log(`on-chain data, track smart money, and analyze tokens on your behalf.`);
+  const answer = await prompt(`  Install Nansen skill for your AI coding agent? [Y/n] `);
+
+  if (/^n/i.test(answer)) {
+    log(`Skipped. You can install it later with: ${CYAN}npx skills add ${SKILL_REPO}${RESET}`);
+    return;
+  }
+
+  log(`Installing Nansen skill...`);
+  const ok = await runCommand("npx", ["-y", "skills", "add", SKILL_REPO]);
+  if (!ok) {
+    log(`${YELLOW}Skill installation failed. You can retry with: npx skills add ${SKILL_REPO}${RESET}`);
+  }
+}
+
+async function testQuery() {
+  if (!isLoggedIn()) {
+    log();
+    log(`Not logged in yet. Run ${CYAN}nansen login --api-key <key>${RESET} to authenticate.`);
+    log(`Get your API key at: ${CYAN}https://app.nansen.ai/auth/agent-setup${RESET}`);
+    return;
+  }
+
+  log();
+  log(`Your API key is configured. Let's verify it works.`);
+  const answer = await prompt(`  Check account status? (${DIM}${TEST_QUERY_DISPLAY}${RESET}) [Y/n] `);
+
+  if (/^n/i.test(answer)) {
+    log(`Skipped. You're all set! Try: ${CYAN}nansen research smart-money netflow --chain solana${RESET}`);
+    return;
+  }
+
+  log(`Running: ${DIM}${TEST_QUERY_DISPLAY}${RESET}`);
+  log();
+  // Use process.execPath + CLI_ENTRY so it works even if `nansen` bin isn't linked yet
+  const ok = await runCommand(process.execPath, [CLI_ENTRY, ...TEST_QUERY, "--pretty"]);
+  if (ok) {
+    log();
+    log(`${GREEN}✓${RESET} All set! Run ${CYAN}nansen help${RESET} to see all available commands.`);
+  } else {
+    log();
+    log(`${YELLOW}Query failed. Check your API key with: nansen login --api-key <key>${RESET}`);
+  }
+}
+
+async function main() {
+  // Only run for global installs; skip local npm install / npm ci
+  if (process.env.npm_lifecycle_event === "postinstall" && process.env.npm_config_global !== "true") {
+    return;
+  }
+
+  log();
+
+  if (!hasTTY()) {
+    log(`${BOLD}Nansen CLI installed!${RESET}`);
+    log();
+    log(`Tip: Run '${CYAN}npx skills add ${SKILL_REPO}${RESET}' to install the Nansen AI coding skill.`);
+    log(`Tip: Run '${CYAN}nansen login --api-key <key>${RESET}' to authenticate.`);
+    return;
+  }
+
+  log(`${BOLD}Nansen CLI installed!${RESET}`);
+  log();
+
+  await installSkill();
+  await testQuery();
+
+  log();
+}
+
+main().catch(() => {
+  // Never fail installation due to onboarding errors
+});

package/skills/{nansen-dca-watch → nansen-dca-tracker}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-dca-watch
+name: nansen-dca-tracker
 description: "What tokens are whales dollar-cost averaging into? Jupiter DCA strategies by smart money and target token fundamentals."
 metadata:
   openclaw:

package/skills/{nansen-defi-exposure → nansen-defi-positions}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-defi-exposure
+name: nansen-defi-positions
 description: "What DeFi positions does a wallet hold? Protocol-by-protocol breakdown of assets, debts, and rewards across chains."
 metadata:
   openclaw:

package/skills/{nansen-exit-signal → nansen-exit-signals}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-exit-signal
+name: nansen-exit-signals
 description: "Is smart money exiting a token I hold? Net flow direction, seller breakdown by label, and recent SM trades."
 metadata:
   openclaw:

package/skills/{nansen-fund-watch → nansen-fund-tracker}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-fund-watch
+name: nansen-fund-tracker
 description: "What are crypto funds and VCs holding right now? Cross-chain fund portfolios and net accumulation signals."
 metadata:
   openclaw:

package/skills/{nansen-search → nansen-general-search}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-search
+name: nansen-general-search
 description: Search for tokens or entities by name. Use when you have a token name and need the full address, or want to find an entity.
 metadata:
   openclaw:

package/skills/{nansen-holder-quality → nansen-holder-analysis}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-holder-quality
+name: nansen-holder-analysis
 description: "Is this token held by quality wallets or retail noise? SM holder ratio, flow breakdown by label, and recent buyer quality."
 metadata:
   openclaw:

package/skills/{nansen-perp-scan → nansen-perp-screener}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-perp-scan
+name: nansen-perp-screener
 description: "What is the state of the Hyperliquid perp market? Top contracts by volume/OI, trader leaderboard, and SM perp activity."
 metadata:
   openclaw:

package/skills/{nansen-perp-trader → nansen-perp-trader-profile}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-perp-trader
+name: nansen-perp-trader-profile
 description: "Deep dive on a Hyperliquid perp trader. Identity, open positions, recent trades, and overall PnL."
 metadata:
   openclaw:

package/skills/{nansen-pm-deep-dive → nansen-polymarket-deep-dive}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-pm-deep-dive
+name: nansen-polymarket-deep-dive
 description: "Deep dive on a Polymarket market — OHLCV, orderbook, top holders, positions, trades, and PnL leaderboard. Use when analysing a specific prediction market."
 metadata:
   openclaw:

package/skills/{nansen-pm-insider-scan → nansen-polymarket-insider-scan}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-pm-insider-scan
+name: nansen-polymarket-insider-scan
 description: "Scan a resolved Polymarket market for wallets exhibiting suspicious trading patterns: fresh funding, single-market focus, extreme ROI, late entry at high prices."
 metadata:
   openclaw:

package/skills/{nansen-polymarket-trader → nansen-polymarket-trader-profile}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-polymarket-trader
+name: nansen-polymarket-trader-profile
 description: "What is a Polymarket trader betting on? Trades by address, PnL breakdown, and market context. Use when analysing a specific Polymarket wallet."
 metadata:
   openclaw:

package/skills/{nansen-portfolio-history → nansen-portfolio-tracker}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-portfolio-history
+name: nansen-portfolio-tracker
 description: "How has a wallet's portfolio changed over time? Historical balances, current snapshot, and per-token PnL."
 metadata:
   openclaw:

package/skills/{nansen-prediction-market → nansen-prediction-markets}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-prediction-market
+name: nansen-prediction-markets
 description: "Polymarket screeners — discover trending events, top markets by volume, and search for specific markets. Use when browsing what's happening on prediction markets."
 metadata:
   openclaw:

package/skills/{nansen-cross-chain-flow → nansen-sm-cross-chain-flows}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-cross-chain-flow
+name: nansen-sm-cross-chain-flows
 description: "Is SM buying this token on one chain but selling on another? Detect capital rotation."
 metadata:
   openclaw:

package/skills/{nansen-alerts → nansen-smart-alerts}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-alerts
+name: nansen-smart-alerts
 description: Manage smart alerts — list, create, update, toggle, delete. Use when setting up or managing token flow alerts, smart money alerts, or notification rules.
 metadata:
   openclaw:

package/skills/{nansen-alpha-discovery → nansen-smart-money-alpha}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-alpha-discovery
+name: nansen-smart-money-alpha
 description: "What tokens is smart money accumulating before they pump? Token screener with SM filter cross-referenced against netflow."
 metadata:
   openclaw:

package/skills/{nansen-smart-money → nansen-smart-money-tracker}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-smart-money
+name: nansen-smart-money-tracker
 description: Smart money tracking — netflow, trades, holdings, perp trades. Use when finding what smart money wallets are buying/selling or tracking whale activity.
 metadata:
   openclaw:

package/skills/{nansen-sm-trend → nansen-smart-money-trend}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-sm-trend
+name: nansen-smart-money-trend
 description: "Has SM been in this token for weeks, or did they just enter? Are they still buying?"
 metadata:
   openclaw:

package/skills/{nansen-token → nansen-token-research}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-token
+name: nansen-token-research
 description: Token deep dive — info, OHLCV, holders, flows, flow intelligence, who bought/sold, DEX trades, PnL, perp trades, perp positions, perp PnL leaderboard. Use when researching a specific token in depth.
 metadata:
   openclaw:

package/skills/{nansen-token-discovery → nansen-token-screener}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-token-discovery
+name: nansen-token-screener
 description: "Discover trending tokens — screener, SM holdings, Nansen indicators, and flow intelligence for promising finds. Use when scanning for new tokens or screening what's hot."
 metadata:
   openclaw:

package/skills/{nansen-token-forensics → nansen-token-transfer-analysis}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-token-forensics
+name: nansen-token-transfer-analysis
 description: "Where is this token moving and why? Large transfers, flow trends over time, and breakdown by wallet label."
 metadata:
   openclaw:

package/skills/{nansen-trade → nansen-trading}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-trade
+name: nansen-trading
 description: Execute DEX swaps on Solana or Base. Use when buying or selling a token, getting a swap quote, or executing a trade.
 metadata:
   openclaw:
@@ -86,7 +86,7 @@ nansen trade execute --quote "$quote_id"
 | `NANSEN_WALLET_PASSWORD` | **Required for `trade execute`.** Wallet encryption password — persisted in `~/.nansen/.env`. Source before executing: `source ~/.nansen/.env && nansen trade execute ...` |
 | `NANSEN_API_KEY` | API key (also set via `nansen login`) |
 
-> **Agents:** Never hold a wallet password only in session memory. If `NANSEN_WALLET_PASSWORD` is not in `~/.nansen/.env`, follow the setup flow in the nansen-wallet skill Password Policy to generate and persist one before proceeding.
+> **Agents:** Never hold a wallet password only in session memory. If `NANSEN_WALLET_PASSWORD` is not in `~/.nansen/.env`, follow the setup flow in the nansen-wallet-manager skill Password Policy to generate and persist one before proceeding.
 
 ## Notes
 

package/skills/{nansen-batch-wallet → nansen-wallet-batch}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-batch-wallet
+name: nansen-wallet-batch
 description: "Which of these addresses are smart money? Batch-profile a list in one call."
 metadata:
   openclaw:

package/skills/{nansen-wallet-attribution → nansen-wallet-clustering}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-wallet-attribution
+name: nansen-wallet-clustering
 description: "Cluster and attribute related wallets — funding chains, shared signers, CEX deposit patterns. Use when tracing wallet ownership, comparing two wallets, finding wallet relationships, governance voters, or related address clusters."
 metadata:
   openclaw:

package/skills/{nansen-wallet-analysis → nansen-wallet-deep-dive}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-wallet-analysis
+name: nansen-wallet-deep-dive
 description: "Who is this wallet and what have they been doing? Identity labels, balance, PnL summary, recent transactions, perp positions, and counterparties."
 metadata:
   openclaw:

package/skills/{nansen-wallet-migration → nansen-wallet-keychain-migration}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-wallet-migration
+name: nansen-wallet-keychain-migration
 description: Migrate an existing nansen-cli wallet from insecure password storage (env files, .credentials) to the new secure keychain-backed flow.
 metadata:
   openclaw:

package/skills/{nansen-wallet → nansen-wallet-manager}/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: nansen-wallet
-description: Wallet management — create, list, show, export, send, delete. Use when creating wallets, checking balances, or sending tokens.
+name: nansen-wallet-manager
+description: Wallet management — create (local or Privy server-side), list, show, export, send, delete. Use when creating wallets, checking balances, or sending tokens.
 metadata:
   openclaw:
     requires:
@@ -30,7 +30,49 @@ NANSEN_API_KEY=<key> nansen login
 nansen research profiler labels --address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --chain ethereum
 ```
 
-## Wallet Creation (Two-Step Agent Flow)
+## Wallet Providers
+
+The CLI supports two wallet providers:
+
+| | **Local** (default) | **Privy** (server-side) |
+|---|---|---|
+| Key storage | Encrypted on disk | Server-side via Privy API |
+| Password required | Yes (min 12 chars) | No |
+| Export private keys | Yes (`wallet export`) | No — keys are managed by Privy |
+| Best for | Human users, manual trading | Agents, automated workflows |
+| Flag | `--provider local` (default) | `--provider privy` |
+| Required env vars | `NANSEN_WALLET_PASSWORD` | `PRIVY_APP_ID` + `PRIVY_APP_SECRET` |
+
+## Privy Wallet Creation
+
+Privy wallets are server-side wallets managed by the Privy API. No password is needed — keys never touch the local machine.
+
+### Prerequisites
+
+The following environment variables must be set:
+
+| Var | Purpose |
+|-----|---------|
+| `PRIVY_APP_ID` | Privy application ID |
+| `PRIVY_APP_SECRET` | Privy application secret |
+
+### Create a Privy wallet
+
+```bash
+nansen wallet create --provider privy
+# Or with a custom name:
+nansen wallet create --name agent-wallet --provider privy
+```
+
+### Critical rules for agents (Privy)
+
+- **No password needed** — Privy manages keys server-side
+- **Cannot export keys** — `wallet export` only works for local wallets
+- All other operations (`list`, `show`, `send`, `delete`, `default`) work identically for both providers
+
+## Local Wallet Creation (Two-Step Agent Flow)
+
+> This section covers **local** wallet creation. For Privy server-side wallets, see the [Privy Wallet Creation](#privy-wallet-creation) section above — no password is needed.
 
 Wallet creation requires a password from the **human user**. The agent must NOT generate or store the password itself.
 
@@ -127,6 +169,7 @@ For detailed migration steps (from `~/.nansen/.env`, `.credentials`, or env-var-
 | `--chain` | `evm` or `solana` |
 | `--max` | Send entire balance |
 | `--dry-run` | Preview without broadcasting |
+| `--provider` | Wallet provider: `local` (default, encrypted on disk) or `privy` (server-side via Privy API) |
 | `--human` | Enable interactive prompts (human terminal use only — agents must NOT use this) |
 | `--unsafe-no-password` | Skip encryption (keys stored in plaintext — NOT recommended) |
 
@@ -136,5 +179,8 @@ For detailed migration steps (from `~/.nansen/.env`, `.credentials`, or env-var-
 |-----|---------|
 | `NANSEN_WALLET_PASSWORD` | Wallet encryption password — only needed for initial `wallet create`. After that, the OS keychain handles it. |
 | `NANSEN_API_KEY` | API key (also set via `nansen login --api-key <key>`) |
+| `PRIVY_APP_ID` | Privy application ID (required for `--provider privy`) |
+| `PRIVY_APP_SECRET` | Privy application secret (required for `--provider privy`) |
+| `NANSEN_WALLET_PROVIDER` | Default provider for wallet create — `local` or `privy` |
 | `NANSEN_EVM_RPC` | Custom EVM RPC endpoint |
 | `NANSEN_SOLANA_RPC` | Custom Solana RPC endpoint |

package/skills/{nansen-profiler → nansen-wallet-profiler}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-profiler
+name: nansen-wallet-profiler
 description: Wallet profiler — balance, PnL, labels, transactions, counterparties, related wallets, batch, trace, compare. Use when analysing a specific wallet address or comparing wallets.
 metadata:
   openclaw:

package/skills/{nansen-web-fetch → nansen-web-fetcher}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-web-fetch
+name: nansen-web-fetcher
 description: Fetch and analyze content from one or more URLs using AI (Gemini 2.5 Flash). Use when you have specific URLs and need to extract or summarize their content. Pairs well with `nansen web search` results.
 metadata:
   openclaw:

package/skills/{nansen-web-search → nansen-web-searcher}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: nansen-web-search
+name: nansen-web-searcher
 description: Search the web for one or more queries in parallel. Use when you need current information, news, prices, or any web content to complement on-chain Nansen data.
 metadata:
   openclaw:

package/src/api.js

@@ -630,7 +630,7 @@ export class NansenAPI {
                   } catch (x402Err) {
                     if (!this.apiKey) {
                       message = 'No API key configured. Two ways to authenticate:\n' +
-                        '  1. API key: nansen login --api-key <key> (get key at https://app.nansen.ai/api)\n' +
+                        '  1. API key: nansen login --api-key <key> (get key at https://app.nansen.ai/auth/agent-setup)\n' +
                         '  2. x402 micropayment: nansen wallet create + fund with USDC (no API key needed)';
                     } else {
                       message = `x402 auto-payment failed: ${x402Err.message}`;

package/src/cli.js

@@ -685,7 +685,7 @@ COMMANDS:
   alerts      list, create, update, toggle, delete
   web         search, fetch
   account     Show API key status, plan, and remaining credits
-  login       Save API key (--api-key <key> or NANSEN_API_KEY env var)
+  login       Save API key (--api-key <key>, --human, or NANSEN_API_KEY env var)
   logout      Remove saved API key
   schema      JSON schema for all commands (use "nansen schema <cmd>" for one)
   cache       clear
@@ -859,7 +859,7 @@ export function buildCommands(deps = {}) {
         log('  --api-key <key>   Your Nansen API key');
         log('  --human           Enable interactive prompt');
         log('  --help            Show this help\n');
-        log('Get your API key at: https://app.nansen.ai/api');
+        log('Get your API key at: https://app.nansen.ai/auth/agent-setup');
         return;
       }
 
@@ -879,7 +879,7 @@ export function buildCommands(deps = {}) {
           return;
         }
         log('Nansen CLI Login\n');
-        log('Get your API key at: https://app.nansen.ai/api\n');
+        log('Get your API key at: https://app.nansen.ai/auth/agent-setup\n');
         apiKey = await promptFn('Enter your API key: ', true);
       }
 
@@ -890,7 +890,7 @@ export function buildCommands(deps = {}) {
           resolution: [
             'Run: nansen login --api-key <key>',
             'Or set NANSEN_API_KEY environment variable',
-            'Get your API key at: https://app.nansen.ai/api',
+            'Get your API key at: https://app.nansen.ai/auth/agent-setup',
           ],
         }));
         exit(1);
@@ -912,7 +912,7 @@ export function buildCommands(deps = {}) {
           log(JSON.stringify({
             error: 'INVALID_API_KEY',
             message: 'The API key is not valid.',
-            resolution: ['Check your key at https://app.nansen.ai/api']
+            resolution: ['Check your key at https://app.nansen.ai/auth/agent-setup']
           }));
         } else {
           log(JSON.stringify({