Track token transfers across DEX, CEX, and direct movements with Nansen's labeled on-chain data.
What it does
The Nansen TGM Transfers endpoint (`/api/v1/tgm/transfers`) provides detailed token transfer activity for a specific token on a given blockchain. It tracks all transfer types including direct wallet-to-wallet transfers, DEX trades, and CEX deposit/withdrawal movements. Each transfer record includes from/to addresses with Nansen labels, transaction type classification, transfer amounts, and USD valuations.
The endpoint accepts POST requests with a chain identifier, token address, and a date range (max 1 year). Filters allow narrowing results by exchange type (CEX, DEX), non-exchange transfers, smart money only, specific addresses, label categories (whale, smart money, public figure, exchange), transaction type, and transfer value ranges. Results are paginated (up to 1000 per page) and sortable by timestamp, addresses, transfer amount, or USD value.
This endpoint is part of Nansen's Token God Mode (TGM) suite and is payable via the x402 protocol at $0.01 per request. It supports 25+ chains including Ethereum, Solana, Base, Arbitrum, BNB, Polygon, and others. The 402 challenge was confirmed live during probing.
Capabilities
Use cases
- —Monitor exchange inflows/outflows for a specific token to detect accumulation or distribution patterns
- —Track smart money and whale token movements in real time
- —Identify large transfers between labeled wallets (exchanges, funds, public figures)
- —Analyze CEX vs DEX transfer patterns for a token over a date range
- —Build alerts for significant token transfers by labeled entities
Fit
Best for
- —Crypto traders monitoring smart money and whale activity on specific tokens
- —Research analysts tracking exchange flow patterns for tokens across multiple chains
- —Trading bots that need labeled transfer data to inform position decisions
- —Portfolio tools showing token movement history with counterparty identification
Not for
- —Historical price or OHLCV data (use /api/v1/tgm/token-ohlcv instead)
- —Aggregate netflow summaries without individual transfers (use /api/v1/smart-money/netflow)
- —Non-blockchain or traditional finance transfer tracking
Quick start
curl -X POST https://api.nansen.ai/api/v1/tgm/transfers \
-H 'Content-Type: application/json' \
-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": {
"only_smart_money": true,
"transfer_value_usd": {
"min": 1000
}
},
"pagination": {
"page": 1,
"per_page": 10
},
"token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933"
}Response
{
"data": [
{
"to_address": "0x742d35cc6634c0532925a3b8d4c9db96c4b4d8b6",
"from_address": "0x28c6c06298d514db089934071355e5743bf21d60",
"block_timestamp": "2025-01-05T12:00:00Z",
"transfer_amount": 1000000,
"to_address_label": "High Balance",
"transaction_hash": "0x1234567890abcdef...",
"transaction_type": "DEX",
"from_address_label": "Binance 14",
"transfer_value_usd": 2500
}
],
"pagination": {
"page": 1,
"per_page": 10,
"is_last_page": false
}
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response models, comprehensive filter documentation, clear pricing ($0.01/request via x402), and confirmed live 402 challenge. Minor deduction because no example responses were captured from the live endpoint itself.
Citations
- —The /api/v1/tgm/transfers endpoint costs $0.01 per request via x402 protocolhttps://api.nansen.ai
- —The endpoint supports 25+ chains including ethereum, solana, base, arbitrum, bnb, polygon, and othershttps://api.nansen.ai
- —Date range is limited to a maximum of 1 yearhttps://api.nansen.ai
- —The endpoint returned a 402 Payment Required response confirming it is livehttps://api.nansen.ai/api/v1/tgm/transfers