Track all token transfer activity including DEX trades, CEX movements, and direct transfers for any token.
What it does
The Nansen TGM Transfers endpoint (`/api/v1/tgm/transfers`) provides comprehensive token transfer tracking for a specific token on a given chain. It covers direct transfers, DEX trades, and CEX (centralized exchange) movements, making it useful for monitoring exchange flows and identifying accumulation or distribution patterns.
The endpoint accepts POST requests with a chain, token address, date range (max 1 year), and optional filters. Filters include toggling DEX/CEX/non-exchange transfers, smart money-only mode, from/to address and label filters, transaction type, transfer amount, and USD value ranges. Results include block timestamp, transaction hash, from/to addresses with Nansen labels, transaction type, transfer amount, and USD value. Pagination (up to 1000 per page) and custom sort ordering are supported.
Pricing is $0.01 per call via the x402 protocol, or 10 credits (free tier) / 1 credit (pro tier) when using a Nansen API key. The endpoint supports 20+ chains including Ethereum, Solana, Base, Arbitrum, BNB, Polygon, and others. Rate limits are enforced per-second and per-minute, reported via response headers.
Capabilities
Use cases
- —Monitor large token transfers to/from centralized exchanges to detect accumulation or distribution
- —Track smart money token movements for a specific token across chains
- —Identify DEX trading activity and direct transfers for a token within a date range
- —Build alerts for significant token transfers involving labeled wallets
- —Analyze exchange flow patterns to inform trading decisions
Fit
Best for
- —Blockchain analysts tracking token flows across DEX and CEX
- —Trading bots monitoring smart money transfer activity
- —Portfolio tools needing labeled transfer data for specific tokens
- —Research teams studying token distribution and accumulation patterns
Not for
- —General-purpose block explorer queries (this is token-specific, not address-specific)
- —Historical data beyond 1 year (date range capped at 1 year)
- —NFT transfer tracking (separate endpoints exist for that)
Quick start
curl -X POST https://api.nansen.ai/api/v1/tgm/transfers \
-H 'Content-Type: application/json' \
-H 'apiKey: YOUR_API_KEY' \
-d '{
"chain": "ethereum",
"token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"date": {"from": "2025-01-01T00:00:00Z", "to": "2025-01-07T23:59:59Z"},
"pagination": {"page": 1, "per_page": 10}
}'Example
Request
{
"date": {
"to": "2025-01-07T23:59:59Z",
"from": "2025-01-01T00:00:00Z"
},
"chain": "ethereum",
"filters": {
"include_cex": true,
"include_dex": true,
"only_smart_money": false,
"transfer_value_usd": {
"min": 1000
},
"non_exchange_transfers": true
},
"pagination": {
"page": 1,
"per_page": 10
},
"token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933"
}Response
{
"data": [
{
"to_address": "0x742d35cc6634c0532925a3b8d4c9db96c4b4d8b6",
"from_address": "0x28c6c06298d514db089934071355e5743bf21d60",
"block_timestamp": "2025-01-05T14:23:11Z",
"transfer_amount": 50000000,
"to_address_label": "High Balance",
"transaction_hash": "0xabc123...",
"transaction_type": "DEX",
"from_address_label": "Binance 14",
"transfer_value_usd": 12500.5
}
],
"pagination": {
"page": 1,
"per_page": 10,
"is_last_page": false
}
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response models, clear endpoint description, x402 pricing ($0.01/call), and confirmed live 402 MPP challenge. No crawled docs beyond the API root, but the OpenAPI spec is comprehensive with filter enums, sort fields, and chain support.
Warnings
- —No external documentation pages were accessible (docs/pricing pages returned 404); all information derived from OpenAPI spec.
- —Exact request body schema references (TGMTransfersRequest, TGMTransfersResponse) are defined but component details for nested filters rely on shared models.
Citations
- —Endpoint is at /api/v1/tgm/transfers, POST method, described as tracking all token transfer activity including direct transfers, DEX trades, and CEX movementshttps://api.nansen.ai
- —x402 fixed price of $0.01 per call; credit cost is 10 (free) / 1 (pro)https://api.nansen.ai
- —Date range is capped at max 1 year (DateRangeMaxOneYear model)https://api.nansen.ai
- —Supports 26 chains including ethereum, solana, base, arbitrum, bnb, polygon, etc.https://api.nansen.ai
- —MPP 402 challenge confirmed live via HEAD probehttps://api.nansen.ai/api/v1/tgm/transfers