Live on-chain balances for a customer
Returns live, freshly-read on-chain balances for every derived address of the customer wallet — native coin plus supported stablecoins (USDT/USDC where applicable).
Unlike GET /addresses (which serves cached balances and, with ?refresh=true, also runs
deposit-detection, webhooks and email), this endpoint reads straight from the chain with no
side effects — nothing is written and no notifications fire — so the numbers are always current.
Each balance reports the genuinely-spendable amount:
- XRP:
spendableexcludes the locked ~1 XRP base reserve. - BTC / LTC / BCH:
spendableandconfirmedcount confirmed UTXOs only;balancemay include unconfirmed (0-conf) funds. - All other networks:
spendableequalsbalance.
Authorizations
Business API key for server-to-server integrations.
Key prefix determines the environment — no separate flag needed:
test_sk_* = sandbox/testnet, live_sk_* = production/mainnet.

