v1

latestOpenAPI 3.0.32026-07-267278168.1 KB

Fills

Get Fills

Returns a paginated list of fills for the authenticated account.

get/v1/perps/fills

Query parameters

marketstring

Example:AAPL-USD.P

Filter by trading market

limitinteger

Example:1000

Maximum number of results to return

cursorstring

Example:NQ5WWO3THN3Q====

Pagination cursor

startTimeinteger

Example:1684814400000

Filter by start time (UTC milliseconds)

endTimeinteger

Example:1672549200000

Filter by end time (UTC milliseconds)

Response

Paginated list of fills, most recent first

successboolean required

Whether the request was successful

errorstring

Error message, present only on failure

error_codestring

Semantic error code. See each endpoint's error responses for the specific codes it can return.

deprecatedstring

Deprecation notice, if applicable

Example response

{
  "success": true,
  "result": [
    {
      "id": "70a37d8f972f2494837f9dba8364cbb4",
      "orderId": "197ec08e001658690721be129e7fa595",
      "clientOrderId": "order123",
      "parentOrderID": "70a37d8f972f2494837f9dba8364cbb4",
      "market": "AAPL-USD.P",
      "price": "1.55",
      "size": "5.403",
      "side": "buy",
      "direction": "openLong",
      "filledCost": "8.37465",
      "fee": "0.0837",
      "feeRebate": "0.0042",
      "pnl": "1.2345",
      "time": "2022-06-16T12:35:11.123456Z"
    }
  ],
  "pageInfo": {
    "prevCursor": "O4ZTGM3RGM2DG===",
    "nextCursor": "NQ5WWO3THN3Q===="
  }
}