Token Transfers

Native-token queries are supported only for Bitcoin on this endpoint. Other chains require a contract token address. See Native Tokens.

Data Freshness & Historical Coverage

For data freshness and historical coverage, see Data Coverage by Chain; this endpoint follows it.

Get "Token God Mode" (TGM) transfers data

post

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.

Authorizations

apikeystringRequired

API key for authentication

Body

Request model for TGM transfers endpoint.

This endpoint provides top token transfers for a specific token, with support for ERC-20 tokens. The model selection is dynamic based on the token address.

chainstring · enumRequired

Blockchain chain

Example: ethereumPossible values:

token_addressstringRequired

Token address

Example: 0x6982508145454ce325ddbe47a25d4ec3d2311933

filtersany ofOptional

Additional filters to apply to the query.

Example: {"include_cex":true,"include_dex":true,"non_exchange_transfers":true,"only_smart_money":true}

order_byany ofOptional

Custom sort order to override the endpoint's default ordering.

Examples:

• [{"field": "transfer_value_usd", "direction": "ASC"}] - Sort by transfer value ascending
• [{"field": "transfer_amount", "direction": "DESC"}] - Sort by transfer amount descending

Responses

200

TGM transfers data

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

502

Bad Gateway

application/json

503

Service Unavailable

application/json

504

Gateway Timeout

application/json

post/api/v1/tgm/transfers

POST /api/v1/tgm/transfers HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 349

{
  "chain": "ethereum",
  "token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
  "date": {
    "from": "2025-05-01T00:00:00Z",
    "to": "2025-05-03T23:59:59Z"
  },
  "pagination": {
    "page": 1,
    "per_page": 10
  },
  "filters": {
    "include_cex": true,
    "include_dex": true,
    "non_exchange_transfers": true,
    "only_smart_money": true
  },
  "order_by": [
    {
      "field": "block_timestamp",
      "direction": "ASC"
    }
  ]
}

{
  "data": [
    {
      "block_timestamp": "2025-05-01T12:00:00Z",
      "transaction_hash": "0x1234567890abcdef...",
      "from_address": "0x28c6c06298d514db089934071355e5743bf21d60",
      "to_address": "0x742d35cc6634c0532925a3b8d4c9db96c4b4d8b6",
      "from_address_label": "🏦 Binance 14 [0x28c6c0]",
      "to_address_label": "High Balance",
      "transaction_type": "DEX",
      "transfer_amount": 1000,
      "transfer_value_usd": 2500
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  }
}