Token Holders Over Time
Returns a list of accounts holding a specific token (identified by its program ID/mint address) on Solana. It returns snapshots at specified block intervals within a given range: the first block returns the full list of holders, while subsequent blocks only return holders whose balance changed during that interval. Results are sorted by block number (ascending) and then balance (descending) within each block.
Parameters
Responses
Examples
1. Snapshot Token Holders Over a Block Range
Fetch holder balance snapshots for a specific SPL token across a 200,000-block range, sampled every 100,000 blocks.
Response:
2 {
3 "columns": [
4 {
5 "name": "blockNumber",
6 "type": "UInt64"
7 },
8 {
9 "name": "blockTime",
10 "type": "DateTime('UTC')"
11 },
12 {
13 "name": "account",
14 "type": "FixedString(44)"
15 },
16 {
17 "name": "balanceUi",
18 "type": "Float64"
19 },
20 {
21 "name": "balanceRaw",
22 "type": "UInt64"
23 }
24 ],
25 "data": [
26 [
27 395900000,
28 "2026-01-25T19:42:16+00:00",
29 "AgnTi2m37HvVqNbcEzWmooxfRFAVKTo9QZ6NHvJjitew",
30 49639.912345,
31 49639912345
32 ],
33 [
34 395900000,
35 "2026-01-25T19:42:16+00:00",
36 "mVpNmozxcJxpEtSrjcpuREqFkcVVdqGXg4GdJpHvRVp",
37 3606.174917,
38 3606174917
39 ],
40 [
41 395900000,
42 "2026-01-25T19:42:16+00:00",
43 "7beNLayHpdpqNsHhxWnzCkHoN9ASTcMHZoA6yVgkKMSo",
44 403.502152,
45 403502152
46 ],
47 [
48 395900000,
49 "2026-01-25T19:42:16+00:00",
50 "AqD36cHuHeGzNK3AKnn9Sy1uKfRkgs94BG29c5aR5fQ",
51 125.544764,
52 125544764
53 ],
54 [
55 395900000,
56 "2026-01-25T19:42:16+00:00",
57 "8b56iWZqVk15KjcDmcQctUBauHZ5kdhYHXBDxdGqvTn4",
58 110.984518,
59 110984518
60 ],
61 [
62 395900000,
63 "2026-01-25T19:42:16+00:00",
64 "6wh6ymEMEHhx8WmS4LH2RHJM7xGQtN7YZBFQmxpSny7c",
65 49.218273,
66 49218273
67 ],
68 [
69 395900000,
70 "2026-01-25T19:42:16+00:00",
71 "BoEz8VsJtvywEedFYpAveLFRS31i4gBzyB9NPsndgS99",
72 45.241709,
73 45241709
74 ],
75 [
76 395900000,
77 "2026-01-25T19:42:16+00:00",
78 "3xvGv3B8MDbN2hBX25NWSyfTKJTjLoULZU21A42wF2Z7",
79 17.774227,
80 17774227
81 ],
82 [
83 395900000,
84 "2026-01-25T19:42:16+00:00",
85 "FiDAd4pi6jN47QTHdbsaYzBCJwUikYiYSm2LZFXpD3u9",
86 10.296345,
87 10296345
88 ],
89 [
90 395900000,
91 "2026-01-25T19:42:16+00:00",
92 "CGJKkJe1UdBxfnHRES65zuNhEeM9aFnXh1gJG8RZegLE",
93 2.680754,
94 2680754
95 ]
96 ],
97 "rows": 338
98 }
99]
x402 Payment Option
This endpoint supports pay-per-use access via the x402 payment protocol (v2): pay $0.05 USDC per request using blockchain micropayments. No API key required.
Quickstart (Typescript)
2import { ExactEvmScheme } from "@x402/evm/exact/client";
3import { wrapFetchWithPayment } from "@x402/fetch";
4import { privateKeyToAccount } from "viem/accounts";
5const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY as `0x${string}`);
6const client = new x402Client();
7client.register("eip155:*", new ExactEvmScheme(signer));
8const fetchWithPayment = wrapFetchWithPayment(fetch, client);
9const response = await fetchWithPayment(
10 "https://x402.cambrian.org/solana/tokens/holders-over-time"
11);
12const data = await response.json();
Quickstart (Python)
2from eth_account import Account
3from x402 import x402Client
4from x402.http.clients import x402HttpxClient
5from x402.mechanisms.evm import EthAccountSigner
6from x402.mechanisms.evm.exact.register import register_exact_evm_client
7async def main():
8 client = x402Client()
9 account = Account.from_key(os.getenv("EVM_PRIVATE_KEY"))
10 register_exact_evm_client(client, EthAccountSigner(account))
11 async with x402HttpxClient(client) as http:
12 response = await http.get("https://x402.cambrian.org/solana/tokens/holders-over-time")
13 print(response.json())
14asyncio.run(main())
Payment Flow
- Send a normal request to the endpoint (no API key needed)
- Server returns 402 Payment Required with payment details
- The x402 SDK automatically signs a payment authorization with your wallet
- The SDK resubmits the request with the signed payment
- Server verifies payment and returns the API response
The x402 SDK handles steps 2 through 5 automatically.
Network: Base (chain ID 8453) | Currency: USDC | Price: $0.05 per request