Account Information
Type: USER_DATA · Weight: 1
Status: Live in production. The response includes the
settlementblock and a livecanTradevalue.
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"
}
}
| Field | Notes |
|---|---|
canTrade | false 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, canDeposit | Always false: there are no deposit/withdrawal endpoints on /api/v3. Wallet-funded accounts fund and withdraw by moving assets in their own Canton wallet. |
updateTime | Time 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. |
permissions | Always ["SPOT"]. |
settlement | Rocky 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
| HTTP | code | cause |
|---|---|---|
429 | -1003 | Weight bucket exhausted. |
500 | -1000 | Database unavailable. |
Differences from Binance
- No
makerCommission/takerCommission/commissionRates,brokered,requireSelfTradePrevention,preventSor,uidfields. balancesis a fixed asset list rather than "assets with non-zero balance"; there is noomitZeroBalances.canWithdraw/canDepositare permanentlyfalseon this surface.settlementis a Rocky extension.