> 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) - [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 traders and funds. - [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) - [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 Related Wallets](https://docs.nansen.ai/api/profiler/address-related-wallets.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) - [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. - [Agent](https://docs.nansen.ai/api/agent.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 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 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 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) - [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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.nansen.ai/api.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.