My fills

GET/api/v1/px/fillsBearer

PX Discovery & AccountE6 decimal strings throughoutA | B

This is not a per-fill tape: it is derived from filled orders, one row per order. An order filled in several pieces appears once, at that order's aggregate price. For per-fill data subscribe to the trading line's WebSocket topic account:{trader}:fills.

liquidity is always `USER` — the maker/taker split is not wired up, so do not compute rebates from it.

Send Authorization: Bearer <token>. The token is issued by POST /api/v1/auth/verify, and expires after 24h idle or 7d after issuance.

Query parameters

limitintegerqueryoptional
Maximum number of rows returned
Default100Range≥ 1Example20

Response

200Fill list

fillsobject(PxFill)[]
List of trades, newest first
fillIdstring
Fill id
Example"fill_01K5H2M3N7"
marketSlugstringnullable
Market slug
questionstringnullable
Market question
Example"Will BTC clos…c 31, 2026?"
outcomeLabelstringnullable
Display label for that side
sidestring
Order side
priceE6string
Fill price, as an E6 string; for an order filled in pieces this is that order's aggregate
quantityE6string
Fill size, as an E6 string
quoteE6string
Fill notional, as an E6 string
liquiditystring
Liquidity role. The maker/taker split is not wired up, so this is always "USER" — do not compute rebates from it
createdAtstringnullable
Time of the fill

Switch status codes in the response example to view errors. For all codes, see the Errors page.

Request

curl -X GET "$BASE_URL/api/v1/px/fills?limit=100" \
  -H "Authorization: Bearer $TOKEN"

Response

Fill list

{
  "fills": [
    {
      "fillId": "fill_01K5H2M3N7",
      "marketSlug": null,
      "question": "Will BTC close above $120,000 on Dec 31, 2026?",
      "outcomeLabel": null,
      "side": "<side>",
      "priceE6": "<priceE6>",
      "quantityE6": "<quantityE6>",
      "quoteE6": "<quoteE6>",
      "liquidity": "<liquidity>",
      "createdAt": null
    }
  ]
}

Query parameters

limitintegerqueryoptional
Maximum number of rows returned
Default100Range≥ 1Example20

Response

200Fill list

fillsobject(PxFill)[]
List of trades, newest first
fillIdstring
Fill id
Example"fill_01K5H2M3N7"
marketSlugstringnullable
Market slug
questionstringnullable
Market question
Example"Will BTC clos…c 31, 2026?"
outcomeLabelstringnullable
Display label for that side
sidestring
Order side
priceE6string
Fill price, as an E6 string; for an order filled in pieces this is that order's aggregate
quantityE6string
Fill size, as an E6 string
quoteE6string
Fill notional, as an E6 string
liquiditystring
Liquidity role. The maker/taker split is not wired up, so this is always "USER" — do not compute rebates from it
createdAtstringnullable
Time of the fill

Switch status codes in the response example to view errors. For all codes, see the Errors page.