Hunt Townh402
Catalog
CryptoPOSTlive

Token holders

Top holders for a token with balances and ownership share across indexed onchain data.

$0.02
per call
Success
100%
p50 latency
3.74s
p95 latency
7.11s
Calls (30d)
6

Provider contract

Call path
/routes/
tingdefault
/crypto/token-holders
Method
POST
Selected provider
tingdefault
Provider price
$0.02
Settlement
Base USDC · x402 · 5% h402 fee

Quickstart

Both commands call the selected provider directly.

cURL
curl -X POST '/routes/ting/crypto/token-holders' \
  -H 'content-type: application/json' \
  -d '{"chain":"base","token":"0x833589fCD6eDb6E08f4C7C32D4f71b54bdA02913","limit":25}'
CLI
h402 call 'crypto/token-holders' --provider 'ting' --method POST --json '{"chain":"base","token":"0x833589fCD6eDb6E08f4C7C32D4f71b54bdA02913","limit":25}'

Parameters & live test

pays real USDC
tingdefault$0.020/call

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

EVM chain slug; Ting's /api/ting/scan serves exactly these chains (docs verified 2026-07-07).

One of
tokenstringrequired

Token contract address (0x...).

e.g.
limitintegeroptional1–99default 25

Maximum holders to return.

minBalanceRawstringoptional

Provider-native minimum raw token balance filter.

e.g.
maxBalanceRawstringoptional

Provider-native maximum raw token balance filter.

e.g.
POST/routes/ting/crypto/token-holders
Request body
{
  "chain": "base",
  "token": "0x833589fCD6eDb6E08f4C7C32D4f71b54bdA02913",
  "limit": 25
}

ResponseExample response
{
  "data": {
    "holders": [
      {
        "address": "0xbbbbbbbbbb9cc5e90e3b3af64bdaf62c37eeffcb",
        "addressLabel": null,
        "tokenAmount": "187435228104575",
        "ownershipPercentage": null,
        "valueUsd": null
      },
      {
        "address": "0x8da91a6298ea5d1a8bc985e99798fd0a0f05701a",
        "addressLabel": null,
        "tokenAmount": "160000000210698",
        "ownershipPercentage": null,
        "valueUsd": null
      },
      {
        "address": "0xb026ba5501c9fcdb5b4b746c37e349cd61b81b22",
        "addressLabel": null,
        "tokenAmount": "158707811660177",
        "ownershipPercentage": null,
        "valueUsd": null
      }
    ],
    "pagination": {
      "nextCursor": "eyJhbGciOiJIUzI1NiJ9.eyJsYXN0S2V5Ijp7InRva2VuQWRkcmVzcyI6IjB4ODMzNTg5ZmNkNmVkYjZlMDhmNGM3YzMyZDRmNzFiNTRiZGEwMjkxMyIsIndhbGxldEFkZHJlc3MiOiIweDYxMjY3YWIxYjk3MzU0MDFkM2ZlN2Q0YTFjYzI1OWM1OGExNTE5MGYiLCJiYWxhbmNlIjoiMzExMTc4NjcxMDAwMCJ9LCJwYWdlIjoxLCJyZXF1ZXN0Ijp7ImNoYWluSWQiOiIweDIxMDUiLCJ0b2tlbkFkZHJlc3MiOiIweDgzMzU4OWZjZDZlZGI2ZTA4ZjRjN2MzMmQ0ZjcxYjU0YmRhMDI5MTMiLCJpc0FzY2VuZGluZ09yZGVyIjpmYWxzZSwibGltaXQiOjEwMH19.v_km4yyARSjeQw_M_E1zaRT9r9qS6GIkMPOPwWOjo_o"
    },
    "meta": {
      "provider": "ting",
      "chain": "base",
      "token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "requestedLimit": 100,
      "matched": 100,
      "scanned": 100,
      "completed": false,
      "partial": false,
      "cached": false,
      "cacheAge": null,
      "pending": false,
      "retryAfterMs": null,
      "source": "ting-holder-index"
    }
  },
  "h402": {
    "routeId": "crypto/token-holders",
    "provider": "ting",
    "selectedCandidateId": "crypto/token-holders/ting",
    "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.

tingdefaultcheapest
x402
100
Success
100%
p50
6.38s
Calls
2
100%
$0.02$0.020/call
nansen
x402
100
Success
100%
p50
3.50s
Calls
4
100%
$0.05$0.050/call
Last successful call: 15d ago· Aggregated by h402 — not the source provider