Hunt Townh402
Catalog
CryptoPOSTlive

Token traders

Find addresses that bought or sold a token over a time window, with trade volume and smart-money filters.

$0.01
per call
Success
100%
p50 latency
2.84s
p95 latency
6.66s
Calls (30d)
3

Provider contract

Call path
/routes/nansen/crypto/token-traders
Method
POST
Selected provider
nansendefault
Provider price
$0.01
Settlement
Base USDC · x402 · 5% h402 fee

Quickstart

Both commands call the selected provider directly.

cURL
curl -X POST '/routes/nansen/crypto/token-traders' \
  -H 'content-type: application/json' \
  -d '{"chain":"base","token_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","date":{"from":"2026-05-15T00:00:00Z","to":"2026-05-21T23:59:59Z"}}'
CLI
h402 call 'crypto/token-traders' --provider 'nansen' --method POST --json '{"chain":"base","token_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","date":{"from":"2026-05-15T00:00:00Z","to":"2026-05-21T23:59:59Z"}}'

Parameters & live test

pays real USDC

Fill the request fields, quote the exact per-call total, then choose x402 or eligible bonus credit explicitly before sending. Only the selected provider's listed parameters are accepted.

chainstringrequired

Nansen-supported chain slug, such as base, ethereum, or solana.

e.g.
token_addressstringrequired

Token contract address or chain-native token address.

buy_or_sellstringoptional

Whether to rank net buyers or net sellers.

One of
dateobjectrequired

ISO 8601 date range with from and to fields.

date.fromstringrequired

Inclusive range start timestamp.

date.tostringrequired

Inclusive range end timestamp.

paginationobjectoptional

Optional pagination, e.g. { "page": 1, "perPage": 10 }.

pagination.pageintegeroptional≥ 1

1-based page number.

pagination.per_pageintegeroptional1–1000

Results per page.

filtersobjectoptional

Optional Nansen filter object, passed through as-is.

order_byarrayoptional

Optional Nansen sort order array, passed through as-is.

POST/routes/nansen/crypto/token-traders
Request body
{
  "chain": "base",
  "token_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "date": {
    "from": "2026-05-15T00:00:00Z",
    "to": "2026-05-21T23:59:59Z"
  }
}

ResponseExample response
{
  "data": {
    "data": [
      {
        "address": "0x51c72848c68a965f66fa7a88855f9f7784502a7f",
        "address_label": "🤖 Wintermute Market Making [0x51c728]",
        "bought_token_volume": 878187058.0668297,
        "sold_token_volume": 872248819.1938858,
        "token_trade_volume": 5938238.872943878,
        "bought_volume_usd": 877515959.6989836,
        "sold_volume_usd": 871847577.4283301,
        "trade_volume_usd": 5668382.270653486
      },
      {
        "address": "0xbee3211ab312a8d065c4fef0247448e17a8da000",
        "address_label": "​​🤖 DEX/CEX Trading Bot [0xbee321]",
        "bought_token_volume": 38547846.80122101,
        "sold_token_volume": 33422151.36010798,
        "token_trade_volume": 5125695.441113032,
        "bought_volume_usd": 38529369.45006042,
        "sold_volume_usd": 33412814.58584003,
        "trade_volume_usd": 5116554.864220388
      },
      {
        "address": "0x0fcbb3f9aecc556de81ee756f01191d94a3d085e",
        "address_label": "🤖 High Balance [0x0fcbb3]",
        "bought_token_volume": 16089203.132886078,
        "sold_token_volume": 12296099.491410956,
        "token_trade_volume": 3793103.6414751224,
        "bought_volume_usd": 16058211.93895234,
        "sold_volume_usd": 12262192.992537385,
        "trade_volume_usd": 3796018.946414955
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 10,
      "is_last_page": false
    }
  },
  "h402": {
    "routeId": "crypto/token-traders",
    "provider": "nansen",
    "selectedCandidateId": "crypto/token-traders/nansen",
    "routing": "manual",
    "paidBy": "x402-exact"
  }
}

Providers

Choose a provider for this task. The catalog recommends the current default from quality, reliability, and price; your selected provider stays pinned. Listed prices are provider prices; settlement adds a 5% h402 fee.

nansen
x402
100
Success
100%
p50
2.84s
Calls
3
100%
$0.01$0.010/call
Last successful call: 27d ago· Aggregated by h402 — not the source provider