> For the complete documentation index, see [llms.txt](https://docs.pearprotocol.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pearprotocol.io/api-integration/api-specification/fills.md).

# Fills

## Get fills

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

```json
{"openapi":"3.0.0","info":{"title":"Pear Protocol Trading API","version":"1.0.0"},"servers":[{"url":"https://hl-v2.pearprotocol.io","description":"Production (Mainnet)"}],"paths":{"/fills":{"get":{"description":"Retrieve fills with optional filters for address, asset, client, Pear trade status, and time range.","operationId":"FillsController_getFills","parameters":[{"name":"address","required":false,"in":"query","description":"Filter by wallet address (case-insensitive)","schema":{"type":"string"}},{"name":"assetName","required":false,"in":"query","description":"Filter by asset name","schema":{"type":"string"}},{"name":"clientId","required":false,"in":"query","description":"Filter by client ID","schema":{"type":"string"}},{"name":"isPearTrade","required":false,"in":"query","description":"Filter by Pear trade (cloid prefix 0x50454152). Defaults to true.","schema":{"default":true,"type":"string"}},{"name":"startTime","required":false,"in":"query","description":"Filter fills with fillTime >= this value (unix ms)","schema":{"type":"string"}},{"name":"endTime","required":false,"in":"query","description":"Filter fills with fillTime <= this value (unix ms)","schema":{"type":"string"}}],"responses":{"200":{"description":"Fills retrieved successfully","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/FillItemDto"}}}}}},"summary":"Get fills","tags":["Fills"]}}},"components":{"schemas":{"FillItemDto":{"type":"object","properties":{"id":{"type":"string"},"clientId":{"type":"string","nullable":true},"orderId":{"type":"string"},"chunkId":{"type":"string","nullable":true},"externalOrderId":{"type":"string","nullable":true},"assetName":{"type":"string"},"address":{"type":"string"},"fillTime":{"type":"string","nullable":true},"side":{"type":"string","nullable":true},"dir":{"type":"string","nullable":true},"feeToken":{"type":"string","nullable":true},"cloid":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"txHash":{"type":"string","nullable":true},"price":{"type":"number"},"size":{"type":"number"},"externalFeePaid":{"type":"number"},"builderFeePaid":{"type":"number"},"isPearTrade":{"type":"boolean"},"isLiquidation":{"type":"boolean"},"liqMarkPx":{"type":"number","nullable":true},"liqMethod":{"type":"string","nullable":true},"liquidatedUser":{"type":"string","nullable":true},"createdAt":{"type":"string"}},"required":["id","clientId","orderId","chunkId","externalOrderId","assetName","address","fillTime","side","dir","feeToken","cloid","tid","txHash","price","size","externalFeePaid","builderFeePaid","isPearTrade","isLiquidation","liqMarkPx","liqMethod","liquidatedUser","createdAt"]}}}}
```