R
API reference
Tokens

Token holders

Top holders of a token (balance > 0), with honest coverage flags.

GET/token/{addr}/holders
Requires an API key — Authorization: Bearer <API_KEY>. Costs 1 credit per call; rate limits apply per plan.

Headers

Authorizationstringrequired

Bearer <API_KEY> — create a key in your dashboard.

Path parameters

addrstringrequired

Token contract address.

Query parameters

limitintegeroptional

≤ 200.

offsetintegeroptional

Pagination offset.

Response · 200

walletstringoptional

Holder address.

balancenumberoptional

Raw integer balance.

balance_statusstringoptional

NODE_RECONCILED, NEGATIVE_INCOMPLETE, …

Errors

401Missing or invalid API key.
429Plan rate limit exceeded — back off per Retry-After.
GET/token/0x0bd7d308f8e1639fab988df18a8011f41eacad73/holders?limit=25

Request

curl -H "Authorization: Bearer <API_KEY>" \
  "https://data.amonhen.com/app/api/token/0x0bd7d308f8e1639fab988df18a8011f41eacad73/holders?limit=25"

Response · example

[ { "wallet": "0xa7a9…cbc9", "balance": 215000000000000000000, "balance_status": "NODE_RECONCILED" } ]