# Holder snapshot > Holders as they were at a past point, valued at that moment's price. Holder snapshot on Robinhood Chain: parameters, plan, credits, code and a real response. Source: https://docs.crius.sh/reference/holders/holder-snapshot/ · Updated 2026-10-28 GET https://api.crius.sh/v1/{chain}/token/{address}/holders/snapshot Holders **as they were at a past point**, valued at that moment's price. `compare_to=now` adds each holder's balance change since then, which answers "who bought before $50k market cap, and are they still holding?". > Valued at that moment's price; compare\_to=now adds change per holder. ## Path parameters `chain`stringrequired Chain slug (`robinhood`) or chain id (`4663`). `address`stringrequired Contract or wallet address, any case (`0x…`, 20 bytes). ## Query parameters `at`string Default `trading_open` The point in time to look at (see the forms above). One of `block:N`, `ts:MS`, `mcap:USD`, `launch`, `trading_open`, `graduation`, `ath`, `now`. `mcap_crossing`string Default `first` Which crossing of the market cap level to use. One of `first`, `last`. `compare_to`string Default `now` Add each holder's change since another point (`now` or any `at` form). `exclude`string Comma list of holder classes to leave out, such as `infra` (pools, lockers, burn) or `bots`. `min_usd`number Only items worth at least this many USD. `min_pct`number Minimum share of supply, in percent. `tag`string Only wallets with this tag (`sniper`, `bot`, `whale`, `fresh`, `dev`, `insider`, `bundler`, `top_trader`). `limit`integer Default `100` Maximum number of items to return. `cursor`string Pagination cursor from the previous response's `meta.next_cursor`. ## Guides that use this endpoint [**Get the holders of a Robinhood Chain token (token holders API)**Robinhood Chain token holders API: get any token's top holders in one call, with balance, share of supply, USD value, labels, holder count and top-10 share.](https://docs.crius.sh/guides/get-token-holders/)[**Get a token's holders at a past block, time or market cap**Get a Robinhood Chain token's holders at any past block, time, market cap or launch stage, valued at that moment's price, with cost basis per holder.](https://docs.crius.sh/guides/get-historical-holders/)[**Find holders who held through a run (holder cohorts)**Find wallets that bought a Robinhood Chain token early and held through the run, with hold time, entry market cap, sells and PnL per wallet. Real example.](https://docs.crius.sh/guides/find-diamond-hand-holders/)[**What is the best Robinhood Chain data API? How to choose one**How to choose a Robinhood Chain data API: nine criteria, from launchpads and realized taxes to WebSockets and free plans, and a sourced provider comparison.](https://docs.crius.sh/guides/choose-a-robinhood-chain-data-api/) ## Errors Errors come back as `{ "error": { "code", "message" } }` with the matching HTTP status: `400` bad parameter, `401` missing or invalid key, `403` endpoint above your plan, `404` unknown token or address, `429` rate limit or credits used up (with `Retry-After`). See [Errors](https://docs.crius.sh/errors/). ## More holders & traders endpoints [GET/token/{address}/holdersLive holdersFree · 2 cr](https://docs.crius.sh/reference/holders/live-holders/)[GET/token/{address}/holders/cohortHolder cohortStarter · 10 cr](https://docs.crius.sh/reference/holders/holder-cohort/)[GET/token/{address}/holders/historyHolder count historyStarter · 10 cr](https://docs.crius.sh/reference/holders/holder-count-history/)[GET/token/{address}/tradersTop tradersFree · 5 cr](https://docs.crius.sh/reference/holders/top-traders/) Request Needs a Free key **cURL** ```bash curl "https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/holders/snapshot?at=mcap%3A50000&compare_to=now&exclude=infra" \ -H "x-api-key: $CRIUS_API_KEY" ``` **JavaScript** ```js const res = await fetch("https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/holders/snapshot?at=mcap%3A50000&compare_to=now&exclude=infra", { headers: { "x-api-key": process.env.CRIUS_API_KEY }, }); const { data, meta } = await res.json(); ``` **Python** ```python import os, requests r = requests.get( "https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/holders/snapshot?at=mcap%3A50000&compare_to=now&exclude=infra", headers={"x-api-key": os.environ["CRIUS_API_KEY"]}, ) body = r.json() print(body["data"]) ``` Response 200 · captured Oct 28, 2026 ```json { "data": { "distribution": { "top10_ex_infra_pct": 20.2394, "top10_incl_infra_pct": 88.256, "top10_pct": 20.2394 }, "history": "complete", "holders": [ { "address": "0x8366a39cc670b4001a1121b8f6a443a643e40951", "balance": 599611856.72294939695548577, "cost_basis_usd": null, "label": "uniswap_v4_pool_manager", "pct": 59.9612, "rank": 1, "tags": [ "pool" ], "unrealized_pnl_usd": null, "value_eth": 1.4505, "value_usd": 3617.23 }, { "address": "0x267444d099b10fb5ed7c3cc7b7c767adca574952", "balance": 81632653.061224486519511236, "cost_basis_usd": null, "label": "pons_v2_launch_locker", "pct": 8.16327, "rank": 2, "tags": [ "lp_locker" ], "unrealized_pnl_usd": null, "value_eth": 0.197474, "value_usd": 492.459 }, { "address": "0xcae68632857541d7b625f5af57149a77c80b15f7", "balance": 40394446.124537182821971423, "cost_basis_usd": 437.688, "label": null, "pct": 4.03944, "rank": 3, "tags": [ "smart_account", "fomo" ], "unrealized_pnl_usd": -194.003, "value_eth": 0.0977165, "value_usd": 243.684 }, { "address": "0xe683eb5c66b0c55c54ce45d46a3bf0a69d809c8f", "balance": 29879481.370714222341354462, "cost_basis_usd": 515.975, "label": null, "pct": 2.98795, "rank": 4, "tags": [ "smart_account" ], "unrealized_pnl_usd": -335.724, "value_eth": 0.0722802, "value_usd": 180.252 }, { "address": "0x000000000000000000000000000000000000dead", "balance": 29840058.774195638068253872, "cost_basis_usd": null, "label": "burn", "pct": 2.98401, "rank": 5, "tags": [ "burn" ], "unrealized_pnl_usd": null, "value_eth": 0.0721848, "value_usd": 180.014 } ], "holders_count": 203, "price_at_snapshot": { "eth": 0.00000000241906, "eth_usd": 2493.79, "usd": 0.00000603262 }, "snapshot": { "at": "ts:1792620279327", "block": 94616288, "ts": 1792620279800 }, "token": "0x7b8892cea949bc60d494681d1bc3ea96071ab0b8", "total_value_usd": 6032.62 }, "meta": { "block": 100406812, "block_age_ms": 701, "block_ts": 1793225079000, "chain": "robinhood", "finalized_block": 100397649, "lag_ms": 38, "next_cursor": "5", "safe_block": 100401329 } } ``` [Get a key for this endpoint](https://dashboard.crius.sh/signup?ref=docs-endpoint) [Report an issue](mailto:support@crius.sh?subject=Docs%20issue%3A%20GET%20%2Fv1%2F%7Bchain%7D%2Ftoken%2F%7Baddress%7D%2Fholders%2Fsnapshot&body=Page%3A%20https%3A%2F%2Fdocs.crius.sh%2Freference%2Fholders%2Fholder-snapshot%2F%0A%0AWhat's%20wrong%20or%20missing%3F%0A%0A)