Skip to main content
GET
Get Account Balances
Returns the account’s money in two places: balances holds the trading account’s balances, one entry per currency, and virtual_accounts holds the balance of each named virtual account the account owns. Every figure is valued at as_of. Requires an API key with read access on the accounts scope.

Path Parameters

string
required
The customer’s external ID (starts with cus_)
string
required
The account’s external ID (starts with acct_)

Response

string
Account identifier (starts with acct_)
string
Always returns "account_balances"
string
ISO 8601 timestamp every figure in the response is valued at. Always present.
array
Trading account balances, one entry per currency. Limited to the currencies the account is configured for: a currency enabled for payin, enabled for payout, or on one side of an active FX instrument. Sorted by updated_at, most recently updated first.
array
Balance of each active virtual account on this account, one entry per virtual account, oldest first. Money here sits on the virtual account, not in the trading account, and the two are never added together in this response: move funds between them with a transfer.An account with no active virtual accounts gets an empty array, not a missing field.

Response Example