Skip to main content
Account endpoints use API-key authentication. Balances and portfolio values are decimal strings so clients do not lose precision.

​
Understand balances

GET /balances requires ACCOUNT_READ. Add ?asset=USD when you need only one asset.
  • available can be used for a new order.
  • locked is reserved by open orders.
  • Cancelling an order releases its unfilled reservation.
  • Fills move value between assets and can change both fields.
Always refresh balances after order activity instead of calculating the authoritative balance only on the client.

​
Track portfolio performance

GET /portfolio requires ACCOUNT_READ. It values positions in the platform quote asset and compares current equity with the account’s PnL baseline.
Treat partial: true as an incomplete valuation. Do not present it as the value of the entire portfolio without a warning.

​
Reconcile with private trades

Use GET /trades with the ORDER_READ scope to retrieve your fills newest first. Each record identifies your side, maker status, and related order.
Use order history for intent and status, private trades for executions, and balances for the current authoritative funds.