---
title: "Get Token Holders"
method: GET
path: "/v0/tokens/holders/{chain}/{token_address}"
tags: ["v0"]
---

# Get Token Holders

`GET /v0/tokens/holders/{chain}/{token_address}`

## Path parameters

- `chain` 'eth' | 'base' | 'solana' | 'tron' | 'bsc' | 'sonic' | 'ton' | 'avalanche' | 'polygon' | 'monad' | 'hyperevm' | 'arbitrum' | 'robinhood', required
- `token_address` string, required

## Query parameters

- `limit` 80 | 250 | 500
- `timestamp` integer, nullable
- `refresh` boolean
- `return_metadata` boolean

## Response `200`

Successful Response

- TokenHolderV0[]
  - `address` string, required
  - `address_details` AccountAddressDetails
    - `label` string, nullable
    - `degree` integer, required
    - `is_supernode` boolean, required
    - `is_contract` boolean, required
    - `is_cex` boolean, required
    - `is_dex` boolean, required
    - `is_paid_label` boolean
    - `entity_id` string, nullable
    - `inward_relations` integer, required
    - `outward_relations` integer, required
    - `first_activity_date` string, date-time, nullable
  - `holder_data` HolderData, required
    - `amount` number, required
    - `rank` integer, required
    - `share` number, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/bubblemaps/apis/bubblemaps-data-api.md) · [All operations](https://skmtc.dev/bubblemaps/apis/bubblemaps-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bubblemaps/bubblemaps-data-api/revisions/38ef31a552be/schema)