Balances - Ault Blockchain Public Docs

Get Balances

GET /api/v1/balance

Parameter	Type	Required	Description
`address`	string	yes	Bech32 or EVM hex account address

curl "https://am-api.cloud.aultblockchain.xyz/api/v1/balance?address=ault1..."

Returns free, used, and total dictionaries keyed by currency code, plus a flat per-currency entry at the top level.

{
  "AULT": { "free": "288241.836723361260830223", "used": "0", "total": "288241.836723361260830223" },
  "USDC": { "free": "7953.192574269846524481", "used": "0", "total": "7953.192574269846524481" },
  "free":  { "AULT": "288241.836723361260830223", "USDC": "7953.192574269846524481" },
  "used":  { "AULT": "0", "USDC": "0" },
  "total": { "AULT": "288241.836723361260830223", "USDC": "7953.192574269846524481" },
  "timestamp": null,
  "datetime": null,
  "info": {}
}

Field	Description
`free`	Usable balance
`used`	Held in escrow against resting orders
`total`	`free` plus `used`

An invalid address returns 400 BAD_REQUEST.

Notes

An order rejected for insufficient funds was checked against free, not total.
These are Ault Core balances. Balances on Ault EVM are separate. See Transfer Assets.
For live balance changes, subscribe to the spotState channel on Subscriptions instead of polling.