Awesome-omni-skill nansen-cli

Nansen CLI for onchain analytics, smart money tracking, DEX trading, and perp markets.

install

source · Clone the upstream repo

git clone https://github.com/diegosouzapw/awesome-omni-skill

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/tools/nansen-cli" ~/.claude/skills/diegosouzapw-awesome-omni-skill-nansen-cli && rm -rf "$T"

manifest: skills/tools/nansen-cli/SKILL.md

source content

Nansen CLI

Onchain analytics and DEX trading for AI agents.

Quick Reference

# Search for any token, wallet, or entity
nansen research search "jupiter" --type token

# Token price (OHLCV)
nansen research token ohlcv --token <addr> --chain solana --timeframe 1h --limit 24

# Smart Money — what are the pros buying?
nansen research smart-money netflow --chain solana --limit 10

# Token screener — trending tokens
nansen research token screener --chain solana --timeframe 24h --smart-money --limit 20

# Trade — quote then execute
nansen trade quote --chain solana --from <from_token_address> --to <to_token_address> --amount <base_units>
nansen trade execute --quote <quote-id>

# Create a wallet
nansen wallet create                                      # interactive
NANSEN_WALLET_PASSWORD="pass" nansen wallet create        # non-interactive

# Discover all commands, options, and return fields
nansen schema

Setup

npm install -g nansen-cli

Auth (pick one)

x402 Pay-Per-Call (no API key needed):

nansen wallet create    # Generates EVM + Solana keypair
# Fund the EVM address with USDC on Base (~$0.50 minimum)
export NANSEN_WALLET_PASSWORD="your-password"  # Skip interactive prompt
# Done — CLI auto-pays $0.01-$0.05 per call

API Key:

export NANSEN_API_KEY=your-api-key
# Or: nansen login --api-key YOUR_KEY

Get a key at app.nansen.ai/api.

Smart Money

nansen research smart-money netflow --chain solana --limit 10
nansen research smart-money dex-trades --chain solana --labels "Smart Trader" --limit 20
nansen research smart-money holdings --chain solana --limit 10
nansen research smart-money perp-trades --limit 10            # no --chain (Hyperliquid only)
nansen research smart-money dcas --limit 10                   # no --chain (Jupiter/Solana only)
nansen research smart-money historical-holdings --chain solana --token-address <addr>

Labels:

Fund

Smart Trader

30D Smart Trader

90D Smart Trader

180D Smart Trader

Smart HL Perps Trader

Token Analytics

--chain

required. Use

--token

for the token address.

nansen research token screener --chain solana --timeframe 24h --smart-money --limit 20
nansen research token info --token <addr> --chain solana
nansen research token indicators --token <addr> --chain solana
nansen research token ohlcv --token <addr> --chain solana --timeframe 1h --limit 24
nansen research token holders --token <addr> --chain solana --smart-money
nansen research token flows --token <addr> --chain solana --days 7
nansen research token flow-intelligence --token <addr> --chain solana
nansen research token who-bought-sold --token <addr> --chain solana
nansen research token dex-trades --token <addr> --chain solana --limit 20
nansen research token pnl --token <addr> --chain solana --sort total_pnl_usd:desc
nansen research token transfers --token <addr> --chain solana --enrich
nansen research token jup-dca --token <addr>                  # no --chain
nansen research token perp-trades --symbol ETH --days 7       # no --chain, uses --symbol
nansen research token perp-positions --symbol BTC              # no --chain
nansen research token perp-pnl-leaderboard --symbol SOL        # no --chain

Native tokens (SOL, ETH) are not supported on most token endpoints — use specific token addresses.

Wallet Profiler

--chain

and

--address

required for most commands.

nansen research profiler balance --address <addr> --chain solana
nansen research profiler labels --address <addr> --chain ethereum
nansen research profiler pnl --address <addr> --chain ethereum --days 30
nansen research profiler pnl-summary --address <addr> --chain ethereum
nansen research profiler transactions --address <addr> --chain ethereum --limit 20
nansen research profiler historical-balances --address <addr> --chain solana --days 30
nansen research profiler related-wallets --address <addr> --chain ethereum
nansen research profiler counterparties --address <addr> --chain ethereum
nansen research profiler perp-positions --address <addr>       # no --chain
nansen research profiler perp-trades --address <addr>          # no --chain
nansen research profiler search --query "Vitalik"              # no --chain
nansen research profiler batch --addresses "0xabc,0xdef" --chain ethereum --include labels,balance,pnl
nansen research profiler trace --address <addr> --chain ethereum --depth 2 --width 10  # ⚠️ makes N×width API calls
nansen research profiler compare --addresses "0xabc,0xdef" --chain ethereum

Search

nansen research search "jupiter" --type token
nansen research search "Vitalik" --type entity --limit 5
nansen research search "0xd8dA..."                             # by address

Perps (Hyperliquid)

nansen research perp screener --sort volume_usd:desc --limit 20
nansen research perp leaderboard --days 7 --limit 20

Portfolio

nansen research portfolio defi --wallet <addr>
nansen research points leaderboard --tier green --limit 20

Trading

Two-step: quote then execute.

# Get quotes from multiple aggregators (Jupiter, OKX, LiFi)
nansen trade quote --chain solana \
  --from <from_token_address> \
  --to <to_token_address> \
  --amount <base_units>

# Execute the best quote
nansen trade execute --quote <quote-id>

# Trade via WalletConnect (hardware wallets, mobile wallets — EVM only)
nansen trade quote --chain base --from <addr> --to <addr> --amount <base_units> --wallet walletconnect
nansen trade execute --quote <quote-id> --wallet wc

⚠️ Always inspect the quote response (price, slippage, expiry) before executing. Quotes expire — if you wait too long, execute will fail. Get a fresh quote and retry. Trades are irreversible once executed on-chain.

⚠️ Amounts are in base units (not human-readable):

Token	Decimals	1 unit =
SOL	9	1000000000 lamports
ETH	18	1000000000000000000 wei
USDC	6	1000000

Symbol shortcuts (SOL, ETH) don't work yet — use full addresses.

Common Addresses

Solana: SOL

So11111111111111111111111111111111111111112

· USDC

EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

· JUP

JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN

Base: ETH

0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee

· USDC

0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

· DEGEN

0x4ed4e862860bed51a9570b96d89af5e1b0efefed

Wallet Management

nansen wallet create          # Create EVM + Solana keypair
nansen wallet list            # List wallets
nansen wallet send --to <addr> --amount 1.5 --chain evm    # Send native
nansen wallet send --to <addr> --chain evm --max            # Send entire balance

# Send via WalletConnect (EVM only)
nansen wallet send --to <addr> --amount 1.5 --chain base --wallet walletconnect

Use

--wallet walletconnect

(or

--wallet wc

) to sign trades and transfers via a WalletConnect-connected wallet (hardware wallets, mobile wallets) instead of local keys. EVM chains only.

Common Options

Option	Description
`--chain`	Required for most commands. See Supported Chains
`--token`	Token address (aliases: `--mint` , `--token-address` )
`--address`	Wallet address
`--limit`	Results per page (default 10)
`--days`	Lookback period in days (default 30)
`--sort`	Sort field:direction (e.g. `value_usd:desc` )
`--smart-money`	Filter to smart money wallets only
`--pretty`	Formatted JSON output
`--table`	ASCII table output
`--stream`	NDJSON (one record per line)
`--fields a,b`	Return only specific fields
`--cache`	Cache responses (300s TTL). Do not use with `trade` commands — stale prices/quotes can cause bad trades

Schema Introspection

Stuck? Run
nansen schema
or
nansen schema <command>
to discover all available commands, options, and return fields.

nansen schema                 # Full JSON schema — all commands, options, return fields

Supported Chains

Research:

solana

ethereum

base

bnb

arbitrum

polygon

optimism

avalanche

linea

scroll

mantle

ronin

sei

plasma

sonic

monad

hyperevm

iotaevm

Trading & x402:

solana

base

Gotchas

Native tokens (SOL, ETH) don't work on most token endpoints — use wrapped addresses
Perp commands don't take
```
--chain
```
(Hyperliquid only)
```
--amount
```
is always in base units, not human-readable
Profiler
```
trace
```
makes N×width API calls — can burn credits fast
x402 auth needs USDC on Base, not Solana