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
  }
}

Changes

Changed in 2 of the 36 revisions of this API.325

Mar 23, 202326c5120a809c23See the full diff
- ▲
  removed the required property last from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property values from the response with the 200 status
  response-required-property-removed
- ○
  added the media type application/json;large-significand-format=string for the response with the status 200
  response-media-type-added
- ○
  added the optional property items to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property lastItem to the response with the 200 status
  response-optional-property-added
May 27, 2021c901f97e3a8d122See the full diff
- ▲
  removed the media type application/json;large-significand-format=string for the response with the status 200
  response-media-type-removed
- ●
  removed the optional property items from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property lastItem from the response with the 200 status
  response-optional-property-removed
- ○
  added the required property last to the response with the 200 status
  response-required-property-added
- ○
  added the required property values to the response with the 200 status
  response-required-property-added
This revision also has 63 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history