跳转到主要内容
GET
代币 - 大户
获取按余额排名的代币顶级持有者。适用于持币集中度分析和巨鲸追踪。
相关: GraphQL 持有者 | MCP: token_get_top_holders

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

路径参数

chain
enum<string>
必填

支持网络列表中的链名称 Supported blockchain chains

可用选项:
sol,
eth,
bsc
tokenAddress
string
必填

代币地址

查询参数

cursor
string

分页游标

limit
integer<int64>
默认值:20

每页返回结果数量

direction
enum<string>
默认值:next

分页方向(next 或 prev) Pagination direction

可用选项:
next,
prev
sortBy
enum<string>

DTO.TOKEN.HOLDERS.SORT_BY Sort by: amountPercentage (default) | holdingUsd | usdValue | totalPnl | realizedPnl | unrealizedPnl | buyVolume | sellVolume | netflowUsd | lastActiveAt | createdAt Sort field for token holders query

可用选项:
amountPercentage,
holdingUsd,
usdValue,
totalPnl,
realizedPnl,
unrealizedPnl,
buyVolume,
sellVolume,
netflowUsd,
lastActiveAt,
createdAt
sortDirection
enum<string>

Sort direction: desc (default) | asc Sort direction (case-insensitive: accepts "asc"/"ASC"/"Asc" etc.)

可用选项:
asc,
desc
tag
enum<string>

Filter by wallet tag: smart | kol | sniper | dev | bundle | bluechip | fresh | insider | pro | sandwich | phishing Token trader tag

可用选项:
smart,
kol,
sniper,
dev,
bundle,
bluechip,
fresh,
insider,
pro,
sandwich,
phishing
minCostUsd
string

Minimum position cost in USD (inclusive). Filters out holders whose open position cost is below this threshold. Maps to OpenSearch field position_cost_in_usd.

响应

200 - application/json

获取大户

Generic pagination response

data
object[]
必填

Page data

endCursor
string | null

Cursor for the end of current page

示例:

"eyJpZCI6ImVuZCJ9"

hasNext
boolean

Whether there is a next page

示例:

false

hasPrev
boolean

Whether there is a previous page

示例:

false

startCursor
string | null

Cursor for the start of current page

示例:

"eyJpZCI6InN0YXJ0In0="

total
integer<int64> | null

Total number of items matching the query (not just the current page). When None, the caller should treat it as unknown (backward-compatible).

示例:

564094