> ## 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.

# Asset balance (ADA)

> Aggregate token balance in ADA for addresses

Returns an aggregate **balance in ADA** for a given asset across a **non-empty** list of payment key hashes. The response may be **`null`** when there is no balance data.

**Auth:** Public

POST requests must send **`Content-Type: application/json`**.

## Query parameters

<ParamField query="assetId" type="string" required>
  Cardano asset ID (`policyId.hexAssetName`).
</ParamField>

## Request body

JSON array of **56-character hex** payment key hashes (at least one element).

## Response

`200` with a JSON object or **`null`**.

<ResponseField name="balance" type="number">
  Aggregate balance expressed in ADA (JSON number).
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url "https://analytics.snek.fun/balances/v1/asset/asset-balance?assetId=fbd4d3c334063ac19566f6ba39b6ec707ea91fa81d0c09201575c10b.44415645" \
    --header "Content-Type: application/json" \
    --data '["e62df682e62df682e62df682e62df682e62df682e62df682e62df682e62df682e62"]'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "balance": 123.456789
  }
  ```
</ResponseExample>