토큰 - 상위 홀더

GET

token

{chain}

{tokenAddress}

topHolders

토큰 - 상위 홀더

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

{
  "data": [
    {
      "amount": "1000000000000000000",
      "amountInUsd": "1000000000000000000",
      "percentage": "100",
      "walletAddress": "0x1234567890abcdef",
      "accountAddress": "<string>",
      "accuAmount": "<string>",
      "accuCost": "<string>",
      "addrType": 123,
      "addressLabel": "<string>",
      "avgBuyPriceUsd": "<string>",
      "avgCostUsd": "<string>",
      "avgSellPriceUsd": "<string>",
      "buyAmountCur": "<string>",
      "buyVolumeNative": "<string>",
      "buyVolumeUsd": "<string>",
      "createdAt": 123,
      "endHoldingAt": 123,
      "exchange": "<string>",
      "firstBuyTime": 123,
      "historyBoughtCost": "<string>",
      "historyBoughtFee": "<string>",
      "historySoldFee": "<string>",
      "historySoldIncome": "<string>",
      "historyTransferInAmount": "<string>",
      "historyTransferInCost": "<string>",
      "historyTransferOutAmount": "<string>",
      "historyTransferOutFee": "<string>",
      "historyTransferOutIncome": "<string>",
      "isClosed": true,
      "isNew": true,
      "isTransferIn": true,
      "lastActiveAt": 123,
      "lastBlock": 123,
      "lossCount": 123,
      "makerTokenTags": [
        "<string>"
      ],
      "nativeBalance": "<string>",
      "netflowAmount": "<string>",
      "netflowAmountUsd": "<string>",
      "netflowUsd": "<string>",
      "positionCostUsd": "<string>",
      "realizedPnlRatio": "<string>",
      "realizedProfit": "<string>",
      "roi": "<string>",
      "sellAmountCur": "<string>",
      "sellAmountPercentage": "<string>",
      "sellVolumeNative": "<string>",
      "sellVolumeUsd": "<string>",
      "startHoldingAt": 123,
      "tags": [
        "<string>"
      ],
      "tokenTransferIn": "<unknown>",
      "tokenTransferOut": "<unknown>",
      "totalBuyCount": 123,
      "totalCostUsd": "<string>",
      "totalProfit": "<string>",
      "totalSellCount": 123,
      "transferInAmount7d": "<string>",
      "transferInCount": 123,
      "transferOutAmount7d": "<string>",
      "transferOutCount": 123,
      "unrealizedPnlRatio": "<string>",
      "unrealizedProfit": "<string>",
      "walletTagV2": "<string>",
      "winCount": 123
    }
  ],
  "endCursor": "eyJpZCI6ImVuZCJ9",
  "hasNext": false,
  "hasPrev": false,
  "startCursor": "eyJpZCI6InN0YXJ0In0="
}

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

관련: 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>

기본값:holdingUsd

DTO.TOKEN.HOLDERS.SORT_BY Sort by: holdingUsd (default) | lastActiveAt | profit | buyVolume | sellVolume Sort field for token holders query

사용 가능한 옵션:

holdingUsd,

lastActiveAt,

profit,

buyVolume,

sellVolume

tag

string

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

Show child attributes

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="

토큰 - 트레이더태그별 토큰 트레이더 조회 (fresh, sandwish, bundle, sniper, dev, pro, insider)

⌘I

토큰 - 상위 홀더

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

{
  "data": [
    {
      "amount": "1000000000000000000",
      "amountInUsd": "1000000000000000000",
      "percentage": "100",
      "walletAddress": "0x1234567890abcdef",
      "accountAddress": "<string>",
      "accuAmount": "<string>",
      "accuCost": "<string>",
      "addrType": 123,
      "addressLabel": "<string>",
      "avgBuyPriceUsd": "<string>",
      "avgCostUsd": "<string>",
      "avgSellPriceUsd": "<string>",
      "buyAmountCur": "<string>",
      "buyVolumeNative": "<string>",
      "buyVolumeUsd": "<string>",
      "createdAt": 123,
      "endHoldingAt": 123,
      "exchange": "<string>",
      "firstBuyTime": 123,
      "historyBoughtCost": "<string>",
      "historyBoughtFee": "<string>",
      "historySoldFee": "<string>",
      "historySoldIncome": "<string>",
      "historyTransferInAmount": "<string>",
      "historyTransferInCost": "<string>",
      "historyTransferOutAmount": "<string>",
      "historyTransferOutFee": "<string>",
      "historyTransferOutIncome": "<string>",
      "isClosed": true,
      "isNew": true,
      "isTransferIn": true,
      "lastActiveAt": 123,
      "lastBlock": 123,
      "lossCount": 123,
      "makerTokenTags": [
        "<string>"
      ],
      "nativeBalance": "<string>",
      "netflowAmount": "<string>",
      "netflowAmountUsd": "<string>",
      "netflowUsd": "<string>",
      "positionCostUsd": "<string>",
      "realizedPnlRatio": "<string>",
      "realizedProfit": "<string>",
      "roi": "<string>",
      "sellAmountCur": "<string>",
      "sellAmountPercentage": "<string>",
      "sellVolumeNative": "<string>",
      "sellVolumeUsd": "<string>",
      "startHoldingAt": 123,
      "tags": [
        "<string>"
      ],
      "tokenTransferIn": "<unknown>",
      "tokenTransferOut": "<unknown>",
      "totalBuyCount": 123,
      "totalCostUsd": "<string>",
      "totalProfit": "<string>",
      "totalSellCount": 123,
      "transferInAmount7d": "<string>",
      "transferInCount": 123,
      "transferOutAmount7d": "<string>",
      "transferOutCount": 123,
      "unrealizedPnlRatio": "<string>",
      "unrealizedProfit": "<string>",
      "walletTagV2": "<string>",
      "winCount": 123
    }
  ],
  "endCursor": "eyJpZCI6ImVuZCJ9",
  "hasNext": false,
  "hasPrev": false,
  "startCursor": "eyJpZCI6InN0YXJ0In0="
}

Documentation Index

인증

경로 매개변수

쿼리 매개변수

응답