Olympus
Account

Account balances

Returns the authenticated user's account balances. The account is determined solely by the authentication headers — there is no `user` parameter. **Dev mode:** Requires `X-Account-Address` header. **Production:** Requires `X-Account-Address`, `X-Signature`, and `X-Timestamp` headers.

GET
/api/v1/balance

Returns the authenticated user's account balances. The account is determined solely by the authentication headers — there is no user parameter.

Dev mode: Requires X-Account-Address header. Production: Requires X-Account-Address, X-Signature, and X-Timestamp headers.

Header Parameters

X-Account-Address*string

Account address (hex-encoded, checksummed)

X-Signature?string

Hex-encoded 65-byte signature (production only)

X-Timestamp?string

Unix timestamp in milliseconds (production only)

Response Body

application/json

application/json

curl -X GET "http://localhost:3000/api/v1/balance" \  -H "X-Account-Address: 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"
[
  {
    "asset": "USD",
    "available": "9500.00",
    "reserved": "500.00",
    "locked": "0.00",
    "total": "10000.00"
  }
]
{
  "code": -1121,
  "msg": "Invalid symbol."
}