> For the complete documentation index, see [llms.txt](https://docs.nansen.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nansen.ai/api.md).

# API

- [Endpoints Overview](https://docs.nansen.ai/api/overview.md)
- [Data Coverage by Chain](https://docs.nansen.ai/api/data-coverage.md): How far back Nansen data goes on each chain, and how fresh live data is.
- [Search](https://docs.nansen.ai/api/search.md)
- [Smart Money](https://docs.nansen.ai/api/smart-money.md)
- [Netflows](https://docs.nansen.ai/api/smart-money/netflows.md): Get aggregated token flow analysis for smart money wallets to see which tokens they're accumulating or distributing.
- [Holdings](https://docs.nansen.ai/api/smart-money/holdings.md): Aggregated token holdings data for smart money wallets.
- [Historical Holdings](https://docs.nansen.ai/api/smart-money/historical-holdings.md)
- [DEX Trades](https://docs.nansen.ai/api/smart-money/dex-trades.md)
- [Perp Trades](https://docs.nansen.ai/api/smart-money/perp-trades.md)
- [Jupiter DCAs](https://docs.nansen.ai/api/smart-money/jupiter-dcas.md)
- [PnL Leaderboard](https://docs.nansen.ai/api/smart-money/pnl-leaderboard.md): Ranked leaderboard of Smart Money wallets by PnL over a selected timeframe.
- [Funds](https://docs.nansen.ai/api/funds.md)
- [Fund Holdings](https://docs.nansen.ai/api/funds/holdings.md): Current token holdings aggregated across Fund wallets.
- [Profiler](https://docs.nansen.ai/api/profiler.md)
- [Address Current Balances](https://docs.nansen.ai/api/profiler/address-current-balances.md): Get real-time token balance information for any blockchain address or entity
- [Address Historical Balances](https://docs.nansen.ai/api/profiler/address-historical-balances.md): Get historical token balance information for any blockchain address or entity
- [Address DEX Trades](https://docs.nansen.ai/api/profiler/address-dex-trades.md)
- [Address Transactions](https://docs.nansen.ai/api/profiler/address-transactions.md)
- [Address Counterparties](https://docs.nansen.ai/api/profiler/address-counterparties.md): Get counterparties and their interaction statistics for any address or entity.
- [Address Counterparties (Batch)](https://docs.nansen.ai/api/profiler/address-counterparties-batch.md): Batch counterparties lookup — counterparties and interaction statistics for up to 10 wallet addresses in a single request.
- [Address Related Wallets](https://docs.nansen.ai/api/profiler/address-related-wallets.md)
- [Address First Funder](https://docs.nansen.ai/api/profiler/address-first-funder.md)
- [Address PnL & Trade Performance](https://docs.nansen.ai/api/profiler/address-pnl-and-trade-performance.md)
- [Address Labels](https://docs.nansen.ai/api/profiler/address-labels.md): Retrieves all entity and behavioural labels associated with an address on a chain.
- [Address Perp Positions](https://docs.nansen.ai/api/profiler/address-perp-positions.md)
- [Address Perp Trades](https://docs.nansen.ai/api/profiler/address-perp-trades.md)
- [Hyperliquid Address Leaderboard](https://docs.nansen.ai/api/profiler/hyperliquid-address-leaderboard.md)
- [Get Hyperliquid Perp PnL Summary](https://docs.nansen.ai/api/profiler/perp-pnl-summary.md)
- [Token God Mode](https://docs.nansen.ai/api/token-god-mode.md)
- [Token Information](https://docs.nansen.ai/api/token-god-mode/token-information.md)
- [Nansen Indicators](https://docs.nansen.ai/api/token-god-mode/nansen-indicators.md)
- [Price OHLCV](https://docs.nansen.ai/api/token-god-mode/price-ohlcv.md)
- [Token Screener](https://docs.nansen.ai/api/token-god-mode/token-screener.md)
- [Flow Intelligence](https://docs.nansen.ai/api/token-god-mode/flow-intelligence.md)
- [Holders](https://docs.nansen.ai/api/token-god-mode/holders.md)
- [Flows](https://docs.nansen.ai/api/token-god-mode/flows.md)
- [Position Intelligence](https://docs.nansen.ai/api/token-god-mode/position-intelligence.md): Aggregated perpetual position analytics on Hyperliquid broken down by trader cohort.
- [Who Bought/Sold](https://docs.nansen.ai/api/token-god-mode/who-bought-sold.md)
- [DEX Trades](https://docs.nansen.ai/api/token-god-mode/dex-trades.md)
- [Token Transfers](https://docs.nansen.ai/api/token-god-mode/token-transfers.md)
- [Jupiter DCAs](https://docs.nansen.ai/api/token-god-mode/jupiter-dcas.md)
- [PnL Leaderboard](https://docs.nansen.ai/api/token-god-mode/pnl-leaderboard.md)
- [Perp Screener](https://docs.nansen.ai/api/token-god-mode/perp-screener.md)
- [Perp PnL Leaderboard](https://docs.nansen.ai/api/token-god-mode/perp-pnl-leaderboard.md)
- [Perp Positions](https://docs.nansen.ai/api/token-god-mode/perp-positions.md)
- [Perp Trades](https://docs.nansen.ai/api/token-god-mode/perp-trades.md)
- [Portfolio](https://docs.nansen.ai/api/portfolio.md): DeFi Holdings API tracks active positions across DeFi protocols.
- [Chain Rank](https://docs.nansen.ai/api/chain-rank.md)
- [Agent](https://docs.nansen.ai/api/agent.md)
- [Feedback](https://docs.nansen.ai/api/feedback.md): Report bugs, missing capabilities and other API friction directly from your account, CLI or agent, and track the result with a durable receipt.
- [Trading](https://docs.nansen.ai/api/trade.md)
- [Spot Trading](https://docs.nansen.ai/api/trade/spot-trading.md)
- [Get a DEX swap quote](https://docs.nansen.ai/api/trade/spot-trading/quote.md)
- [Turn a quote into a signable transaction](https://docs.nansen.ai/api/trade/spot-trading/prepare.md)
- [Broadcast a signed swap transaction](https://docs.nansen.ai/api/trade/spot-trading/execute.md)
- [Check cross-chain bridge status](https://docs.nansen.ai/api/trade/spot-trading/bridge-status.md)
- [Perpetual Trading](https://docs.nansen.ai/api/trade/perp-trading.md): Open, manage and close Hyperliquid perpetual positions with your own keys — the prepare, sign and execute flow end to end.
- [Perpetual Trading reference](https://docs.nansen.ai/api/trade/perp-trading/perpetual-trading-reference.md)
- [Hyperliquid](https://docs.nansen.ai/api/hyperliquid.md)
- [Address Perp Positions](https://docs.nansen.ai/api/hyperliquid/address-perp-positions.md)
- [Address Perp Trades](https://docs.nansen.ai/api/hyperliquid/address-perp-trades.md)
- [Hyperliquid Leaderboard](https://docs.nansen.ai/api/hyperliquid/hyperliquid-leaderboard.md)
- [Perp Screener](https://docs.nansen.ai/api/hyperliquid/perp-screener.md)
- [Perp PnL Leaderboard](https://docs.nansen.ai/api/hyperliquid/perp-pnl-leaderboard.md)
- [Smart Money Perp Trades](https://docs.nansen.ai/api/hyperliquid/smart-money-perp-trades.md)
- [Token Perp Positions](https://docs.nansen.ai/api/hyperliquid/token-perp-positions.md)
- [Token Perp Trades](https://docs.nansen.ai/api/hyperliquid/token-perp-trades.md)
- [Backtesting Data](https://docs.nansen.ai/api/backtesting-data.md): Backtest your strategies against the same onchain intelligence that powers Nansen at any point in time.
- [Historical endpoint migration to v1](https://docs.nansen.ai/api/backtesting-data/historical-v1-migration.md)
- [Historical transaction lookup](https://docs.nansen.ai/api/backtesting-data/historical-transaction-lookup.md)
- [Historical Token Screener](https://docs.nansen.ai/api/backtesting-data/historical-token-screener.md)
- [Historical Top Holders](https://docs.nansen.ai/api/backtesting-data/historical-top-holders.md)
- [Historical Token DEX Trades](https://docs.nansen.ai/api/backtesting-data/historical-token-dex-trades.md)
- [Historical Token PnL Leaderboard](https://docs.nansen.ai/api/backtesting-data/historical-token-pnl-leaderboard.md)
- [Historical Token OHLCV](https://docs.nansen.ai/api/backtesting-data/historical-token-ohlcv.md)
- [Historical Token Flow Summary](https://docs.nansen.ai/api/backtesting-data/historical-token-flow-summary.md)
- [Historical Token Quant Scores](https://docs.nansen.ai/api/backtesting-data/historical-token-quant-scores.md)
- [Historical Address Balance](https://docs.nansen.ai/api/backtesting-data/historical-address-balance.md)
- [Historical Smart Money Positions](https://docs.nansen.ai/api/backtesting-data/historical-smart-money-positions.md)
- [Historical Smart Money Perps Positions](https://docs.nansen.ai/api/backtesting-data/historical-smart-money-perps-positions.md)
- [Historical Address Transactions](https://docs.nansen.ai/api/backtesting-data/historical-address-transactions.md)
- [Historical Token Who Bought/Sold](https://docs.nansen.ai/api/backtesting-data/historical-token-who-bought-sold.md)
- [Prediction Market](https://docs.nansen.ai/api/prediction-market.md)
- [Market Categories](https://docs.nansen.ai/api/prediction-market/market-categories.md)
- [Market Screener](https://docs.nansen.ai/api/prediction-market/market-screener.md)
- [Market Event Screener](https://docs.nansen.ai/api/prediction-market/market-event-screener.md)
- [Market Orderbook](https://docs.nansen.ai/api/prediction-market/market-orderbook.md)
- [Market OHLCV](https://docs.nansen.ai/api/prediction-market/market-ohlcv.md)
- [Market Position Details](https://docs.nansen.ai/api/prediction-market/market-position-details.md)
- [Market Top Holders](https://docs.nansen.ai/api/prediction-market/market-top-holders.md)
- [Trades By Market](https://docs.nansen.ai/api/prediction-market/trades-by-market.md)
- [PnL By Market](https://docs.nansen.ai/api/prediction-market/pnl-by-market.md)
- [PnL By Address](https://docs.nansen.ai/api/prediction-market/pnl-by-address.md)
- [Address Summary](https://docs.nansen.ai/api/prediction-market/address-summary.md)
- [Trades By Address](https://docs.nansen.ai/api/prediction-market/trades-by-address.md)
- [Points](https://docs.nansen.ai/api/points.md): Developer reference for the Permissionless Rewards API service.
- [Smart Alerts](https://docs.nansen.ai/api/smart-alerts.md): Configure automated on-chain alerts delivered to Telegram, Slack, or Discord.
- [API Changelog](https://docs.nansen.ai/api/changelog.md)
- [20-10-2026: Smart Money chains: \["all"\] Now Includes BNB](https://docs.nansen.ai/api/changelog/20-10-2026-smart-money-all-chains-include-bnb.md)
- [15-10-2026: Historical endpoints graduate to v1](https://docs.nansen.ai/api/changelog/15-10-2026-historical-endpoints-v1.md)
- [14-10-2026: Smart Trader Covers All Windows; Dated Smart Trader Labels Deprecated](https://docs.nansen.ai/api/changelog/14-10-2026-dated-smart-trader-labels-deprecation.md)
- [14-10-2026: PnL Endpoints No Longer Accept linea, mantle or plasma](https://docs.nansen.ai/api/changelog/14-10-2026-pnl-endpoints-drop-linea-mantle-plasma.md)
- [08-10-2026: Error Responses Report X-Nansen-Credits-Used: 0](https://docs.nansen.ai/api/changelog/08-10-2026-error-responses-credits-used.md)
- [05-10-2026: Hyperliquid OHLCV Date-Only End Covers the Whole Day](https://docs.nansen.ai/api/changelog/05-10-2026-hyperliquid-ohlcv-date-only-end.md)
- [05-10-2026: Agent Endpoints Return a Usable conversation\_id](https://docs.nansen.ai/api/changelog/05-10-2026-agent-conversation-id.md)
- [02-10-2026: FOMO Trader Labels](https://docs.nansen.ai/api/changelog/02-10-2026-fomo-trader-labels.md)
- [24-09-2026: wallet\_address Is the Name for a Wallet Input](https://docs.nansen.ai/api/changelog/24-09-2026-wallet-address-field-name.md)
- [23-09-2026: Smart Money Holdings Fund Filter Deprecation](https://docs.nansen.ai/api/changelog/23-09-2026-smart-money-holdings-fund-filter-deprecation.md)
- [15-09-2026: Counterparty Token Amounts Include Direction](https://docs.nansen.ai/api/changelog/15-09-2026-counterparties-token-amount.md)
- [08-09-2026: Perp PnL Leaderboard Trade Count Follows the Date Range](https://docs.nansen.ai/api/changelog/08-09-2026-perp-pnl-leaderboard-trade-count-window.md)
- [25-08-2026: Perp Leaderboard Adds Five Fields And Four Sort Options](https://docs.nansen.ai/api/changelog/25-08-2026-perp-leaderboard-new-fields.md)
- [24-08-2026: Perp Leaderboard ROI Corrections](https://docs.nansen.ai/api/changelog/24-08-2026-perp-leaderboard-roi-corrections.md)
- [17-07-2026: Premium Labels Default Change Now Live](https://docs.nansen.ai/api/changelog/17-07-2026-premium-labels-default-change-live.md)
- [31-03-2026: TGM Endpoints - Premium Labels Flag](https://docs.nansen.ai/api/changelog/31-03-2026-tgm-endpoints-premium-labels-flag.md)
- [29-08-2025: Major API Restructuring](https://docs.nansen.ai/api/changelog/2025-08-29.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.