GateData.AI

Token holders

Query holder distribution and concentration.

GET/api/v1/onchain/holders
Domain
Flows & Wallets
Level
Crypto asset
MCP tool
ownership_flows_query (task=holders)

Available data

Returns
Holder distribution and concentration
Market coverage
Major EVM chains and Solana
Query granularity
One token per query; other tokens are not mixed in

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Token positioning

Provide deployment_id, chain + token_address, or one of query, ticker, symbol, and asset_id.

querystringqueryExampleBTCconditional

Token name, symbol, or contract address.

tickerstringqueryExampleBTCconditional

Token ticker.

symbolstringqueryExampleBTCconditional

Token symbol.

asset_idstringqueryExampleasset_btcconditional

Canonical asset ID.

deployment_idstringqueryExampledeployment_solana_tokenconditional

On-chain deployment ID.

chainstringqueryExamplesolanaconditional

Chain code; required with token_address.

token_addressstringqueryExample6Hebn672FvMSq61mo4HYq86QgLHgBUm6y8A9bXGppumpconditional

Token contract address; provide with chain.

Filters

All optional.

tagstringqueryExamplewhaleoptional

Filter by wallet tag.

wallet_namestringqueryExamplesmart_moneyoptional

Filter by wallet name.

min_balancenumberqueryExample1000optional

Minimum token balance.

min_holding_value_usdnumberqueryExample10000optional

Minimum holding value in USD.

last_trade_time_gtedatetimequeryExample2026-01-01T00:00:00Zoptional

Earliest latest-trade time.

sort_bystringqueryExamplebalanceoptional

Sort field.

order_directionstringqueryExampledescoptional

Sort direction.

include_summarybooleanqueryExampletrueoptional

Whether to include concentration summary.

Pagination

All optional.

pageintegerqueryExample1optional

Page number, starting at 1.

page_sizeintegerqueryExample20optional

Rows per page.

Response

assetobject

Resolved on-chain token

asset_idstring | null

Canonical asset and deployment IDs

deployment_idstring | null

Canonical asset and deployment IDs

chainstring | nullExamplesolana

Chain, contract address, and symbol

token_addressstring | nullExample6Hebn672FvMSq61mo4HYq86QgLHgBUm6y8A9bXGp…

Chain, contract address, and symbol

symbolstring | null

Chain, contract address, and symbol

items[]object[]

Holder rows

addressstring / integerExample9xQeWvG816bUx9EPf...

Wallet address and holder rank

rankstring / integerExample1

Wallet address and holder rank

balancedecimal string | nullExample1250000.50

Token balance and USD holding value

holding_value_usddecimal string | nullExample184500.25

Token balance and USD holding value

wallet_namestring | null / string[]

Wallet name and labels

tags[]string | null / string[]Examplewhale

Wallet name and labels

last_trade_timedatetime | null / integer | nullExample2026-09-18T06:30:00Z

Latest trade time

last_trade_timestampdatetime | null / integer | nullExample1789713000

Latest trade time

summaryobject

Holder count, supply, and concentration summary

data_statusDataStatusExamplepartial

Data availability status

pageintegerExample1

Current page and page size

page_sizeintegerExample20

Current page and page size

metadataobject

Task, completeness, limitations, and update time

object_refs[]object[]

Unified object references

request_idstringExamplereq_docs_holders

Request trace ID

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.