Skip to main content

Account Information

Type: USER_DATA · Weight: 1

Status: Live in production. The response includes the settlement block and a live canTrade value.

GET /api/v3/account

Spot balances for the key's account. For a wallet-funded account these are the mirror of your Canton wallet holdings (see Mirror balances); for an internally-funded account they are ledger balances.

Request

GET /api/v3/account?timestamp=1756600000000&signature=...

No parameters other than timestamp / recvWindow / signature.

Response — 200 (values illustrative)

{
"canTrade": true,
"canWithdraw": false,
"canDeposit": false,
"updateTime": 1756600000123,
"accountType": "SPOT",
"balances": [
{ "asset": "CUSD", "free": "0", "locked": "0" },
{ "asset": "CBTC", "free": "0.5231", "locked": "0.001" },
{ "asset": "cETH", "free": "0", "locked": "0" },
{ "asset": "CC", "free": "0", "locked": "0" },
{ "asset": "USX", "free": "0", "locked": "0" },
{ "asset": "aCC", "free": "0", "locked": "0" },
{ "asset": "USDC.B", "free": "12500.1234567891", "locked": "50" },
{ "asset": "USDCx", "free": "0", "locked": "0" }
],
"permissions": ["SPOT"],
"settlement": {
"segment": "wallet",
"enrolled": true,
"frozen": false,
"party": "mm-alpha::1220ca15423a1b049bf8e84132360f246057aa18f5e9e36a77db535b75bd287cceff"
}
}
FieldNotes
canTradefalse while the mirror sync has the account frozen (orders answer -2010), otherwise true. An un-enrolled party-bound account still reports true and is rejected at order entry with -2012; check settlement.enrolled.
canWithdraw, canDepositAlways false: there are no deposit/withdrawal endpoints on /api/v3. Wallet-funded accounts fund and withdraw by moving assets in their own Canton wallet.
updateTimeTime of this response, Unix ms (not the last balance change).
balances[]Always the fixed list of eight assets in this order, including zero rows. Amounts are truncated (not rounded) to the asset's on-chain precision and serialized without trailing zeros ("0.5231", never "0.52310000"). locked is the amount reserved by your open orders.
permissionsAlways ["SPOT"].
settlementRocky extension. segment is wallet when the account is enrolled and on-chain settlement is active for the venue (balances mirror the party's wallet, fills settle as DvP with the fee withheld on chain, internal transfers and withdrawals disabled), else internal. enrolled mirrors that. frozen is the settlement-review kill switch (see Frozen accounts). party is the bound Canton party, null when none.

Errors

HTTPcodecause
429-1003Weight bucket exhausted.
500-1000Database unavailable.

Differences from Binance

  • No makerCommission / takerCommission / commissionRates, brokered, requireSelfTradePrevention, preventSor, uid fields.
  • balances is a fixed asset list rather than "assets with non-zero balance"; there is no omitZeroBalances.
  • canWithdraw / canDeposit are permanently false on this surface.
  • settlement is a Rocky extension.