Endpoints Overview

Overview

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

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/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	5	Balance of top addresses, smart money, exchanges, public figures and whales that can be queried by address or by entity
tgm/perp-positions	5	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	5	List of addresses and their total realised and unrealised PnL
tgm/perp-pnl-leaderboard	5	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

Portfolio API

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