# Get top token holders by pricing ID

Returns top token holders for the token identified by its CoinGecko pricing ID.

Endpoint: GET /token/holders/{pricing_id}
Version: 1.0.0
Security: ApiKeyAuth

## Path parameters:

  - `pricing_id` (string, required)
    The CoinGecko pricing ID (e.g., "bitcoin", "ethereum").

## Query parameters:

  - `groupByEntity` (boolean)
    If true, group results by entity.

## Response 200 fields (application/json):

  - `token` (object)
    Basic token intelligence data

  - `token.identifier` (object)

  - `token.identifier.pricingID` (string)
    Example: "bitcoin"

  - `token.name` (string)
    Example: "Bitcoin"

  - `token.symbol` (string)
    Example: "btc"

  - `token.tvTicker` (string,null)
    Example: "BINANCE:BTCUSDT"

  - `totalSupply` (object)

  - `holders` (object)

## Response 400 fields (application/json):

  - `error` (string)
    Example: "Bad request"

## Response 401 fields (application/json):

  - `error` (string)
    Example: "API key missing or invalid"