Fills

Get fills

get

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

Query parameters

addressstringOptional

Filter by wallet address (case-insensitive)

assetNamestringOptional

Filter by asset name

clientIdstringOptional

Filter by client ID

isPearTradestringOptional

Filter by Pear trade (cloid prefix 0x50454152). Defaults to true.

Default: true

startTimestringOptional

Filter fills with fillTime >= this value (unix ms)

Example: 1700000000000

endTimestringOptional

Filter fills with fillTime <= this value (unix ms)

Example: 1700100000000

Responses

200

Fills retrieved successfully

application/json

idstringRequired

clientIdstring · nullableRequired

orderIdstringRequired

chunkIdstring · nullableRequired

externalOrderIdstring · nullableRequired

assetNamestringRequired

addressstringRequired

fillTimestring · nullableRequired

sidestring · nullableRequired

dirstring · nullableRequired

feeTokenstring · nullableRequired

cloidstring · nullableRequired

tidstring · nullableRequired

txHashstring · nullableRequired

pricenumberRequired

sizenumberRequired

externalFeePaidnumberRequired

builderFeePaidnumberRequired

isPearTradebooleanRequired

isLiquidationbooleanRequired

liqMarkPxnumber · nullableRequired

liqMethodstring · nullableRequired

liquidatedUserstring · nullableRequired

createdAtstringRequired

get

/fills

HTTPcURLJavaScriptPython

GET /fills HTTP/1.1
Host: hl-v2.pearprotocol.io
Accept: */*

200

Fills retrieved successfully

[
  {
    "id": "text",
    "clientId": "text",
    "orderId": "text",
    "chunkId": "text",
    "externalOrderId": "text",
    "assetName": "text",
    "address": "text",
    "fillTime": "text",
    "side": "text",
    "dir": "text",
    "feeToken": "text",
    "cloid": "text",
    "tid": "text",
    "txHash": "text",
    "price": 1,
    "size": 1,
    "externalFeePaid": 1,
    "builderFeePaid": 1,
    "isPearTrade": true,
    "isLiquidation": true,
    "liqMarkPx": 1,
    "liqMethod": "text",
    "liquidatedUser": "text",
    "createdAt": "text"
  }
]