Skip to main content
GET
/
v2
/
tokens
/
top-holders
Get top holders for a token
curl --request GET \
  --url https://api.range.org/v2/tokens/top-holders \
  --header 'Authorization: Bearer <token>'
{
  "token": "<string>",
  "network": "<string>",
  "items": [
    {
      "rank": 123,
      "address": "<string>",
      "balance": 123,
      "pct_of_supply": 123,
      "is_contract": true,
      "is_multisig": true,
      "name_tag": "<string>",
      "category": "<string>",
      "entity": "<string>",
      "num_sends": 123,
      "num_receives": 123,
      "unique_senders": 123,
      "unique_receivers": 123,
      "address_role": "<string>",
      "malicious": true
    }
  ],
  "meta": {
    "next_cursor": "eyJpZCI6IjkxeFFlV3Z...",
    "previous_cursor": "eyJpZCI6IjkxeFFlV3Z...",
    "first_page_cursor": "eyJpZCI6IjkxeFFlV3Z...",
    "last_page_cursor": "eyJpZCI6IjkxeFFlV3Z...",
    "total_count": 100,
    "page_number": 1
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.range.org/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Use Authorization: Bearer

Query Parameters

token
string
required

Token symbol or identifier (e.g. USDtb)

network
string
required

Network name (e.g. eth)

size
number
default:100

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

Required range: 1 <= x <= 1000
cursor
string

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

Response

200 - application/json
token
string
required
network
string
required
items
object[]
required
meta
object
required
Last modified on May 15, 2026