The Balance object
The shape of a balance wherever the API returns one.
Every endpoint that returns a balance returns this shape, wrapped in a data envelope.
Attributes
currency
string · always presentThe asset code - BTC, USDT, USDC.
decimals
integer · always presentAlways published. It is what makes amount_minor interpretable, and zero-decimal currencies are a real trap elsewhere in this API.
amount
string · always presentThe main field. A decimal string with exactly decimals places, never trimmed - so it fails loudly if something parses it as an integer, which amount_minor would not.
amount_minor
string · always presentThe same figure in minor units. Use this for arithmetic.
{
"currency": "USDT",
"decimals": 6,
"amount": "120.500000",
"amount_minor": "120500000"
}Balances
What the project's wallet holds, per asset.
List balances
The project's per-asset wallet balances. Not paginated - the set is the asset catalog, and assets at zero are included. This is the authority for balance. Summing the transaction feed gives a different, wrong number: a failed payment is one row there with zero balance impact.