From 648b1b3fcda112c607ba7130f79e53781c05f313 Mon Sep 17 00:00:00 2001 From: 0xlaveen Date: Sat, 25 Apr 2026 14:41:43 +0530 Subject: [PATCH] docs: surface nansen trade across README, help banner, and npm metadata Internal users reported their agents claim nansen-cli has no trading functionality. Root cause: every surface a model scans first (README tagline, npm description, `nansen` help line) framed the CLI as analytics-only, so agents answered from priors without running --help. Reframe across five surfaces to lead with both analytics and DEX trading: README tagline + new Capabilities section, package.json description + keywords (dex/swap/trading/jupiter/aggregator), CLI help banner trade line, schema.json trade description, and AGENTS.md Capabilities header. No behavior change. Co-Authored-By: Claude Opus 4.7 --- .changeset/trade-discoverability.md | 5 +++++ AGENTS.md | 10 +++++++++- README.md | 30 ++++++++++++++++++++++++++--- package.json | 11 +++++++++-- src/cli.js | 10 ++++++---- src/schema.json | 2 +- 6 files changed, 57 insertions(+), 11 deletions(-) create mode 100644 .changeset/trade-discoverability.md diff --git a/.changeset/trade-discoverability.md b/.changeset/trade-discoverability.md new file mode 100644 index 00000000..fa672e14 --- /dev/null +++ b/.changeset/trade-discoverability.md @@ -0,0 +1,5 @@ +--- +"nansen-cli": patch +--- + +Improve discoverability of `nansen trade`: README, CLI help banner, package.json description/keywords, and schema description now lead with the fact that the CLI does DEX swaps on Solana and Base (Jupiter / 0x best-quote routing) alongside analytics. No behavior change. diff --git a/AGENTS.md b/AGENTS.md index 8bc78a30..44db3365 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,6 +1,14 @@ # AGENTS.md -CLI for the [Nansen API](https://docs.nansen.ai) — designed for AI agents. +CLI for onchain research **and DEX trading** — designed for AI agents. Backed by the [Nansen API](https://docs.nansen.ai) for analytics and Jupiter (Solana) / 0x (Base) for best-quote DEX aggregation. + +## Capabilities + +- **Research** (`nansen research ...`) — smart-money flows, wallet profiling, token god mode, perps, prediction markets, portfolio. +- **Trade** (`nansen trade ...`) — DEX swaps on Solana and Base with best-quote routing across pools, plus cross-chain bridges (`bridge-status`) and Solana limit orders (`limit-order`). Agents should use this rather than calling Jupiter / Uniswap / Aerodrome directly. +- **Wallet** (`nansen wallet ...`) — local password-encrypted or Privy server-side wallets (EVM + Solana). +- **Alerts** (`nansen alerts ...`) — smart-money and token-flow alerts with webhook delivery. +- **Agent** (`nansen agent "..."`) — natural-language research agent. ## Quick Start diff --git a/README.md b/README.md index d1262eb2..8c93ae90 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,17 @@ [![npm version](https://img.shields.io/npm/v/nansen-cli.svg)](https://www.npmjs.com/package/nansen-cli) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) -> **Built by agents, for agents.** Command-line interface for the [Nansen API](https://docs.nansen.ai), designed for AI agents. +> **Built by agents, for agents.** Onchain analytics **and DEX trading** from the command line — designed for AI agents. + +Backed by the [Nansen API](https://docs.nansen.ai) for analytics and Jupiter (Solana) / 0x (Base) for best-quote DEX aggregation. + +## What it does + +- **Research** — smart-money flows, wallet profiling, token god mode, perps, prediction markets, portfolio. +- **Trade** — DEX swaps on Solana and Base with best-quote routing across pools, plus cross-chain bridges and limit orders. **No need to call Jupiter, Uniswap, or Aerodrome directly.** +- **Wallets** — create, fund, and send from local or Privy server-side wallets (EVM + Solana). +- **Alerts** — smart-money and token-flow alerts with webhook delivery. +- **Agent** — ask the Nansen AI research agent natural-language questions. ## Installation @@ -36,7 +46,7 @@ nansen schema [command] [--pretty] # full command reference (no API key neede **Research categories:** `smart-money` (`sm`), `token` (`tgm`), `profiler` (`prof`), `portfolio` (`port`), `prediction-market` (`pm`), `search`, `perp`, `points` -**Trade:** `quote`, `execute`, `bridge-status` — DEX swaps on Solana and Base, including cross-chain bridges. +**Trade:** `quote`, `execute`, `bridge-status`, `limit-order` — DEX swaps on Solana and Base via best-quote aggregation (Jupiter / 0x), plus cross-chain bridges and Solana limit orders. **Wallet:** `create`, `list`, `show`, `export`, `default`, `delete`, `send` — local or Privy server-side wallets (EVM + Solana). @@ -44,13 +54,27 @@ Run `nansen schema --pretty` for the full subcommand and field reference. ## Trading -DEX swaps on `solana` and `base`. Two-step: quote then execute. +DEX swaps on `solana` and `base` with best-quote routing across pools — no need to hit Jupiter, Uniswap, or Aerodrome directly. Two-step: quote then execute. ```bash nansen trade quote --chain solana --from SOL --to USDC --amount 1000000000 nansen trade execute --quote ``` +**Cross-chain bridges** (Solana ↔ Base) via `--to-chain`: + +```bash +nansen trade quote --chain base --to-chain solana --from USDC --to USDC --amount 1000000 +nansen trade bridge-status --tx-hash --from-chain base --to-chain solana +``` + +**Limit orders** (Solana, Jupiter): + +```bash +nansen trade limit-order create --from SOL --to USDC --amount 1000000000 --trigger-mint SOL --trigger-condition below --trigger-price 80 +nansen trade limit-order list +``` + Amounts are in base units (lamports, wei). Common symbols (`SOL`, `ETH`, `USDC`, `USDT`) resolve automatically. A wallet is required — set one with `nansen wallet default `. ## Wallet diff --git a/package.json b/package.json index e0984705..00186ffa 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "nansen-cli", "version": "1.28.0", - "description": "Command-line interface for Nansen API - designed for AI agents", + "description": "Onchain analytics and DEX trading CLI - smart money, swaps on Solana/Base via Jupiter/0x, designed for AI agents", "main": "src/index.js", "type": "module", "bin": { @@ -43,7 +43,14 @@ "onchain", "defi", "solana", - "ethereum" + "ethereum", + "dex", + "swap", + "trading", + "jupiter", + "aggregator", + "base", + "bridge" ], "author": "Nansen ", "license": "MIT", diff --git a/src/cli.js b/src/cli.js index f1bd6730..f5c4195f 100644 --- a/src/cli.js +++ b/src/cli.js @@ -699,9 +699,9 @@ export const HELP = `Nansen CLI v${VERSION} — designed for AI agents. USAGE: nansen [subcommand] [options] COMMANDS: - research smart-money, profiler, token, search, perp, portfolio, points - trade quote, execute - wallet create, list, show, export, default, delete, forget-password + research Onchain analytics: smart-money, profiler, token, search, perp, portfolio, points + trade DEX swaps on Solana & Base via best-quote routing (Jupiter/0x): quote, execute, bridge-status, limit-order + wallet create, list, show, export, default, delete, send, forget-password (local or Privy) agent Ask the Nansen AI research agent (fast/expert modes) alerts list, create, update, toggle, delete web search, fetch @@ -720,7 +720,9 @@ 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 base --from ETH --to USDC --amount 1000000000000000000 + nansen trade quote --chain solana --from SOL --to USDC --amount 1000000000 # DEX swap, best-quote routing + nansen trade execute --quote + nansen wallet create --name my-wallet DEPRECATED ALIASES (still work, will be removed in a future version): smart-money, profiler, token, search, perp, portfolio, points → use "nansen research " diff --git a/src/schema.json b/src/schema.json index d8320691..0dfa4988 100644 --- a/src/schema.json +++ b/src/schema.json @@ -840,7 +840,7 @@ } }, "trade": { - "description": "DEX trading commands", + "description": "DEX trading: swap, execute, bridge, and limit-order on Solana and Base with best-quote routing (Jupiter / 0x aggregation)", "subcommands": { "quote": { "description": "Get a DEX swap quote (same-chain or cross-chain)",