代币持有人
查询代币持仓分布与集中度。
GET/api/v1/onchain/holders
可查询数据
- 返回数据
- 代币持仓分布与集中度
- 市场覆盖
- 主流 EVM 链、Solana
- 查询粒度
- 每次查询一个代币，不合并其他代币
认证
所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。
请求参数
代币定位
填写 deployment_id，或同时填写 chain + token_address，或填写 query / ticker / symbol / asset_id 中任意一项。
querystringquery示例BTC条件必须查询关键词、代码或名称。
tickerstringquery示例BTC条件必须资产代码。
symbolstringquery示例BTC条件必须资产代码。
asset_idstringquery示例asset_btc条件必须资产标识，标识股票、加密资产等资产对象
deployment_idstringquery示例deployment_solana_token条件必须链上部署 ID。
chainstringquery示例solana条件必须区块链代码。
token_addressstringquery示例6Hebn672FvMSq61mo4HYq86QgLHgBUm6y8A9bXGppump条件必须代币合约地址。
筛选条件
均为可选。
tagstringquery示例whale可选按钱包标签筛选。
wallet_namestringquery示例smart_money可选按钱包名称筛选。
min_balancenumberquery示例1000可选最低代币余额。
min_holding_value_usdnumberquery示例10000可选最低美元持仓价值。
last_trade_time_gtedatetimequery示例2026-01-01T00:00:00Z可选最近交易时间下限。
sort_bystringquery示例balance可选排序字段。
order_directionstringquery示例desc可选排序方向。
include_summarybooleanquery示例true可选是否返回集中度汇总。
分页
均为可选。
pageintegerquery示例1可选页码，从 1 开始。
page_sizeintegerquery示例20可选每页条数。
响应
assetobject
已解析的链上代币
asset_idstring | null资产标识，标识股票、加密资产等资产对象
deployment_idstring | null标准资产与部署 ID
chainstring | null示例solana链、合约地址与代码
token_addressstring | null示例6Hebn672FvMSq61mo4HYq86QgLHgBUm6y8A9bXGp…链、合约地址与代码
symbolstring | null链、合约地址与代码
items[]object[]
持有人列表
addressstring / integer示例9xQeWvG816bUx9EPf...钱包地址与持仓排名
rankstring / integer示例1钱包地址与持仓排名
balancedecimal string | null示例1250000.50代币余额与美元持仓价值
holding_value_usddecimal string | null示例184500.25代币余额与美元持仓价值
wallet_namestring | null / string[]钱包名称与标签
tags[]string | null / string[]示例whale钱包名称与标签
last_trade_timedatetime | null / integer | null示例2026-09-18T06:30:00Z最近交易时间
last_trade_timestampdatetime | null / integer | null示例1789713000最近交易时间
summaryobject持有人数量、供应量与集中度汇总
数据可用状态
pageinteger示例1当前页与每页条数
page_sizeinteger示例20当前页与每页条数
metadataobject
任务、完整性、限制与更新时间
object_refs[]object[]统一对象引用数组
request_idstring示例req_docs_holders请求追踪 ID
错误与降级
200
assets_resolve 名称多命中；从 data[] 候选确认。
200
对象已解析但无可用数据；empty_reason 可为 not_covered_by_source / unsupported_metric / limited_depth。
400
参数无效，或行情 listing 多命中；歧义响应含 required_params + candidates。
401
缺少 API Key，或 Key 无效。
403
当前 Key 的 scope 或套餐无权访问该数据域。
404
请求的资源不存在；数据源不覆盖不归入 404。
402
Credits 或月度额度耗尽。
429
请求频率超限；body 返回 retry_after，响应头同步返回 Retry-After。