Merkl Developer Portal logo
get

/v4/analytics/beneficial-owners/holders

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

chainIdnumber | string
required
tokenstring
required
atnumber | string
required
minAmountstring

Responses

200
Response for status 200
Schema
object
assetobject
required
chainIdnumber
required
addressstring
required
symbolstring
required
decimalsnumber
required
atnumber
required
totalstring
required
holderCountnumber
required
holdersobject[]
required
ownerstring
amountstring
sharestring
Example
{
  "asset": {
    "chainId": 0,
    "address": "string",
    "symbol": "string",
    "decimals": 0
  },
  "at": 0,
  "total": "string",
  "holderCount": 0,
  "holders": [
    {
      "owner": "string",
      "amount": "string",
      "share": "string"
    }
  ]
}