Nansen
Wallet labels + smart money flows + analytics
Routability
can the router discover, pick, and call it?Not yet graded. Diagnostics check param schemas, description quality, live health, and run the actual routing planner against this service’s own tools — construction only, nothing is paid or executed.
x402 endpoints
60- POST/api/v1/agent/fast$2api.nansen.ai
at volume≈ $2,880/day @ 1 call/min·≈ $172,800/day @ 1 call/sec
Interact with the Nansen Research Agent in "fast" mode
2 parameters
- conversation_idstringbody
- textstringbody
- POST/api/v1/chains/chain-rank$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get chain growth rankings
2 parameters
- chain_typestringbody
- time_framenumberbody
- POST/api/v1/nansen-score/top-tokens$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Nansen Score Top Tokens
2 parameters
- limitnumberbody
- market_cap_groupstringbody
- POST/api/v1/perp-leaderboard$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Perpetual Trading Leaderboard Data
2 parameters
- dateobjectbody
- filtersobjectbody
- POST/api/v1/perp-screener$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Perpetual Contract Screening Data
3 parameters
- dateobjectbody
- filtersobjectbody
- order_byarraybody
- POST/api/v1/prediction-market/address-summary$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Prediction Market Address Summary
1 parameter
- addressstringbody
- POST/api/v1/prediction-market/categories$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Prediction Market Categories
1 parameter
- paginationobjectbody
- POST/api/v1/prediction-market/event-screener$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Prediction Market Event Screener
6 parameters
- end_date_afterstringbody
- end_date_beforestringbody
- order_byarraybody
- querystringbody
- statusstringbody
- tagsarraybody
- POST/api/v1/prediction-market/market-screener$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Prediction Market Screener
6 parameters
- end_date_afterstringbody
- end_date_beforestringbody
- order_byarraybody
- querystringbody
- statusstringbody
- tagsarraybody
- POST/api/v1/prediction-market/ohlcv$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Prediction Market OHLCV Candles
3 parameters
- dateobjectbody
- market_idstringbody
- order_byarraybody
- POST/api/v1/prediction-market/orderbook$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Prediction Market Orderbook
1 parameter
- market_idstringbody
- POST/api/v1/prediction-market/pnl-by-address$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Prediction Market PnL by Address
2 parameters
- addressstringbody
- order_byarraybody
- POST/api/v1/prediction-market/pnl-by-market$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Prediction Market PnL by Market
2 parameters
- market_idstringbody
- order_byarraybody
- POST/api/v1/prediction-market/position-detail$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Prediction Market Position Detail
1 parameter
- market_idstringbody
- POST/api/v1/prediction-market/top-holders$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Prediction Market Top Holders
2 parameters
- market_idstringbody
- order_byarraybody
- POST/api/v1/prediction-market/trades-by-address$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Prediction Market Trades by Address
3 parameters
- addressstringbody
- dateobjectbody
- order_byarraybody
- POST/api/v1/profiler/address/counterparties$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Address Counterparties Data
6 parameters
- addressstringbody
- chainstringbody
- dateobjectbody
- group_bystringbody
- paginationobjectbody
- source_inputstringbody
- POST/api/v1/profiler/address/current-balance$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Address Current Balance Data
4 parameters
- addressstringbody
- chainstringbody
- hide_spam_tokenbooleanbody
- paginationobjectbody
- POST/api/v1/profiler/address/first-funder$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Address First Funder Data
2 parameters
- addressstringbody
- chainstringbody
- POST/api/v1/profiler/address/historical-balances$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Address Historical Balances Data
4 parameters
- addressstringbody
- chainstringbody
- dateobjectbody
- paginationobjectbody
- POST/api/v1/profiler/address/pnl$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Retrieve address PnL data
4 parameters
- addressstringbody
- chainstringbody
- dateobjectbody
- paginationobjectbody
- POST/api/v1/profiler/address/pnl-summary$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Address PnL Summary Data
3 parameters
- addressstringbody
- chainstringbody
- dateobjectbody
- POST/api/v1/profiler/address/related-wallets$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Address Related Wallets Data
2 parameters
- addressstringbody
- chainstringbody
- POST/api/v1/profiler/address/transactions$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Address Transactions Data
5 parameters
- addressstringbody
- chainstringbody
- dateobjectbody
- filtersobjectbody
- hide_spam_tokenbooleanbody
- POST/api/v1/profiler/perp-pnl-summary$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Hyperliquid Perp PnL Summary
2 parameters
- addressstringbody
- dateobjectbody
- POST/api/v1/profiler/perp-trades$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Perpetual Trade Data
4 parameters
- addressstringbody
- dateobjectbody
- filtersobjectbody
- order_byarraybody
- POST/api/v1/smart-money/dcas$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Smart Money DCAs Data
1 parameter
- filtersobjectbody
- POST/api/v1/smart-money/dex-trades$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Smart Money DEX Trades Data
2 parameters
- chainsarraybody
- filtersobjectbody
- POST/api/v1/smart-money/historical-holdings$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Smart Money Historical Holdings Data
3 parameters
- chainsarraybody
- date_rangeobjectbody
- filtersobjectbody
- POST/api/v1/smart-money/holdings$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Smart Money Holdings Data
2 parameters
- chainsarraybody
- filtersobjectbody
- POST/api/v1/smart-money/netflow$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Smart Money Netflow Data
3 parameters
- chainsarraybody
- filtersobjectbody
- order_byarraybody
- POST/api/v1/smart-money/perp-trades$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Smart Money Perpetual Trades Data
2 parameters
- filtersobjectbody
- only_new_positionsbooleanbody
- POST/api/v1/smart-money/pnl-leaderboard$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Smart Money PnL Leaderboard
4 parameters
- chainsarraybody
- filtersobjectbody
- order_byarraybody
- timeframenumberbody
- POST/api/v1/tgm/dex-trades$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get "Token God Mode" (TGM) DEX trades data
5 parameters
- chainstringbody
- dateobjectbody
- filtersobjectbody
- only_smart_moneybooleanbody
- token_addressstringbody
- POST/api/v1/tgm/flow-intelligence$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get "Token God Mode" (TGM) flow intelligence data
3 parameters
- chainstringbody
- filtersobjectbody
- token_addressstringbody
- POST/api/v1/tgm/flows$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get "Token God Mode" (TGM) flows data
5 parameters
- chainstringbody
- dateobjectbody
- filtersobjectbody
- labelstringbody
- token_addressstringbody
- POST/api/v1/tgm/holders$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get "Token God Mode" (TGM) holders data
5 parameters
- aggregate_by_entitybooleanbody
- chainstringbody
- filtersobjectbody
- label_typestringbody
- token_addressstringbody
- POST/api/v1/tgm/indicators$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Nansen Score Indicators
2 parameters
- chainstringbody
- token_addressstringbody
- POST/api/v1/tgm/jup-dca$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get "Token God Mode" (TGM) Jupiter DCA data
2 parameters
- filtersobjectbody
- token_addressstringbody
- POST/api/v1/tgm/perp-pnl-leaderboard$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get "Token God Mode" (TGM) perp PnL leaderboard data
3 parameters
- dateobjectbody
- filtersobjectbody
- token_symbolstringbody
- POST/api/v1/tgm/perp-positions$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get "Token God Mode" (TGM) perp positions data
3 parameters
- filtersobjectbody
- label_typestringbody
- token_symbolstringbody
- POST/api/v1/tgm/perp-trades$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get "Token God Mode" (TGM) perp trades data
3 parameters
- dateobjectbody
- filtersobjectbody
- token_symbolstringbody
- POST/api/v1/tgm/pnl-leaderboard$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get "Token God Mode" (TGM) PnL leaderboard data
4 parameters
- chainstringbody
- dateobjectbody
- filtersobjectbody
- token_addressstringbody
- POST/api/v1/tgm/position-intelligence$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get "Token God Mode" (TGM) position intelligence data
1 parameter
- token_addressstringbody
- POST/api/v1/tgm/token-information$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get "Token God Mode" (TGM) token information data
3 parameters
- chainstringbody
- timeframestringbody
- token_addressstringbody
- POST/api/v1/tgm/token-ohlcv$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Retrieve token OHLCV candle data
4 parameters
- chainstringbody
- timeframestringbody
- token_addressstringbody
- token_addressesarraybody
- POST/api/v1/tgm/transfers$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get "Token God Mode" (TGM) transfers data
4 parameters
- chainstringbody
- dateobjectbody
- filtersobjectbody
- token_addressstringbody
- POST/api/v1/tgm/who-bought-sold$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get "Token God Mode" (TGM) who bought/sold data
4 parameters
- chainstringbody
- dateobjectbody
- filtersobjectbody
- token_addressstringbody
- POST/api/v1/token-screener$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Retrieve token screener data
4 parameters
- chainsarraybody
- dateobjectbody
- filtersobjectbody
- timeframestringbody
- POST/api/v1/transaction-with-token-transfer-lookup$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Transaction with Token Transfer Lookup Data
3 parameters
- block_timestampstringbody
- chainstringbody
- transaction_hashstringbody
- POST/api/v1beta1/profiler/address/historical-transactions$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Historical Transactions for an Address (Beta)
5 parameters
- addressstringbody
- apply_blacklist_filterbooleanbody
- as_of_datestringbody
- chainstringbody
- hide_spam_tokenbooleanbody
- POST/api/v1beta1/profiler/historical-transaction-lookup$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Historical (Time-Travel) Transaction Lookup Data (Beta)
5 parameters
- apply_blacklist_filterbooleanbody
- as_of_datestringbody
- block_timestampstringbody
- chainstringbody
- transaction_hashstringbody
- POST/api/v1beta1/tgm/historical-dex-trades$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get historical "Token God Mode" (TGM) DEX trades (Beta)
4 parameters
- apply_blacklist_filterbooleanbody
- chainstringbody
- date_rangeobjectbody
- token_addressstringbody
- POST/api/v1beta1/tgm/historical-pnl-leaderboard$0.25api.nansen.ai
at volume≈ $360/day @ 1 call/min·≈ $21,600/day @ 1 call/sec
Get historical "Token God Mode" (TGM) PnL leaderboard (Beta)
4 parameters
- apply_blacklist_filterbooleanbody
- chainstringbody
- date_rangeobjectbody
- token_addressstringbody
- POST/api/v1beta1/tgm/historical-token-flow-summary$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get historical "Token God Mode" (TGM) token flow summary (Beta)
4 parameters
- apply_blacklist_filterbooleanbody
- chainstringbody
- date_rangeobjectbody
- token_addressstringbody
- POST/api/v1beta1/tgm/historical-token-ohlcv$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get historical "Token God Mode" (TGM) token OHLCV (Beta)
7 parameters
- apply_blacklist_filterbooleanbody
- as_of_datestringbody
- as_of_tsstringbody
- chainstringbody
- date_fromstringbody
- timeframestringbody
- token_addressstringbody
- POST/api/v1beta1/tgm/historical-token-quant-scores$0.25api.nansen.ai
at volume≈ $360/day @ 1 call/min·≈ $21,600/day @ 1 call/sec
Get Historical Token Quant Scores (Beta)
3 parameters
- as_of_datestringbody
- chainstringbody
- token_addressstringbody
- POST/api/v1/agent/expert$7.50api.nansen.ai
at volume≈ $10,800/day @ 1 call/min·≈ $648,000/day @ 1 call/sec
Ask the Nansen AI agent a research question and receive a streamed answer backed by on-chain data. The **expert** variant uses a more capable model for deeper, multi-step analysis. **What it helps to answer:** 1. **Which tokens are smart money accumulating right now?** 2. **What is the current narrative driving activity in DeFi?** 3. **Which wallets are connected to a specific address?** 4. **What is the on-chain story behind a recent price move?** **SSE event types:** The response is a text/event-stream with the following JSON event types: | type | payload | description | |---|---|---| | delta | {"type": "delta", "text": "…"} | Incremental text chunk of the agent's answer. | | tool_call | {"type": "tool_call", "name": "…"} | Emitted once per unique Nansen tool the agent invokes. | | finish | {"type": "finish", "conversation_id": "…", "tool_calls": [...]} | Final event. Contains the conversation_id for follow-up requests and the full list of tools used. | | error | {"type": "error", "error": "…", "status_code": …} | Emitted if the upstream agent service is unavailable or times out. | The stream terminates with a data: [DONE] sentinel. **Fast vs Expert:** Use /agent/fast for quick factual lookups and simple questions. Use /agent/expert when you need deeper multi-step analysis or synthesis across multiple data sources.
- POST/api/v1/prediction-market/trades-by-market$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get recent trades for a Polymarket prediction market. Trades are decoded from on-chain OrderFilled events on Polygon, joined with market metadata. **What it helps to answer:** 1. **What are the most recent trades in this market?** 2. **Who is buying and selling, and at what prices?** 3. **What is the trade size distribution?**
- POST/api/v1/profiler/perp-positions$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get perpetual positions data for a user by calling the Hyperliquid API directly. This endpoint provides real-time position information including entry price, mark price, PnL, leverage, and other position details. **What it helps to answer:** 1. **What are the current perpetual positions for a specific user address?** 2. **What is the unrealized PnL and performance of each position?** 3. **What are the leverage levels and margin requirements for each position?** 4. **What are the liquidation prices and risk levels for each position?**