atomic_decimals:
https://api.southpay.io/api/v2.
List balances
GET /balances. Scope balances:read. No parameters.
Response fields
object[]
required
One entry per asset your store holds, sorted by coin symbol.
object[]
required
Cross-chain totals for USDC and USDT. Always exactly two entries in that order, even when you hold none. A zero balance shows as
total_atomic: "0" with atomic_decimals: 6.object
required
Your stablecoin holdings converted to the store’s settlement currency.
settlement_balance counts USDC and USDT only. Non-stablecoin assets such as BTC or ETH appear in balances but contribute nothing to the fiat total.No pagination
This endpoint returns everything in one response. There is nodata wrapper, no meta, no pagination and no page parameter. Balances, payout schedules, webhook endpoints, billing products, prices and subscriptions all behave this way, while payments use meta and payouts use pagination. Do not write a shared paging helper that assumes one shape.
Asset identifiers
asset_id is the primary key for an asset across the whole API. It is not always CHAIN_COIN. Native coins use a bare symbol.
Test mode has exactly one usable asset,
SETH on Ethereum Sepolia. The seeded USDT_SETH and USDC_SETH assets are inactive, so a test-mode store’s balances list is SETH or empty. See supported currencies and assets for the full live catalogue.
Agentic balances
Agent credentials read balances fromGET /api/v2/agentic/balances instead, with scope assets:read. That response has no stablecoin_summary, but accepts an asset_id filter. See Agentic API.