v1

latestOpenAPI 3.1.0MIT License2026-07-17107133186.6 KB
assets

Asset balance distribution at height

Get asset balance distribution by addresses at a given height. Max number of addresses is set by waves.rest-api.distribution-address-limit, 1000 by default. For pagination, use the field {after}

get/assets/{assetId}/distribution/{height}/limit/{limit}

Path parameters

assetIdstring required
Example:DG2xFkPdDwKUoBkzGAhQtLpSGzfXLiCYPEzeKH2Ad24p

Asset ID base58 encoded

heightinteger required

For balance at height requests. Max number of blocks back from the current height is set by waves.rest-api.distribution-address-limit, 1000 by default

limitinteger required

Number of addresses to be returned

Query parameters

afterstring

Address to paginate after

Response

successful operation

hasNextboolean required
lastItemstring
{"stackTrail":"components:schemas:AssetDistribution:properties:items","oasType":"schema","type":"unknown","description":"map of assetId <-> balance","example":{"2eEUvypDSivnzPiLrbYEW39SM8yMZ1aq4eJuiKfs4sEY":15,"3PPqZ623dAfbmxmnpTjwV6yD5GA5s3PJiUG":25}}

Example response

{
  "lastItem": "3P274YB5qseSE9DTTL3bpSjosZrYBPDpJ8k",
  "items": {
    "2eEUvypDSivnzPiLrbYEW39SM8yMZ1aq4eJuiKfs4sEY": 15,
    "3PPqZ623dAfbmxmnpTjwV6yD5GA5s3PJiUG": 25
  }
}