Skip to main content
GET
List order history
Returns your orders in every status — active, matching, filled, cancelled and expired — newest first.
Authentication is required, and the owner is taken from the signature, never from a parameter. Resting orders are public on the book and fills settle on chain, but cancelled and expired orders are not published anywhere else.

Authentication

Build and sign this exact message with personal_sign (unix seconds, no trailing newline). The domain is the same one the WebSocket uses.
Send the frame — address, signature, nonce, issued_at, expiry — as JSON, base64url-encoded, in the X-Numo-Auth header. One frame can be reused across requests until it expires; the service accepts a validity window of up to 24 hours. A frame signed for the WebSocket orders channel is not accepted here, and an order-history frame does not authenticate a WebSocket: the two messages differ, so each recovers a different address from the other’s signature.

What traded

Each order that has filled carries filled_quote: the USDC that actually changed hands, summed over its fills at the prices they executed at. Use it to reconcile balances. Do not derive a size from the order’s own amount and limit price — a marketable order is signed with slippage room past the touch, so that figure overstates what filled. filled_quote is absent for an order with no fills.

Retention

Filled orders are kept indefinitely, and so is any cancelled or expired order that traded before it ended, so its fills and filled_quote stay reportable. Cancelled and expired orders with no fills are kept for 30 days, then pruned.

Paging

Pages hold up to limit orders (default 50, maximum 100). When a page is full, the response includes next_before; pass it back as before to fetch older orders. The last page has no next_before.

Headers

X-Numo-Auth
string
required

Base64url-encoded JSON auth frame {address, signature, nonce, issued_at, expiry}, signed with personal_sign over the order-history message. See the endpoint page for the exact message.

Query Parameters

limit
integer
default:50
Required range: 1 <= x <= 100
before
string

The next_before value from the previous page, to page to older orders.

Response

One page of the owner's orders, newest first

orders
object[]
required
next_before
string

Pass as before to fetch older orders. Absent on the last page.