{"uid":"cap_BZ1sSjeAGogBYnw0UpJeo","slug":"api-nansen-ai-febe3a22","name":"Nansen TGM Transfers","description":"Get \"Token God Mode\" (TGM) transfers data","url":"https://api.nansen.ai/api/v1/tgm/transfers","method":"GET","headers":{},"bodySchema":{"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","avalanche","base","bitcoin","bnb","ethereum","hyperevm","injective","iotaevm","linea","mantle","mantra","monad","near","optimism","plasma","polygon","ronin","scroll","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 DEX transfers"},"from_address":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"From Address","examples":["0x28c6c06298d514db089934071355e5743bf21d60"],"description":"From address filter"},"transfer_amount":{"anyOf":[{"type":"object","title":"NumericRangeFilter","properties":{"max":{"anyOf":[{"type":"number"}],"title":"Max","examples":[50000,10000000,100],"description":"Maximum value (inclusive)"},"min":{"anyOf":[{"type":"number"}],"title":"Min","examples":[1000,1000000,-50,0],"description":"Minimum value (inclusive)"}},"description":"Filter for numeric values (floats) with optional min/max bounds.\nUse for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75"}],"examples":[{"min":100}],"description":"Transfer amount range filter"},"only_smart_money":{"anyOf":[{"type":"boolean"}],"title":"Only Smart Money","examples":[true],"description":"Whether to include only smart money transfers"},"to_address_label":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"To Address Label","examples":["Smart Money","%Exchange%"],"description":"To address label filter"},"transaction_hash":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Transaction Hash","examples":["0x61adb6da30853c5988f0204dd9f6e4abbc878e02c34030a4f707cf4ec3124bcb"],"description":"Transaction hash filter"},"transaction_type":{"anyOf":[{"type":"string"}],"title":"Transaction Type","examples":["transfer","dex_trade"],"description":"Transaction type filter"},"from_address_label":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"From Address Label","examples":["Smart Money","%Fund%"],"description":"From address label filter"},"transfer_value_usd":{"anyOf":[{"type":"object","title":"NumericRangeFilter","properties":{"max":{"anyOf":[{"type":"number"}],"title":"Max","examples":[50000,10000000,100],"description":"Maximum value (inclusive)"},"min":{"anyOf":[{"type":"number"}],"title":"Min","examples":[1000,1000000,-50,0],"description":"Minimum value (inclusive)"}},"description":"Filter for numeric values (floats) with optional min/max bounds.\nUse for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75"}],"examples":[{"min":1000}],"description":"Transfer value range filter in USD"},"non_exchange_transfers":{"anyOf":[{"type":"boolean"}],"title":"Non Exchange Transfers","examples":[true],"description":"Whether to include non-exchange transfers"},"to_exclude_smart_money_labels":{"anyOf":[{"type":"array","items":{"enum":["30D Smart Trader","90D Smart Trader","180D Smart Trader","Fund","Smart Trader","Public Figure","Exchange","Whale","BananaGun Bot User","Top Maestro Bot User","Top BananaGun Bot User","Maestro Bot User","Early MAGIC Miner","First Mover LP","First Mover Staking","Profitable LP","Smart HL Perps Trader"],"type":"string","title":"LabelType","description":"Filter by entity label type."}}],"title":"To Exclude Smart Money Labels","examples":[["Public Figure"],["Exchange"]],"description":"Exclude smart money labels for to address"},"to_include_smart_money_labels":{"anyOf":[{"type":"array","items":{"enum":["30D Smart Trader","90D Smart Trader","180D Smart Trader","Fund","Smart Trader","Public Figure","Exchange","Whale","BananaGun Bot User","Top Maestro Bot User","Top BananaGun Bot User","Maestro Bot User","Early MAGIC Miner","First Mover LP","First Mover Staking","Profitable LP","Smart HL Perps Trader"],"type":"string","title":"LabelType","description":"Filter by entity label type."}}],"title":"To Include Smart Money Labels","examples":[["Public Figure"],["Exchange"]],"description":"Include smart money labels for to address"},"from_exclude_smart_money_labels":{"anyOf":[{"type":"array","items":{"enum":["30D Smart Trader","90D Smart Trader","180D Smart Trader","Fund","Smart Trader","Public Figure","Exchange","Whale","BananaGun Bot User","Top Maestro Bot User","Top BananaGun Bot User","Maestro Bot User","Early MAGIC Miner","First Mover LP","First Mover Staking","Profitable LP","Smart HL Perps Trader"],"type":"string","title":"LabelType","description":"Filter by entity label type."}}],"title":"From Exclude Smart Money Labels","examples":[["Public Figure"],["Exchange"]],"description":"Exclude smart money labels for from address"},"from_include_smart_money_labels":{"anyOf":[{"type":"array","items":{"enum":["30D Smart Trader","90D Smart Trader","180D Smart Trader","Fund","Smart Trader","Public Figure","Exchange","Whale","BananaGun Bot User","Top Maestro Bot User","Top BananaGun Bot User","Maestro Bot User","Early MAGIC Miner","First Mover LP","First Mover Staking","Profitable LP","Smart HL Perps Trader"],"type":"string","title":"LabelType","description":"Filter by entity label type."}}],"title":"From Include Smart Money Labels","examples":[["Public Figure"],["Exchange"]],"description":"Include smart money labels for from address"}},"description":"Filters for TGM transfers endpoint.\n\nThese filters control which transfers are included in the analysis.","additionalProperties":false}],"examples":[{"include_cex":true,"include_dex":true,"only_smart_money":true,"non_exchange_transfers":true}],"description":"Additional filters to apply to the query."},"order_by":{"anyOf":[{"type":"array","items":{"type":"object","title":"SortOrder[TGMTransfersSortField]","required":["field","direction"],"properties":{"field":{"enum":["block_timestamp","transaction_hash","from_address","to_address","from_address_label","to_address_label","transaction_type","transfer_amount","transfer_value_usd"],"type":"string","title":"TGMTransfersSortField","description":"Enum for sortable fields in TGM transfers."},"direction":{"enum":["ASC","DESC"],"type":"string","title":"SortDirection","description":"Enum for sort directions."}}}}],"title":"Order By","description":"Custom sort order to override the endpoint's default ordering.\n\nExamples:\n- [{\"field\": \"transfer_value_usd\", \"direction\": \"ASC\"}] - Sort by transfer value ascending\n- [{\"field\": \"transfer_amount\", \"direction\": \"DESC\"}] - Sort by transfer amount descending"},"pagination":{"type":"object","title":"PaginationRequest","properties":{"page":{"type":"integer","title":"Page","default":1,"minimum":1,"description":"Page number (1-based)"},"per_page":{"type":"integer","title":"Per Page","default":10,"maximum":1000,"minimum":1,"description":"Number of records per page (max 1000)"}},"description":"Pagination parameters for API requests."},"token_address":{"type":"string","title":"Token Address","examples":["0x6982508145454ce325ddbe47a25d4ec3d2311933"],"description":"Token address"}},"description":"Request model for TGM transfers endpoint.\n\nThis endpoint provides top token transfers for a specific token, with support for ERC-20 tokens. The model selection is dynamic based\non the token address.","additionalProperties":false},"responseSchema":{"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."},"title":"Data","description":"List of TGM transfer records"},"pagination":{"type":"object","title":"PaginationInfo","properties":{"page":{"type":"integer","title":"Page","default":1,"minimum":1,"description":"Current page number"},"per_page":{"type":"integer","title":"Per Page","default":10,"maximum":1000,"minimum":1,"description":"Number of records per page"},"is_last_page":{"type":"boolean","title":"Is Last Page","default":true,"description":"Whether this is the last page"}},"description":"Pagination information for API responses."}},"description":"Response model for TGM transfers endpoint.\n\nContains a list of transfer records with pagination and metadata."},"example":{"request":{"date":{"to":"2025-01-31","from":"2025-01-01"},"chain":"ethereum","pagination":{"page":1,"per_page":10},"token_address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},"response":{"data":[{"to_address":"0xa9d1e08c7793af67e9d92fe308d5697fb81d3e43","from_address":"0x28c5b0445d0728bc25f143f8eba5c5539fae151a","block_timestamp":"2025-01-21T21:42:11","transfer_amount":800000000,"to_address_label":"🤖 🏦 Coinbase [0xa9d1e0]","transaction_hash":"0x0dd52d211145889c6f0a05ec203a5b657bc4005649c6581e417f03fa7a3f388c","transaction_type":"transfer","from_address_label":"🏦 Coinbase: USDC Wallet [0x28c5b0]","transfer_value_usd":800005759.9813896},{"to_address":"0x28c5b0445d0728bc25f143f8eba5c5539fae151a","from_address":"0x55fe002aeff02f77364de339a1292923a15844b8","block_timestamp":"2025-01-21T21:38:35","transfer_amount":800000000,"to_address_label":"🏦 Coinbase: USDC Wallet [0x28c5b0]","transaction_hash":"0x6b8d68612a07a486e7e90d8bf10b59cec0a5a8d43ebc852e2d581e65c598953c","transaction_type":"transfer","from_address_label":"Circle: Wallet [0x55fe00]","transfer_value_usd":800005759.9813896},{"to_address":"0xf977814e90da44bfa03b6295a0616a897441acec","from_address":"0x28c6c06298d514db089934071355e5743bf21d60","block_timestamp":"2025-01-06T02:41:35","transfer_amount":722089988.429,"to_address_label":"🏦 Binance: Reserve Address [0xf97781]","transaction_hash":"0x34b7cdaaafc1790796706bf2594d98faedfe23a774f62b67db0706b948d42909","transaction_type":"transfer","from_address_label":"🏦 Binance 14 [0x28c6c0]","transfer_value_usd":722146184.4998494},{"to_address":"0x28c6c06298d514db089934071355e5743bf21d60","from_address":"0xf977814e90da44bfa03b6295a0616a897441acec","block_timestamp":"2025-01-21T14:00:35","transfer_amount":550732850.553595,"to_address_label":"🏦 Binance 14 [0x28c6c0]","transaction_hash":"0x8df68fc4f94b0f0482a1de44eab50116dcc5242da72098101e675ff2e623208b","transaction_type":"transfer","from_address_label":"🏦 Binance: Reserve Address [0xf97781]","transfer_value_usd":550736815.8173072},{"to_address":"0xf977814e90da44bfa03b6295a0616a897441acec","from_address":"0x28c6c06298d514db089934071355e5743bf21d60","block_timestamp":"2025-01-19T05:42:35","transfer_amount":548946775.384,"to_address_label":"🏦 Binance: Reserve Address [0xf97781]","transaction_hash":"0x71034cffb7023b1be3d0d299462b21df5d367cbf2480f875530577090fe4f2a0","transaction_type":"transfer","from_address_label":"🏦 Binance 14 [0x28c6c0]","transfer_value_usd":548932005.5868882},{"to_address":"0xf977814e90da44bfa03b6295a0616a897441acec","from_address":"0x28c6c06298d514db089934071355e5743bf21d60","block_timestamp":"2025-01-20T01:42:47","transfer_amount":529696062.956,"to_address_label":"🏦 Binance: Reserve Address [0xf97781]","transaction_hash":"0xd21727eedbe3081108dbed244b0bf26a380cf4a8d3b557f330d60e316f0aa9c1","transaction_type":"transfer","from_address_label":"🏦 Binance 14 [0x28c6c0]","transfer_value_usd":529694645.11107415},{"to_address":"0x55fe002aeff02f77364de339a1292923a15844b8","from_address":"0x0000000000000000000000000000000000000000","block_timestamp":"2025-01-21T21:22:11","transfer_amount":460861894.78,"to_address_label":"Circle: Wallet [0x55fe00]","transaction_hash":"0x904bcb68816b8f6c33969b398dcec90c9e5e243eb82e96109b73c30e73569cd3","transaction_type":"mint","from_address_label":"Burn Address [0x000000]","transfer_value_usd":460865212.97492135},{"to_address":"0xdfd5293d8e347dfe59e90efd55b2956a1343963d","from_address":"0x28c6c06298d514db089934071355e5743bf21d60","block_timestamp":"2025-01-21T14:02:11","transfer_amount":352182406.193676,"to_address_label":"🏦 Binance [0xdfd529]","transaction_hash":"0xe0210aaa83dd8f79c52d9b9d274a9eac05bc332b30fb5b499640badd0c05216d","transaction_type":"transfer","from_address_label":"🏦 Binance 14 [0x28c6c0]","transfer_value_usd":352184941.89880776},{"to_address":"0x28c5b0445d0728bc25f143f8eba5c5539fae151a","from_address":"0x55fe002aeff02f77364de339a1292923a15844b8","block_timestamp":"2025-01-02T22:37:35","transfer_amount":300000000,"to_address_label":"🏦 Coinbase: USDC Wallet [0x28c5b0]","transaction_hash":"0x0fb688dca5eb3ecf4b0f13243e5ef326cbafafb3456ccf9d0de15a88cf9a339a","transaction_type":"transfer","from_address_label":"Circle: Wallet [0x55fe00]","transfer_value_usd":300024945.0158915},{"to_address":"0x55fe002aeff02f77364de339a1292923a15844b8","from_address":"0x0000000000000000000000000000000000000000","block_timestamp":"2025-01-02T22:35:11","transfer_amount":300000000,"to_address_label":"Circle: Wallet [0x55fe00]","transaction_hash":"0x4ff8cd264ae54ef47d540ec46b7f51cf3772b4bee48d26280342f87f6210c3d8","transaction_type":"mint","from_address_label":"Burn Address [0x000000]","transfer_value_usd":300024945.0158915}],"pagination":{"page":1,"per_page":10,"is_last_page":false}}},"exampleRequest":{"date":{"to":"2025-01-31","from":"2025-01-01"},"chain":"ethereum","pagination":{"page":1,"per_page":10},"token_address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.33","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LJWZU8FskUXf4rw-1iQJr","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_FPAiJGciOGh6odMNUjBKo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves token transfer data from TGM (Token General Market) on-chain activity via Nansen's analytics platform","exampleAgentPrompt":"Can you pull the TGM transfer data from Nansen for the token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 so I can see which wallets have been moving it recently?","exampleUseCases":null,"resultDescription":"A list of TGM token transfer records including sender and receiver addresses, token amounts, transaction hashes, timestamps, and Nansen wallet labels (e.g. smart money, exchange, whale) enriching each address involved in the transfers.","failureModes":["Invalid or unsupported token/contract address returns 400 error","Unauthenticated or unauthorized request returns 401/403","No transfers found for the given parameters returns empty result set","Rate limiting or quota exceeded returns 429","Malformed request body returns 400 with validation error"],"whenToPreferThis":"Use this endpoint when you need labeled, enriched token transfer data from Nansen's TGM dataset — especially when wallet identity labels (smart money, exchanges, whales) matter. Prefer this over raw RPC calls or block explorers when you want Nansen's proprietary entity tagging layered on top of transfer activity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-05-27T19:07:39.785Z","lastSuccessfullyRanAt":"2026-05-27T19:07:39.785Z","lastHealthCheckAt":"2026-09-14T00:47:00.083Z","isFirstParty":false}