Coins
coins.holdersAt
The top holders of a coin at a past time or checkpoint.
Details
- Endpoint
- GET /v1/coins/:type/holders-at
- Credits
- 25
- Rate class
- Heavy. Counts against your heavy requests per second.
Returns the largest holders of a coin at the end of a checkpoint, found by adding up every balance change of the coin per owner. Pass exactly one of time, datetime or checkpoint. It works for coins with up to about 5 million balance changes before that point; bigger coins such as SUI or USDC are refused with invalid_params until the daily holder snapshots ship (phase 2). Each holder carries its share of the supply held by wallets at that point. Use /v1/coins/{type}/holders for the live list.
Parameters
| Name | Type | Description |
|---|---|---|
| typerequired | string | Coin type such as 0x...::mod::NAME. |
| time | integer | Point in time as unix seconds. Give exactly one of time, datetime or checkpoint. |
| datetime | string | Point in time as an ISO 8601 date, UTC when no zone is given, for example 2025-01-10 19:20:00. |
| checkpoint | integer | Checkpoint sequence number. Alias: slot. |
| limit | integer | Holders to return, default 50.From 1 to 500. |
Request
Send your key in the x-api-key header, or leave it out to use the keyless tier.
curl
curl "https://api.tide.ad/v1/coins/0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270%3A%3Adeep%3A%3ADEEP/holders-at?datetime=2026-10-01%2000:00:00&limit=10" \
-H "x-api-key: YOUR_API_KEY"TypeScript
const res = await fetch("https://api.tide.ad/v1/coins/0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270%3A%3Adeep%3A%3ADEEP/holders-at?datetime=2026-10-01%2000:00:00&limit=10", {
headers: {
"x-api-key": process.env.TIDE_API_KEY!,
},
});
const data = await res.json();Response
No example response is available for this method yet.