Catalog
cryptoPOSTlive

Token traders

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

h402 score
$0.01
per call
Success
100%
p50 latency
0ms
p95 latency
0ms
Calls (30d)
1

Canonical contract

Proxy path
/api/proxy/crypto/token-traders
Method
POST
Selected provider
nansen
Settlement
Base USDC · x402

Quickstart

cURL
curl -X POST https://h402-test.hunt.town/api/proxy/crypto/token-traders
CLI
h402 call crypto/token-traders --json '{ ... }'

Sample input

requiredoptional
{
  "chain": "base",
  "token_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "buy_or_sell": "BUY",
  "date": {
    "from": "2026-05-15T00:00:00Z",
    "to": "2026-05-21T23:59:59Z"
  },
  "pagination": {
    "page": 1,
    "per_page": 10
  }
}

Sample output

Redacted, from a paid call
{
  "traders": [
    {
      "address": "0x1234567890123456789012345678901234567890",
      "addressLabel": "High Gas Consumer",
      "boughtTokenVolume": 1000.5,
      "soldTokenVolume": 500.25,
      "boughtVolumeUsd": 25000,
      "soldVolumeUsd": 12500,
      "tradeVolumeUsd": 12500
    }
  ],
  "pagination": {
    "page": 1,
    "perPage": 10,
    "isLastPage": true
  },
  "meta": {
    "provider": "nansen"
  }
}

Providers

Candidates competing behind this task. h402 routes each call to the best quality-adjusted option.

nansenselected
x402
Success
100%
p50
0ms
Calls
1
100%
$0.01$0.010/call
Last successful call: 12d ago· Aggregated by h402 — not the source provider