Catalog
cryptoPOSTlive

Token holders

Analyze top token holders, smart-money labels, exchange holders, and holder balance changes.

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

Canonical contract

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

Quickstart

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

Sample input

requiredoptional
{
  "chain": "base",
  "token_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "label_type": "all_holders",
  "pagination": {
    "page": 1,
    "per_page": 10
  }
}

Sample output

Redacted, from a paid call
{
  "holders": [
    {
      "address": "0x1234567890123456789012345678901234567890",
      "addressLabel": "Smart Money",
      "tokenAmount": 1000000,
      "ownershipPercentage": 2.5,
      "valueUsd": 50000
    }
  ],
  "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.05$0.050/call
Last successful call: 12d ago· Aggregated by h402 — not the source provider