Endpoints Overview

Overview

The Nansen API provides endpoints organized into 4 categories. All endpoints use POST requests with JSON bodies.

Free plan: 10× credit cost. API calls on the free plan consume 10× more credits than on any paid plan. If you're building anything beyond light testing, upgrade before you exhaust your credits.

Smart Money

A curated list of the top 5 000 highest-performing wallets ranked by realised profit, winrate, and strong performance across market cycles.

Endpoint	Credit	Description
smart-money/netflows	5	Provides net flow of tokens bought/sold by Smart Money addresses
smart-money/holdings	5	Holdings of tokens by Smart Money addresses.
smart-money/historical-holdings	5	All Historical Holdings of Smart Money Wallets
smart-money/dex-trades	5	All dex trades of smart money traders in the last 24h
smart-money/dcas	5	All Jupiter DCAs started by Smart Money Wallets on Solana
smart-money/perp-trades	5	Track what smart money wallets are trading on Hyperliquid

Agent

Endpoint	Credit	Description
agent/fast	200	Ask Nansen Agent any question in fast mode
agent/expert	750	Ask Nansen Agent any question in expert mode

Profiler

A toolkit for diving deep into address relationships and behaviour, letting you analyse any wallet or entity cluster to uncover flows, counterparties, and behavioural patterns.

Endpoint	Credit	Description
address/current-balance	1	Current Token balances of an address
profiler/address/historical-balances	1	Historical holdings of a wallet address
profiler/perp-positions	1	Fetch current positions, PnL and account health of a wallet
profiler/address/transactions	1	List of transactions made by an address
profiler/perp-trades	1	Get all Hyperliquid trades of a wallet
profiler/address/related-wallets	1	List of related wallets and its first degree relation
profiler/address/pnl-summary	1	Trade summary including top 5 trades
profiler/address/pnl	1	List of Past Trades and their performance made by the address
profiler/dex-trades	1	List of all trades made by an address
profiler/address/counterparties	5	Top Counterparties a wallet has interacted with
perp-leaderboard	5	Get a list of most profitable Hyperliquid addresses
/profiler/address/labels (Common labels)	100	Address and list of all its labels
/profiler/address/labels (Premium labels)	500	Address and list of all its labels

Token God Mode

A comprehensive lens on a token’s on-chain activity, combining Smart Money movements, holder-base analysis, and exchange-flow tracking in one view.

Endpoint	Credits	Description
tgm/token-screener	1	A token screening endpoint that provides real-time analytics and insights across multiple blockchain networks.
tgm/perp-screener	1	Discover and screen tokens on Hyperliquid with the highest volume and smart money activity.
tgm/flow-intelligence	1	Summary of token flows across Smart Money, exchanges, Top PnL Traders, Public Figures, Whales, Fresh Wallets
tgm/holders (Premium labels: 150)	5 / 150	Balance of top addresses, smart money, exchanges, public figures and whales that can be queried by address or by entity.
tgm/perp-positions (Premium labels: 150)	5 / 150	See all open positions for a specific perp token including leverage, PnL, and liquidation prices
tgm/flows	1	Total Inflow and outflow of a token from smart money, exchanges, public figures or whales.
tgm/who-bought-sold	1	Recent buyers and sellers of a token summarised
tgm/perp-trades	1	View trading history for a specific perp token over a time period
tgm/dex-trades	1	All DEX Trades of a Token
tgm/transfers	1	Top Token Transfers of a token
tgm/jup-dca	1	List of all Jupiter DCA orders of a token on Solana
tgm/pnl-leaderboard (Premium labels: 150)	5 / 150	List of addresses and their total realised and unrealised PnL
tgm/perp-pnl-leaderboard (Premium labels: 150)	5 / 150	List of addresses and their PnL for a specific token on Hyperliquid
tgm/token-information	1	Get stats about Token Marketcap, Volume, Holders, Traders, etc
tgm/indicators	5	Get risk and reward indicators for a specific token.
tgm/token-ohlcv	1	Get unified OHLCVdata for tokens

Prediction Market API

Endpoint	Credits	Description
prediction-market/categories	1	Aggregated stats for all categories
prediction-market/market-screener	1	Browse and all Polymarket prediction markets.
prediction-market/event-screener	1	Browse and filter Polymarket events
prediction-market/orderbook	1	Get bid/ask orderbook for a market
prediction-market/ohlcv	1	Get 1-hour OHLCV for a market
prediction-market/trades-by-market	1	Get recent trades for a market
prediction-market/trades-by-address	1	Trades for a wallet across all markets
prediction-market/pnl-by-address	1	PnL for a wallet across all markets
prediction-market/address-summary	1	Get PnL, win rate and age of a wallet active on Polymarket
prediction-market/top-holders	5	Get the largest position holders for market
prediction-market/position-detail	5	Get per-token position data for all holders in a specific market
prediction-market/pnl-by-market	5	PnL for all traders in a specific market

Portfolio API

Endpoint	Credits	Description
portfolio/defi-holdings	1	Track DeFi positions of all addresses

Backtesting API

Backtest your strategies against the same onchain intelligence that powers Nansen at any point in time.

Endpoint	Credits per call
tgm/historical-dex-trades	5
tgm/historical-who-bought-sold	5
tgm/historical-token-flow-summary	5
token-screener/historical	5
token-screener/historical-perps	5
profiler/address/historical-token-balances	5
profiler/address/historical-transactions	5
profiler/historical-transaction-lookup	5
tgm/historical-top-holders	25
tgm/historical-pnl-leaderboard	25
tgm/historical-token-quant-scores	25
smart-money/historical-token-balances	25