---
title: "Get fills"
method: GET
path: "/fills"
tags: ["Fills"]
---

# Get fills

`GET /fills`

Retrieve fills with optional filters for address, asset, client, Pear trade status, and time range.

## Query parameters

- `address` string
- `assetName` string
- `clientId` string
- `isPearTrade` string
- `startTime` string
- `endTime` string

## Response `200`

Fills retrieved successfully

- FillItemDto[]
  - `id` string, required
  - `clientId` string, nullable, required
  - `orderId` string, required
  - `chunkId` string, nullable, required
  - `externalOrderId` string, nullable, required
  - `assetName` string, required
  - `address` string, required
  - `fillTime` string, nullable, required
  - `side` string, nullable, required
  - `dir` string, nullable, required
  - `feeToken` string, nullable, required
  - `cloid` string, nullable, required
  - `tid` string, nullable, required
  - `txHash` string, nullable, required
  - `price` number, required
  - `size` number, required
  - `externalFeePaid` number, required
  - `builderFeePaid` number, required
  - `isPearTrade` boolean, required
  - `isLiquidation` boolean, required
  - `liqMarkPx` number, nullable, required
  - `liqMethod` string, nullable, required
  - `liquidatedUser` string, nullable, required
  - `createdAt` string, required

---

[API](https://skmtc.dev/pearprotocol/apis/pear-protocol-trading-api.md) · [All operations](https://skmtc.dev/pearprotocol/apis/pear-protocol-trading-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pearprotocol/pear-protocol-trading-api/revisions/d5e1438dfaa7/schema)