---
title: "GET /fills"
method: GET
path: "/fills"
---

# GET /fills

`GET /fills`

## Query parameters

- `address` string, required
- `subaccountNumber` number, double, required
- `market` string
- `marketType` 'PERPETUAL' | 'SPOT'
- `limit` number, double
- `createdBeforeOrAtHeight` number, double
- `createdBeforeOrAt` string
- `page` number, double

## Response `200`

Ok

- FillResponse
  - `pageSize` integer
  - `totalResults` integer
  - `offset` integer
  - `fills` FillResponseObject[], required
    - `id` string, required
    - `side` 'BUY' | 'SELL', required
    - `liquidity` 'TAKER' | 'MAKER', required
    - `type` 'LIMIT' | 'LIQUIDATED' | 'LIQUIDATION' | 'DELEVERAGED' | 'OFFSETTING', required
    - `market` string, required
    - `marketType` 'PERPETUAL' | 'SPOT', required
    - `price` string, required
    - `size` string, required
    - `fee` string, required
    - `affiliateRevShare` string, required
    - `createdAt` string, required
    - `createdAtHeight` string, required
    - `orderId` string
    - `clientMetadata` string
    - `subaccountNumber` integer, required

## Changes

- **2024-09-04** `beee406819cd` — 1 breaking, 1 info
  - removed the required property `fills/items/affiliateEarnedRevShare` from the response with the `200` status
  - added the required property `fills/items/affiliateRevShare` to the response with the `200` status
- **2024-08-29** `ef26a578a9d2` — 1 info
  - added the required property `fills/items/affiliateEarnedRevShare` to the response with the `200` status
- **2024-05-16** `e85a98abf3da` — 4 info
  - added the new optional `query` request parameter `page`
  - added the optional property `offset` to the response with the `200` status
  - added the optional property `pageSize` to the response with the `200` status
  - added the optional property `totalResults` to the response with the `200` status
- **2024-05-14** `90fd32395633` — 2 breaking, 13 warning, 1 info
  - the `fills/items/subaccountNumber` response's property type/format changed from `integer`/`int32` to `number`/`double` for status `200`
  - removed the required property `fills/items/affiliateRevShare` from the response with the `200` status
  - deleted the `query` request parameter `excludeTypes`
  - deleted the `query` request parameter `includeTypes`
  - …12 more

[Change history](https://skmtc.dev/dydxprotocol/apis/indexer-api/changes/fills/get.md)

---

[API](https://skmtc.dev/dydxprotocol/apis/indexer-api.md) · [All operations](https://skmtc.dev/dydxprotocol/apis/indexer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dydxprotocol/indexer-api/revisions/983d8a1aa5eb/schema)