Skip to main content
GET
List fills
Your fills, newest first. Use them to reconcile balances. Order history shows the same activity per order. Send the same X-Numo-Auth frame as order history. The owner comes from the signature.

Reading a fill

  • liquidity is taker if your order crossed the book, maker if it rested.
  • side, price and size are your order’s side, the price in USDC per unit of the base, and the size.
  • fee is what you paid in USDC, 0 for a maker. It is absent when unknown.
  • tx_hash is the Base transaction that settled the fill. Older fills may not have one.
  • A trade between two of your own subaccounts is listed once per order, with one trade_id.

Variation margin

Futures only. mark_price is the mark when the fill’s transaction ran. vm_usdc is what settled to your account, negative when paid: your side × the size in the base × (mark_price − price). The retired USDC-cNGN-30NOV26 reports vm_cngn instead.

Retention and paging

Fills are kept indefinitely. Pages hold up to limit fills (default 50, maximum 100). Pass next_before as before for older fills. 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. The same frame GET /orders accepts.

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 fills.

Response

One page of the owner's fills, newest first

fills
object[]
required
next_before
string

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