List trading accounts

GET 
/api/v1/trading/accounts

Account model

This control-plane endpoint may return both a 32-byte trading-account id and a 20-byte engine account. Store them as separate fields.

Response field	Size	Use it for
owner / owner wallet	20 bytes	Agent creation, admin authorization, account ownership.
accountIdHex	32 bytes	Trading-account records, account listing, control-plane identifiers.
engineAccountHex / engineAccount	20 bytes	Balances, signed actions, BSL/FIX/FIXP submit, private streams, drop-copy.

Never call balance/bootstrap/order routes with accountIdHex when they expect the 20-byte engine account. That is the most common source of "funded account looks empty" failures.

Example response shape

{
  "accounts": [
    {
      "owner": "0x1111111111111111111111111111111111111111",
      "accountIdHex": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "engineAccountHex": "0x2222222222222222222222222222222222222222",
      "label": "main-mm-account",
      "status": "active"
    }
  ]
}

After selecting an account, run:

GET /api/v1/accounts/:engineAccount/bootstrap?fresh=true

Lists control-plane trading accounts for an owner wallet. The response can include both a 32-byte accountIdHex and a 20-byte engineAccountHex; use the engine account for balances, signed actions, BSL/FIX/FIXP, and private streams.

Request

Responses

200

Trading accounts

default

Structured API error

Response Headers

X-Request-Id

Stable request correlation id generated or echoed by the server.