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

# List fills

`GET /fills`

This API returns a list of matched orders (i.e. fills) that have been sent to
chain for settlement.

## Query parameters

- `cursor` string
- `end_at` integer
- `market` string
- `page_size` integer
- `start_at` integer

## Response `200`

OK

- object
  - `next` string — The pointer to fetch next set of records (null if there are no records left)
  - `prev` string — The pointer to fetch previous set of records (null if there are no records left)
  - `results` object[] — Array of paginated results
    - `account` string — Account that made the fill
    - `client_id` string — Unique client assigned ID for the order
    - `created_at` integer — Fill time
    - `fee` string — Fee paid by the user
    - `fee_currency` string — Asset that fee is charged in
    - `fill_type` 'LIQUIDATION' | 'TRANSFER' | 'FILL' | 'SETTLE_MARKET' | 'RPI' | 'BLOCK_TRADE'
    - `flags` ResponsesFillFlag[] — Fill flags indicating special properties
    - `id` string — Unique string ID of fill per FillType
    - `liquidity` 'TAKER' | 'MAKER'
    - `market` string — Market name
    - `order_id` string — Order ID
    - `orderbook_seq_no` integer — Orderbook sequence number after trade execution (post-execution state). Use seqno-1 for pre-execution. 0 for position transfers (liquidations, settlements)
    - `price` string — Price at which order was filled
    - `realized_funding` string — Realized funding of the fill
    - `realized_pnl` string — Realized PnL of the fill
    - `remaining_size` string — Remaining size of the order
    - `side` 'BUY' | 'SELL'
    - `size` string — Size of the fill
    - `underlying_price` string — Underlying asset price of the fill (spot price)

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/tradeparadex/apis/paradex-rest-api.md) · [All operations](https://skmtc.net/tradeparadex/apis/paradex-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tradeparadex/paradex-rest-api/versions/26dce0f96ab2/schema)