Directory

Nansen

Datafrom $0.01/callListedBaseSolanaeip155:196eip155:56

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$2
    api.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.01
    api.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.01
    api.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.05
    api.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.01
    api.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.01
    api.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.01
    api.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.01
    api.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.01
    api.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.01
    api.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.01
    api.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.01
    api.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.05
    api.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.05
    api.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.05
    api.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.01
    api.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.05
    api.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.01
    api.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.01
    api.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.01
    api.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.01
    api.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.01
    api.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.01
    api.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.01
    api.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.01
    api.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.01
    api.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.05
    api.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.05
    api.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.01
    api.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.05
    api.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.05
    api.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.05
    api.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.05
    api.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.01
    api.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.01
    api.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.01
    api.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.05
    api.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.05
    api.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.01
    api.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.05
    api.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.05
    api.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.01
    api.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.05
    api.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.01
    api.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.01
    api.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.01
    api.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.01
    api.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.01
    api.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.01
    api.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.01
    api.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.05
    api.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.05
    api.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.05
    api.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.25
    api.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.05
    api.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.05
    api.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.25
    api.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.50
    api.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.01
    api.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.01
    api.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?**