Token Transfers

Get 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

ApiKeyAuth

apiKeystringRequired

API key for authentication

Body

application/json

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

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

post

/api/v1/tgm/transfers

HTTPcURLJavaScriptPython

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

{
  "chain": "ethereum",
  "token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
  "date": {
    "from": "2025-05-01",
    "to": "2025-05-03"
  },
  "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
  }
}