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