> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobula.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Token Holders (Deprecated)

> Retrieve the top holders of a specific token, including enriched tags for holder addresses, token amounts, total supply share, and USD value.

<Warning>
  **Deprecated** — This endpoint is deprecated and will be removed in a future release. Please use [Get Token Holder Positions](/rest-api-reference/endpoint/token-holder-positions) instead.
</Warning>

### Query Details

This endpoint returns the top token holders for a given asset, along with enriched metadata. You can query by **token name**, **symbol**, or **contract address + blockchain ID**.

**Parameters**

* `asset` *(required)* — Asset name or contract address.
* `symbol` *(optional)* — Token ticker symbol (e.g., `ETH`, `BTC`). The API will attempt to resolve the asset by symbol. **Symbols may be ambiguous**; prefer `asset` as a contract address + `blockchain` for exact results.
* `blockchain` *(required if using address)* — Blockchain identifier (e.g., `1` for Ethereum, `solana` for Solana).
* `limit` — Number of results to return (default: 20).
* `offset` — Pagination offset (default: 0).
* `includeZeroBalance` — Include holders with zero balance (default: false). When enabled, returns historical holders who no longer hold the token.

**Notes**

* If a **contract address** is provided in `asset`, it takes precedence over `symbol`.
* If using `symbol`, results may vary if multiple tokens share the same ticker.

### Usage Examples

```bash theme={null}
# Get top holders for a token by contract address
GET /api/1/market/token/holders?asset=0x...&blockchain=1

# Get top holders for a token by name
GET /api/1/market/token/holders?asset=Bitcoin&limit=50

# Get holders with pagination
GET /api/1/market/token/holders?asset=Ethereum&limit=20&offset=20
```

### Query Response

The response returns a list of token holders with enriched metadata:

* **address** — Wallet address of the holder
* **amountRaw** — Token balance in raw units (before applying decimals)
* **amount** — Token balance in formatted units
* **chainId** — Blockchain identifier (e.g., `ethereum:1`, `solana:solana`)
* **totalSupplyShare** — Percentage of the total token supply held by this address
* **amountUSD** — USD equivalent of the token balance
* **tag** — Enriched label describing the address type (e.g., `dev`, `LP {SYMBOL0}/{SYMBOL1}`, `holder`)