Tokens

Order Book Fills

GET

/api/v1/tokens/{address}/fills

Order-book fills of a prediction market (OrderFilled), newest first in chain order. A fill moves no AMM reserve, so fills are not in the market liquidity history.

Auth: API Key

Query Parameters

Param	Description
orderId	Filter by order id (ids count per market per host)
outcomeId	Filter by outcome
buyer	Filter by buyer wallet
seller	Filter by seller wallet
cursor	Opaque, from `pagination.nextCursor`
limit	Page size (default 20)

Response

{
  "data": [
    {
      "orderId": 7,
      "outcomeId": 1,
      "buyer": "0x...",
      "seller": "0x...",
      "shares": "25000000000000000000",
      "basePair": "15000000",
      "buyerPaid": "15090000",
      "sellerNet": "14910000",
      "main": "0x...",
      "pairAsset": "0x...",
      "pairDecimals": 6,
      "valueUsdE18": "15000000000000000000",
      "host": "0x...",
      "txHash": "0x...",
      "logIndex": 4,
      "blockNumber": 41234567,
      "blockTime": "2026-10-01T12:00:00.000Z"
    }
  ],
  "pagination": { "limit": 20, "hasMore": false, "nextCursor": null }
}

Units: shares are outcome shares (18 decimals). basePair (shares × price), buyerPaid (fee included) and sellerNet (after the fee) are raw units of pairAsset (pairDecimals). valueUsdE18 is USD × 1e18, null when unknown.

200 Fills returned400 Invalid address or query parameter401 Missing or invalid API key503 Markets not deployed on this network