# Nansen API ## Nansen API V1 - [Introduction](https://docs.nansen.ai/readme.md) - [Getting Started](https://docs.nansen.ai/getting-started.md): Welcome to the Nansen API. This guide will help you get up and running quickly. - [Authentication](https://docs.nansen.ai/getting-started/authentication.md) - [AI Agent Access](https://docs.nansen.ai/getting-started/agents.md): Connect your AI agent to Nansen's blockchain data API in under a minute. - [Rate Limits](https://docs.nansen.ai/getting-started/rate-limits.md) - [Credits & Pricing Guide](https://docs.nansen.ai/getting-started/credits.md) - [Error Handling](https://docs.nansen.ai/getting-started/error-handling.md) - [Agentic Payments](https://docs.nansen.ai/getting-started/agentic-payments.md) - [MPP (Tempo)](https://docs.nansen.ai/getting-started/agentic-payments/mpp-tempo.md) - [x402 Payments](https://docs.nansen.ai/getting-started/agentic-payments/x402-payments.md) - [Make Your First API Call](https://docs.nansen.ai/first-api-call.md): Welcome! In the next 2 minutes, you’ll make your first API call and unlock real-time blockchain insights. - [Reference](https://docs.nansen.ai/reference.md) - [Supported Chains](https://docs.nansen.ai/reference/chains.md) - [Filter Types](https://docs.nansen.ai/reference/filters.md) - [Sorting](https://docs.nansen.ai/reference/sorting.md) - [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 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) - [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) - [Points](https://docs.nansen.ai/api/points.md): Developer reference for the Permissionless Rewards API service. - [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) - [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) - [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) - [Nansen CLI](https://docs.nansen.ai/cli.md) - [Overview](https://docs.nansen.ai/mcp/overview.md): Learn how to connect AI agents to Nansen - [Connecting to Nansen MCP](https://docs.nansen.ai/mcp/connecting.md) - [Tools supported by Nansen MCP](https://docs.nansen.ai/mcp/tools.md) - [Common MCP clients](https://docs.nansen.ai/mcp/mcp-clients.md) - [MCP Data Redistribution Guidelines](https://docs.nansen.ai/mcp/redistribution-guidelines.md) - [Use case Templates](https://docs.nansen.ai/guides/templates.md) - [Simple Use cases](https://docs.nansen.ai/guides/templates/simple-use-cases.md) - [Complex Use cases](https://docs.nansen.ai/guides/templates/complex-use-cases.md) - [Use case 1: Automated Token Tracking & Smart Money Analysis](https://docs.nansen.ai/guides/templates/complex-use-cases/use-case-1-automated-token-tracking-and-smart-money-analysis.md) - [Use Case 2: Find & Copytrade Wallets on Hyperliquid](https://docs.nansen.ai/guides/templates/complex-use-cases/use-case-2-find-and-copytrade-wallets-on-hyperliquid.md): Use Nansen API To Find and Copytrade Profitable Wallets on Hyperliquid - [Use case 3: Identifying Related Wallets at Scale](https://docs.nansen.ai/guides/templates/complex-use-cases/use-case-3-identifying-related-wallets-at-scale.md) - [Use case 4: Copytrading Top Performing Wallets](https://docs.nansen.ai/guides/templates/complex-use-cases/use-case-4-copytrading-top-performing-wallets.md) - [Use case 5: Monitoring CEX Health](https://docs.nansen.ai/guides/templates/complex-use-cases/use-case-5-monitoring-cex-health.md) - [Data Methodology & Technical Reference](https://docs.nansen.ai/guides/data-methodology-and-technical-reference.md): This page provides detailed technical specifications about how data is calculated, returned, and timed across Nansen API endpoints. This information is essential for quantitative analysis, backtesting - [Data Redistribution Guidelines](https://docs.nansen.ai/guides/redistribution-guide.md): Updated as of 18/11/2025 - [Frequently Asked Questions](https://docs.nansen.ai/guides/faq.md) - [Useful Links](https://docs.nansen.ai/guides/links.md) --- # Agent Instructions: Querying This Documentation If you need additional information, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on a page URL with the `ask` query parameter: ``` GET https://docs.nansen.ai/readme.md?ask= ``` 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.