ETethereal
Order

Returns a filtered array of order fills

Changed on
get/v1/order/fill

Request

Query parameters

order'asc' | 'desc'

Direction to paginate through objects

limitinteger

Limit the number of objects to return

cursorstring

Pointer to the current object in pagination dataset

subaccountIdstring uuid required

Id of the subaccount to filter fills by

productIdsstring[]

Array of product ids to filter for

createdAfterinteger

Filter by order fills created before timestamp exclusive (ms since Unix epoch)

createdBeforeinteger

Filter by order fills created before timestamp inclusive (ms since Unix epoch)

side0 | 1

Side of the maker as either BUY (0) or SELL (1)

orderBy'productId' | 'filled' | 'price' | 'createdAt'
Example:productId

Order by field

includeSelfTradesboolean

Explicitly include self trades (excluded by default)

expandSelfTradesboolean

When true and includeSelfTrades is also true, returns both maker and taker perspectives for self-trades as separate rows.

Response

hasNextboolean required

Whether there are more objects to paginate through

nextCursorstring

Pointer to the next page in pagination dataset

Example response

{
  "data": [
    {
      "clientOrderId": "b1234567-89ab-cdef-0123-456789abcdef",
      "createdAt": 1712019600000,
      "feeUsd": "3.049563",
      "filled": "2.420",
      "id": "b1234567-89ab-cdef-0123-456789abcdef",
      "isMaker": true,
      "orderId": "b1234567-89ab-cdef-0123-456789abcdef",
      "price": "4200.5",
      "productId": "9c6bf870-a8ce-4de3-820b-542fd5c049ba",
      "reduceOnly": true,
      "subaccountId": "aa301f94-f5b7-4e54-8b16-01052fccb2f9"
    }
  ],
  "hasNext": true
}

Changes

  • 63e8937ff6f7Revision changes
    • info

      added the non-success response with the status

  • dc14c1586dfaRevision changes
    • breaking

      for the query request parameter side, the type changed from number to integer

    • breaking

      the // response's property type changed from number to no type for status

    • breaking

      the // response's property type changed from string to no type for status

    • info

      added to the // response property allOf list for the response status

    • info

      added to the // response property allOf list for the response status

    • info

      the response's property default value Bad Request was removed for the status

    • info

      the response's property default value Forbidden was removed for the status

    • info

      the response's property default value Not Found was removed for the status

    • info

      the response's property default value Too Many Requests was removed for the status

    • info

      the response's property default value Unauthorized was removed for the status

    • info

      the response's property default value Unprocessable Entity was removed for the status

    • info

      the response's property default value 400 was removed for the status

    • info

      the response's property default value 401 was removed for the status

    • info

      the response's property default value 403 was removed for the status

    • info

      the response's property default value 404 was removed for the status

    • info

      the response's property default value 422 was removed for the status

    • info

      the response's property default value 429 was removed for the status

    • info

      removed the 0.00 enum value from the // response property for the response status

    • info

      removed the 1.00 enum value from the // response property for the response status

    • info

      removed the LIMIT enum value from the // response property for the response status

    • info

      removed the MARKET enum value from the // response property for the response status

    • info

      response property message list-of-types was narrowed by removing types array from media type application/json of response 400