---
title: "Asset balances"
method: POST
path: "/assets/balance/{address}"
tags: ["assets"]
---

# Asset balances

`POST /assets/balance/{address}`

Get account balances in specified assets (excluding WAVES) at a given address

## Path parameters

- `address` string, required

## Request body

- object
  - `ids` AssetId[]

## Response `200`

successful operation

- AssetBalancesResponse
  - `address` string, required
  - `balances` AssetBalanceAndDetails[], required
    - `assetId` string, required
    - `balance` integer, required — Account balance in the asset
    - `reissuable` boolean, required — Indicates if the asset is reissuable
    - `minSponsoredAssetFee` integer — For [sponsored asset](https://docs.waves.tech/en/blockchain/waves-protocol/sponsored-fee) only: the equivalent of 0.001 WAVES
    - `sponsorBalance` integer — For [sponsored asset](https://docs.waves.tech/en/blockchain/waves-protocol/sponsored-fee) only: the sponsor balance in WAVES
    - `quantity` integer, required — Total supply of the asset
    - `issueTransaction` IssueTransaction
      - `assetId` string, required
      - `name` string, required
      - `quantity` integer, required
      - `reissuable` boolean, required
      - `decimals` integer, required
      - `description` string, required
      - `script` string, byte, required

## Changes

> 36 revisions in range; 1 could not be searched.

- **2026-03-31** `d9769537f2c3` — 4 breaking, 1 info
  - the response property `balances/items/issueTransaction` became optional for the status `200`
  - the response property `balances/items/minSponsoredAssetFee` became optional for the status `200`
  - the response property `balances/items/sponsorBalance` became optional for the status `200`
  - the `balances/items/assetId` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - …1 more
- **2021-10-29** `b7734edf6ea8` — 2 info
  - added `#/components/schemas/AssetId` to the `balances/items/issueTransaction/assetId` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/Hash` from the `balances/items/issueTransaction/assetId` response property `allOf` list for the response status `200`
- **2021-09-20** `4dc5efb35d2e` — 1 info
  - endpoint added
- **2021-05-27** `c901f97e3a8d` — 1 breaking
  - api removed without deprecation

[Change history](https://skmtc.dev/wavesplatform/apis/waves-full-node-chainid/changes/assets/balance/:address/post.md)

---

[API](https://skmtc.dev/wavesplatform/apis/waves-full-node-chainid.md) · [All operations](https://skmtc.dev/wavesplatform/apis/waves-full-node-chainid/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wavesplatform/waves-full-node-chainid/revisions/09465bcdf6ce/schema)