GET
List my orders

Authorizations

Authorization
string
header
required

Master session from POST /v1/auth/verify. Revocable; expires after seven days by default. Required for financial operations.

Query Parameters

client_order_id
string

Exact match: zero or one order. Persist before the first attempt. Unique per user and resource type; reuse with other parameters returns 409 STATE_CONFLICT. When omitted, the server assigns a UUID and a lost response cannot be recovered by id.

Required string length: 1 - 64
Pattern: ^[A-Za-z0-9_.:-]+$

Response

The orders.

id
string
required

The escrow's offerId.

Pattern: ^0x[0-9a-fA-F]{64}$
venue
string
required

Supply venue.

receive_venue
string
required

Venue the maker receives on.

owner_address
string
required

The maker's linked address on venue, owner of the escrow offer.

Pattern: ^0x[0-9a-fA-F]{40}$
state
enum<string>
required
Available options:
preparing,
moving,
funding,
live,
closing,
closed,
failed
error
string | null
required

Why the order failed or its last close reverted.

amount
string
required

Decimal base units of the venue's token, at most 2^256 − 1. With 6 decimals, "1000000" is 1 token.

Pattern: ^[0-9]{1,78}$
escrow_available
string
required

Unlocked balance in the escrow.

Pattern: ^[0-9]{1,78}$
quotable
string
required

Remaining admission budget capped by unlocked escrow. Check quote_set.active, valid_until and state too.

Pattern: ^[0-9]{1,78}$
filled
string
required

Taken by settled fills, in venue base units.

Pattern: ^[0-9]{1,78}$
received
string
required

Settled maker receipts, in receive_venue base units.

Pattern: ^[0-9]{1,78}$
last_sequence
integer
required

Highest stored quote sequence; 0 without one.

quote_set
object | null
required

Null before the first accepted quote or after cleanup. Check active and valid_until; lease expiry deactivates a retained set.

margin_move
object | null
required

A move out of the venue margin, relayed as a withdrawal.

transactions
object[]
required

Relayed transactions, oldest first: permit, fund, close.

created_at
string<date-time>
required

RFC 3339 UTC; snapshots and history may keep fractional seconds.

updated_at
string<date-time>
required

RFC 3339 UTC; snapshots and history may keep fractional seconds.

client_order_id
string
required

Persist before the first attempt. Unique per user and resource type; reuse with other parameters returns 409 STATE_CONFLICT. When omitted, the server assigns a UUID and a lost response cannot be recovered by id.

Required string length: 1 - 64
Pattern: ^[A-Za-z0-9_.:-]+$
quote_identity_id
string<uuid>
required
quote_signer
string
required

Responses are lowercase.

Pattern: ^0x[0-9a-fA-F]{40}$