# GET /v4/analytics/beneficial-owners/holders

_Merkl Analytics API_

> Flat beneficial-owner mapping for a token

Who owns how much of `token`, including value held indirectly through vaults, markets, gauges and LP positions. The ownership graph reduced by owner: an address holding the asset through several routes appears once, summed. `at` is required — there is no implicit latest snapshot. `409 SNAPSHOT_NOT_INDEXED` when any source in the graph is not indexed up to `at`; the response then also carries `available` (the latest `at` that would succeed now) and `lagSeconds`. `403` when any node in the graph holds confidential balances the caller may not read.

### Query parameters

- `chainId` (string | number) _(required)_
- `token` (string) _(required)_
- `at` (string | number) _(required)_
- `minAmount` (string)

## Responses

- **200** Response for status 200

## Example request

```bash
curl -X GET "https://analytics.merkl.xyz/v4/analytics/beneficial-owners/holders?chainId=<chainId>&token=<token>&at=<at>" \
  -H "x-api-key: YOUR_API_KEY"
```