# 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.

<table><thead><tr><th>Endpoint</th><th width="126.61328125" data-type="number">Credit</th><th>Description</th></tr></thead><tbody><tr><td><a href="https://docs.nansen.ai/api/smart-money/netflows">smart-money/netflows</a></td><td>5</td><td>Provides net flow of tokens bought/sold by Smart Money addresses</td></tr><tr><td><a href="https://docs.nansen.ai/api/smart-money/holdings">smart-money/holdings</a></td><td>5</td><td>Holdings of tokens by Smart Money addresses.</td></tr><tr><td><a href="https://docs.nansen.ai/api/smart-money/historical-holdings">smart-money/historical-holdings</a></td><td>5</td><td>All Historical Holdings of Smart Money Wallets</td></tr><tr><td><a href="https://docs.nansen.ai/api/smart-money/dex-trades">smart-money/dex-trades</a></td><td>5</td><td>All dex trades of smart money traders in the last 24h</td></tr><tr><td><a href="https://docs.nansen.ai/api/smart-money/jupiter-dcas">smart-money/dcas </a></td><td>5</td><td>All Jupiter DCAs started by Smart Money Wallets on Solana</td></tr><tr><td><a href="smart-money/perp-trades">smart-money/perp-trades</a></td><td>5</td><td>Track what smart money wallets are trading on Hyperliquid</td></tr></tbody></table>

### Agent

<table><thead><tr><th width="316.16015625">Endpoint</th><th width="124.69140625">Credit</th><th>Description</th></tr></thead><tbody><tr><td><a href="https://docs.nansen.ai/api/agent#post-api-v1-agent-fast">agent/fast</a></td><td>200</td><td>Ask Nansen Agent any question in fast mode</td></tr><tr><td><a href="https://docs.nansen.ai/api/agent#post-api-v1-agent-expert">agent/expert</a></td><td>750</td><td>Ask Nansen Agent any question in expert mode</td></tr></tbody></table>

### 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.

<table><thead><tr><th>Endpoint</th><th width="116.46484375" data-type="number">Credit</th><th>Description</th></tr></thead><tbody><tr><td><a href="https://docs.nansen.ai/api/profiler/address-current-balances">address/current-balance</a></td><td>1</td><td>Current Token balances of an address</td></tr><tr><td><a href="https://docs.nansen.ai/api/profiler/address-historical-balances">profiler/address/historical-balances</a></td><td>1</td><td>Historical holdings of a wallet address</td></tr><tr><td><a href="https://docs.nansen.ai/api/profiler/address-perp-positions">profiler/perp-positions</a></td><td>1</td><td>Fetch current positions, PnL and account health of a wallet</td></tr><tr><td><a href="https://docs.nansen.ai/api/profiler/address-transactions">profiler/address/transactions</a></td><td>1</td><td>List of transactions made by an address</td></tr><tr><td><a href="profiler/address-perp-trades">profiler/perp-trades</a></td><td>1</td><td>Get all Hyperliquid trades of a wallet</td></tr><tr><td><a href="profiler/address-related-wallets">profiler/address/related-wallets</a></td><td>1</td><td>List of related wallets and its first degree relation</td></tr><tr><td><a href="profiler/address-pnl-and-trade-performance">profiler/address/pnl-summary</a></td><td>1</td><td>Trade summary including top 5 trades</td></tr><tr><td><a href="profiler/address-pnl-and-trade-performance">profiler/address/pnl</a></td><td>1</td><td>List of Past Trades and their performance made by the address</td></tr><tr><td><a href="profiler/address-counterparties">profiler/address/counterparties</a></td><td>5</td><td>Top Counterparties a wallet has interacted with</td></tr><tr><td><a href="profiler/hyperliquid-address-leaderboard">perp-leaderboard</a></td><td>5</td><td>Get a list of most profitable Hyperliquid addresses</td></tr><tr><td><a href="profiler/address-labels">/profiler/address/labels</a> (Common labels)</td><td>100</td><td>Address and list of all its labels</td></tr><tr><td><a href="profiler/address-labels">/profiler/address/labels</a> (Premium labels)</td><td>500</td><td>Address and list of all its labels</td></tr></tbody></table>

### 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.

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

### Prediction Market API

<table><thead><tr><th>Endpoint</th><th width="97.703125" data-type="number">Credits</th><th>Description</th></tr></thead><tbody><tr><td><a href="https://docs.nansen.ai/api/prediction-market/market-categories">prediction-market/categories</a></td><td>1</td><td>Aggregated stats for all categories</td></tr><tr><td><a href="https://docs.nansen.ai/api/prediction-market/market-screener">prediction-market/market-screener</a></td><td>1</td><td>Browse and all Polymarket prediction markets.</td></tr><tr><td><a href="https://docs.nansen.ai/api/prediction-market/market-event-screener">prediction-market/event-screener</a></td><td>1</td><td>Browse and filter Polymarket events</td></tr><tr><td><a href="https://docs.nansen.ai/api/prediction-market/market-orderbook">prediction-market/orderbook</a></td><td>1</td><td>Get bid/ask orderbook for a market</td></tr><tr><td><a href="https://docs.nansen.ai/api/prediction-market/market-ohlcv">prediction-market/ohlcv</a></td><td>1</td><td>Get 1-hour OHLCV for a market</td></tr><tr><td><a href="https://docs.nansen.ai/api/prediction-market/trades-by-market">prediction-market/trades-by-market</a></td><td>1</td><td>Get recent trades for a market</td></tr><tr><td><a href="https://docs.nansen.ai/api/prediction-market/trades-by-address">prediction-market/trades-by-address</a></td><td>1</td><td>Trades for a wallet across all markets</td></tr><tr><td><a href="https://docs.nansen.ai/api/prediction-market/pnl-by-address">prediction-market/pnl-by-address</a></td><td>1</td><td>PnL for a wallet across all markets</td></tr><tr><td><a href="https://docs.nansen.ai/api/prediction-market/address-summary">prediction-market/address-summary</a></td><td>1</td><td>Get PnL, win rate and age of a wallet active on Polymarket</td></tr><tr><td><a href="https://docs.nansen.ai/api/prediction-market/market-top-holders">prediction-market/top-holders</a></td><td>5</td><td>Get the largest position holders for market</td></tr><tr><td><a href="https://docs.nansen.ai/api/prediction-market/market-position-details">prediction-market/position-detail</a></td><td>5</td><td>Get per-token position data for all holders in a specific market</td></tr><tr><td><a href="https://docs.nansen.ai/api/prediction-market/pnl-by-market">prediction-market/pnl-by-market</a></td><td>5</td><td>PnL for all traders in a specific market</td></tr></tbody></table>

### Portfolio API

<table><thead><tr><th>Endpoint</th><th width="97.703125" data-type="number">Credits</th><th>Description</th></tr></thead><tbody><tr><td><a href="portfolio">portfolio/defi-holdings</a></td><td>1</td><td>Track DeFi positions of all addresses</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nansen.ai/api/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.