Skip to navigation

List account balances

Lists the organisation’s account balances — the latest reading per account and asset, as the venue last stated it; accountId narrows to one account’s. A DISCOVERED account’s balances are served while it is being classified. Rows are ordered by accountId then assetId; a view other than latest is 400. A member deployed without the surface answers 503 BALANCES_UNAVAILABLE.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

accountIdintegerOptional>=1

Only one account's balances — the accountId its rows carry and GET /accounts serves. An account outside your organisation, or one this member does not hold, yields an empty collection, like an account with no reading; 0, a negative or a non-integer refuses 400.

Response

Every reading inside the principal's org, account then asset ascending; the projection position rides the body and the header.

globalSequencestringformat: "^[0-9]+$"

The position as a decimal string — the last change this member had applied, orders and balance readings included.

itemslist of objects
unscaledbooleanOptionalDeprecated

Never present since 0.3.1: a balance states its own scale, so no item is ever served raw. Kept, deprecated, so a client generated from 0.3.0 still compiles.

Errors

400
List Account Balances Request Bad Request Error
401
List Account Balances Request Unauthorized Error
403
List Account Balances Request Forbidden Error
503
List Account Balances Request Service Unavailable Error