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

- `asset_kind` 'PERP' | 'PERP_OPTION' | 'OPTION' | 'SPOT'
- `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' | 'UNWIND_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

## Changes

- **2026-07-22** `48fe202ea888` — 1 warning, 1 info
  - added the new `UNWIND_TRANSFER` enum value to the `allOf[subschema #2]/results/items/fill_type/allOf[#/components/schemas/responses.FillType]/` response property for the response status `200`
  - removed the `TRANSFER` enum value from the `allOf[subschema #2]/results/items/fill_type/allOf[#/components/schemas/responses.FillType]/` response property for the response status `200`
- **2026-07-20** `ffff3b486e85` — 1 info
  - added the new optional `query` request parameter `asset_kind`
- **2026-07-17** `f1370c46e9e8` — 6 warning
  - added the new `BLOCK_TRADE_REPLAYED_SIGNATURE` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `BLOCK_TRADE_REPLAYED_SIGNATURE` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `401`
  - added the new `EVM_VAULT_OPERATORS_DISABLED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `EVM_VAULT_OPERATORS_DISABLED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `401`
  - …2 more
- …earlier changes not shown

[Full history](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/changes/fills/get.md)

---

[API](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2.md) · [All operations](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tradeparadex/paradex-rest-api-2/revisions/a73698fdee53/schema)