Balance snapshot

GET/api/v1/accounts/{owner}Bearer

Trading APIprice E4 · size E2 · amount E6 (integers)YES | NO

owner must equal the session address (enforced server-side, so cross-user reads are impossible). fillReservedE6 is a third bucket: seller proceeds that have filled off-chain and are settling on-chain, released into availableE6 once confirmed. There is no customer-facing REST deposit or withdrawal — money moves on-chain and through the indexer.

Send Authorization: Bearer <token>. The token is issued by POST /api/v1/auth/verify, and expires after 24h idle or 7d after issuance.

Path parameters

ownerstringpathrequired
The address to query; must equal the session address
Example"0x3f1a9c2e7b4…a7b8c9d0e1f"

Response

200Balance

availableE6int64
Available balance
Example1250000000
frozenE6int64
Reserved amount (held by resting orders)
Example52000000
fillReservedE6int64
Seller proceeds that have filled off-chain and are settling on-chain; released once confirmed
Example12500000
totalDepositsE6int64
Cumulative net deposits
Example2000000000

Switch status codes in the response example to view errors. For all codes, see the Errors page.

Request

curl -X GET "$BASE_URL/api/v1/accounts/0x3f1a9c2e7b4d5e6f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f" \
  -H "Authorization: Bearer $TOKEN"

Response

Balance

{
  "availableE6": 1250000000,
  "frozenE6": 52000000,
  "fillReservedE6": 12500000,
  "totalDepositsE6": 2000000000
}