ETethereal
Position

Returns a filtered list of fills for a given position

Changed on
get/v1/position/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

positionIdstring uuid required
Example:81215694-2d9f-4a87-af57-a710118938c0

Id of the position to filter fills by

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

Order by field

Response

hasNextboolean required

Whether there are more objects to paginate through

nextCursorstring

Pointer to the next page in pagination dataset

Example response

{
  "data": [
    {
      "createdAt": 1712019600000,
      "feeUsd": "3.049563",
      "filled": "2.420",
      "price": "4200.5",
      "realizedPnl": "3.049563",
      "type": "LIMIT"
    }
  ],
  "hasNext": true
}

Changes

  • 63e8937ff6f7Revision changes
    • warning

      added the new SETTLEMENT enum value to the // response property for the response status

    • info

      added the non-success response with the status

  • dc14c1586dfaRevision changes
    • breaking

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

    • warning

      added the new DELEVERAGE enum value to the // response property 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

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