Skip to main content
GET
List order history
Your orders in every status, newest first: active, matching, filled, cancelled and expired.

Authentication

Sign this exact message with personal_sign, using unix seconds and no trailing newline:
Send address, signature, nonce, issued_at and expiry as base64url-encoded JSON in the X-Numo-Auth header. A frame can be reused until it expires, up to 24 hours. WebSocket frames are not accepted here.

What traded

filled_quote is the USDC that actually changed hands. Use it to reconcile, not the order’s amount × limit price, which overstates a marketable order. It is absent when nothing filled.

Retention and paging

Orders that traded are kept indefinitely. Cancelled and expired orders with no fills are pruned after 30 days. Pages hold up to limit orders (default 50, maximum 100). Pass next_before as before for 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.