v1

latestOpenAPI 3.0.02026-07-26117198177.4 KB

Token Information

Get top holders for a token

Returns top holders ordered by balance from the token-holders index. Only considers the latest snapshot (nonce=1).

get/v2/tokens/top-holders

Query parameters

tokenstring required

Token symbol or identifier (e.g. USDtb)

networkstring required

Network name (e.g. eth)

sizenumber

Max number of holders per page (default 100, max 1000)

cursorstring

Opaque pagination cursor. Use "A" for the first page, "Z" for the last page, or a cursor from a previous response.

Response

tokenstring required

networkstring required

Example response

{
  "meta": {
    "next_cursor": "eyJpZCI6IjkxeFFlV3Z...",
    "previous_cursor": "eyJpZCI6IjkxeFFlV3Z...",
    "first_page_cursor": "eyJpZCI6IjkxeFFlV3Z...",
    "last_page_cursor": "eyJpZCI6IjkxeFFlV3Z...",
    "total_count": 100,
    "page_number": 1
  }
}