DEdefinitive
Flash

List orders

Changed on

List Flash orders for a funder, most recent first. Returns up to pageSize orders per page; pass nextPageToken back as pageToken to fetch the next page.

get/orders

Request

  • Base URL
    https://flash.definitive.fi/v1
  • Auth
    API key in header x-definitive-api-key

Query parameters

funderAddressstring

Funder wallet address whose orders to list. When omitted, orders for every funder in the portfolio are returned.

statusesstring

Comma-separated list of order statuses to filter by. When omitted, orders of every status are returned.

Example:ORDER_STATUS_FILLED,ORDER_STATUS_CANCELLED
pageSizeinteger

Number of orders to return. Defaults to 50; capped at 200.

pageTokenstring

Fetch the next page by passing the nextPageToken from your previous response. Leave it out to get the first page. Copy the value exactly as-is — it's not meant to be read or built by hand.

Response

Orders returned successfully

nextPageTokenstring nullable required

Cursor for the next page; null when there are no more orders.

Example response

{
  "orders": [
    {
      "trigger": {
        "notionalPrice": "1800",
        "crossPrice": "1800",
        "limitPrice": "1774"
      },
      "brackets": [
        {
          "notionalPrice": "1800",
          "crossPrice": "1800",
          "limitPrice": "1774"
        }
      ],
      "expiresAt": "2026-05-12T00:00:00Z"
    }
  ]
}

Changes

  • 0a477174025dRevision changes
    • warning

      added the new trailing-stop enum value to the // response property for the response status

    • warning

      added the new trailing-stop-limit enum value to the // response property for the response status

    • info

      added the optional property // to the response with the status

  • 4d70c10687f4Revision changes
    • info

      added the optional property //// to the response with the status

    • info

      added the optional property /////// to the response with the status