---
title: "List fills"
method: GET
path: "/v1/fills"
tags: ["Orders"]
---

# List fills

`GET /v1/fills`

Returns execution fills with cursor-based pagination. Optionally filtered by order ID or symbol.

## Query parameters

- `node_order_id` string
- `symbol` string
- `limit` integer
- `after` string

## Response `200`

Fill list

- ListFillsResp
  - `fills` FillRecord[], required
    - `lineage_deployment_id` string, nullable
    - `commission_asset` string, nullable — Asset the commission was charged in (e.g. "USD", "USDT", "BNB"). Needed for FX reconciliation on venues that debit non-quote assets.
    - `exchange_ts_ns` integer, nullable
    - `execution_region` string, nullable
    - `fee_1e9` integer, required
    - `fee_breakdown` unknown
    - `fill_id` string, required
    - `id` integer, required
    - `instrument_type` string, required — Instrument class of the parent order ("spot" | "perp" | "prediction"), joined from `orders`. Lets the fills blotter render the INSTR column without a second lookup.
    - `is_maker` boolean, nullable
    - `maker_fee_bps_applied` integer, nullable — Maker rate (bps) the venue applied to *this* fill. Set when `is_maker == Some(true)` and the venue reports the inline rate.
    - `node_order_id` string, required
    - `price_1e9` integer, required
    - `qty_1e8` integer, required
    - `side` string, required
    - `symbol` string, required
    - `taker_fee_bps_applied` integer, nullable — Taker rate (bps) the venue applied to *this* fill.
    - `trade_id` string, nullable — Venue's own trade/execution id.
    - `ts_unix_ns` integer, required
    - `venue` string, required
    - `venue_reported_cum_fee_1e9` integer, nullable — Cumulative commission the venue reports for this order at the moment of this fill. Reconciliation compares `sum(fee_1e9)` to the terminal value of this column.
  - `has_more` boolean, required
  - `limit` integer, required
  - `next_cursor` string, nullable
  - `total` integer, required

---

[API](https://skmtc.dev/sequencemkts/apis/sequence-markets-api.md) · [All operations](https://skmtc.dev/sequencemkts/apis/sequence-markets-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequencemkts/sequence-markets-api/revisions/1c826964b9f9/schema)