토큰 - 상위 홀더

토큰의 상위 20명 홀더 조회

GET /v2/token/{chain}/{tokenAddress}/topHolders

토큰 - 상위 홀더

cURL

curl --request GET \
  --url https://api.chainstream.io/v2/token/{chain}/{tokenAddress}/topHolders \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "amount": "1000000000000000000",
      "amountInUsd": "1000000000000000000",
      "percentage": "100",
      "walletAddress": "0x1234567890abcdef"
    }
  ],
  "endCursor": "eyJpZCI6ImVuZCJ9",
  "hasNext": false,
  "hasPrev": false,
  "startCursor": "eyJpZCI6InN0YXJ0In0="
}

잔액 기준으로 정렬된 상위 토큰 홀더를 가져옵니다. 보유 집중도 분석과 고래 추적에 유용합니다.

관련: GraphQL 홀더 | MCP: token_get_top_holders

인증

bearer_authapi_key_auth

Authorization · string · header · 필수

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

경로 매개변수

chain · enum<string> · 필수

지원되는 네트워크에 나열된 체인 이름 지원되는 블록체인

사용 가능한 옵션: sol, eth, bsc

tokenAddress · string · 필수

토큰 주소

쿼리 매개변수

cursor · string

페이지네이션 커서

limit · integer<int64> · 기본값: 20

페이지당 결과 수

direction · enum<string> · 기본값: next

페이지네이션 방향

사용 가능한 옵션: next, prev

응답

200 - application/json

상위 홀더 조회

범용 페이지네이션 응답

data · object[] · 필수

페이지 데이터

Show child attributes

endCursor · string | null

현재 페이지 끝 커서

예시:

"eyJpZCI6ImVuZCJ9"

hasNext · boolean

다음 페이지 존재 여부

예시:

false

hasPrev · boolean

이전 페이지 존재 여부

예시:

false

startCursor · string | null

현재 페이지 시작 커서

예시:

"eyJpZCI6InN0YXJ0In0="