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

# Pool holders

> Paged holders and dev balance for a token

Returns a paginated list of holder addresses sorted by balance (descending), the developer (pool author) balance, and a total holder count.

**Auth:** Public

## Query parameters

<ParamField query="assetId" type="string" required>
  Cardano asset ID: `policyId` + `.` + hex-encoded asset name (see [Asset ID](/api-reference/overview#asset-id)).
</ParamField>

<ParamField query="limit" type="integer">
  Page size. Maximum **101** (enforced by the server).
</ParamField>

<ParamField query="offset" type="integer">
  Offset for pagination (0-based).
</ParamField>

## Response

<ResponseField name="holders" type="object[]">
  Holder rows, sorted by balance descending.

  <Expandable title="properties">
    <ResponseField name="address" type="string">
      Payment key hash (56-character hex) for the holder.
    </ResponseField>

    <ResponseField name="quantity" type="string">
      Token quantity for that address (stringified integer).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="dev" type="object">
  Developer / pool author balance for the asset (same shape as one `holders` element).

  <Expandable title="properties">
    <ResponseField name="address" type="string">
      Public key hash string for the dev wallet.
    </ResponseField>

    <ResponseField name="quantity" type="string">
      Token quantity for the dev wallet.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="count" type="integer">
  Total number of unique holders for the asset.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url "https://analytics.snek.fun/balances/v1/pool/holders?assetId=fbd4d3c334063ac19566f6ba39b6ec707ea91fa81d0c09201575c10b.44415645&limit=20&offset=0"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "holders": [
      { "address": "e62df682e62df682e62df682e62df682e62df682e62df682e62df682e62df682e62", "quantity": "1000000" }
    ],
    "dev": { "address": "41fa17b241fa17b241fa17b241fa17b241fa17b241fa17b241fa17b241fa17b241", "quantity": "500000" },
    "count": 42
  }
  ```
</ResponseExample>