Skip to main content
GET
トークン - 保有者
トークンのホルダー一覧と残高を取得します。上位のホルダーのみを取得したい場合は、topHolders エンドポイントを利用してください。
関連: GraphQL ホルダー | MCP: token_get_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