# Nansen TGM Token Transfers > Nansen TGM Token Transfers is a paid API for AI agents from Nansen at api.nansen.ai, paid per call via MPP, $0.01/call, status unknown (last checked 2026-10-09). Retrieves paginated token transfer history for a specific token on a given chain, including DEX trades, CEX movements, and direct transfers with smart money labels. ## Facts - Endpoint: POST https://api.nansen.ai/api/v1/tgm/transfers?utm_source=zero.xyz - Price: $0.01/call - Payment: MPP - Status: unknown - Last checked: 2026-10-09 - Activations on Zero: 0 - Provider: Nansen - Docs: https://docs.nansen.ai - Website: https://nansen.ai - Tags: blockchain, smart-money, wallet, tokens, defi, analytics, profiler, dex, pnl, onchain, prediction-market, data - Canonical page: https://www.zero.xyz/c/nansen-transfers-7d8284f5 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4WBvkW_2gaVX6L9uI6Nwe Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability nansen-transfers-7d8284f5 -d '' ``` Example prompt: Show me all token transfers for USDC (0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48) on Ethereum between January 1 and January 31 2025, including both DEX trades and CEX movements — I want to see if big wallets are accumulating or distributing. ## When to prefer this Use this endpoint when you need granular, transaction-level token transfer data for a specific token, especially when you want to track exchange flows (CEX inflows/outflows) or DEX trade activity with Nansen's smart money address labels. Prefer this over aggregated flow endpoints when you need individual transaction hashes, timestamps, and labeled counterparties to trace specific wallets' accumulation or distribution behavior. ## Known failure modes - Missing required fields (chain, token_address, date) returns 422 validation error - Date range exceeding 1 year returns validation error - Unsupported chain enum value returns 422 - Invalid token address format may return empty results or error - Payment not provided returns 402 Payment Required - No transfers found for given filters returns empty data array ## How this service works Track all token transfer activity including direct transfers, DEX trades, and CEX movements. This endpoint is particularly useful for monitoring exchange flows - both centralized (CEX) and decentralized (DEX) - to identify accumulation or distribution patterns. ## Output A paginated list of token transfer records, each containing the transaction hash, block timestamp, sender and receiver addresses (with Nansen smart money labels like 'Binance 14'), transfer amount in token units and USD, and transaction type (DEX, CEX, or direct transfer). Also includes pagination metadata (current page, per-page count, total records). ## Request schema (JSON Schema) ```json { "type": "object", "title": "TGMTransfersRequest", "required": [ "chain", "token_address", "date" ], "properties": { "date": { "type": "object", "title": "DateRangeMaxOneYear", "properties": { "to": { "anyOf": [ { "type": "string" } ], "title": "To", "examples": [ "2025-01-31T23:59:59Z" ], "description": "End date in ISO 8601 format (e.g., 2025-01-31T23:59:59Z or 2025-01-31)" }, "from": { "anyOf": [ { "type": "string" } ], "title": "From", "examples": [ "2025-01-01T00:00:00Z" ], "description": "Start date in ISO 8601 format (e.g., 2025-01-01T00:00:00Z or 2025-01-01)" } }, "description": "Date range model with a maximum duration of 1 year.\n\nInherits all functionality from DateRange but adds validation to ensure\nthe date range does not exceed 366 days (to account for leap years).\n\nThis limit ensures optimal query performance." }, "chain": { "enum": [ "arbitrum", "arc", "avalanche", "base", "bitcoin", "bnb", "ethereum", "hyperevm", "injective", "iotaevm", "linea", "mantle", "mantra", "monad", "near", "optimism", "plasma", "polygon", "robinhood", "sei", "solana", "sonic", "starknet", "sui", "ton", "tron" ], "type": "string", "title": "TGMTransfersChain", "description": "Chains supported for TGM transfers endpoint." }, "filters": { "anyOf": [ { "type": "object", "title": "TGMTransfersFilters", "properties": { "to_address": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "title": "To Address", "examples": [ "0x28c6c06298d514db089934071355e5743bf21d60" ], "description": "To address filter" }, "include_cex": { "anyOf": [ { "type": "boolean" } ], "title": "Include Cex", "examples": [ true ], "description": "Whether to include CEX transfers" }, "include_dex": { "anyOf": [ { "type": "boolean" } ], "title": "Include Dex", "examples": [ true ], "description": "Whether to include … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "object", "title": "TGMTransfersResponse", "required": [ "data", "pagination" ], "properties": { "data": { "type": "array", "items": { "type": "object", "title": "TGMTransfer", "required": [ "block_timestamp", "transaction_hash", "from_address", "to_address" ], "properties": { "to_address": { "type": "string", "title": "To Address", "examples": [ "0x742d35cc6634c0532925a3b8d4c9db96c4b4d8b6" ], "description": "to address" }, "from_address": { "type": "string", "title": "From Address", "examples": [ "0x28c6c06298d514db089934071355e5743bf21d60" ], "description": "from address" }, "block_timestamp": { "type": "string", "title": "Block Timestamp", "examples": [ "2025-05-01T12:00:00Z" ], "description": "The block timestamp for the transaction" }, "transfer_amount": { "anyOf": [ { "type": "number" } ], "title": "Transfer Amount", "examples": [ 1000 ], "description": "value of the token traded" }, "to_address_label": { "anyOf": [ { "type": "string" } ], "title": "To Address Label", "examples": [ "High Balance" ], "description": "to address label" }, "transaction_hash": { "type": "string", "title": "Transaction Hash", "examples": [ "0x1234567890abcdef..." ], "description": "The transaction hash for the transaction" }, "transaction_type": { "anyOf": [ { "type": "string" } ], "title": "Transaction Type", "examples": [ "DEX" ], "description": "Transaction type" }, "from_address_label": { "anyOf": [ { "type": "string" } ], "title": "From Address Label", "examples": [ "🏦 Binance 14 [0x28c6c0]" ], "description": "from address label" }, "transfer_value_usd": { "anyOf": [ { "type": "number" } ], "title": "Transfer Value Usd", "examples": [ 2500 ], "description": "value of the token traded in USD" } }, "description": "Individual TGM transfer record.\n\nRepresents a single token transfer with transaction details and participant information." }, … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-transfers-7d8284f5/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from api.nansen.ai](https://www.zero.xyz/host/api.nansen.ai/llms.txt)