---
title: "List orders"
method: GET
path: "/orders"
tags: ["Flash"]
---

# List orders

`GET /orders`

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.

## Query parameters

- `funderAddress` string, required — Funder wallet address whose orders to list.
- `statuses` string — Comma-separated list of order statuses to filter by. When omitted, orders of every status are returned.
- `pageSize` integer — Number of orders to return. Defaults to 50; capped at 200.
- `pageToken` string — 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 `200`

Orders returned successfully

- FlashListOrdersResponse
  - `orders` FlashOrder[], required
    - `orderId` string, required
    - `orderType` 'market' | 'limit' | 'twap' | 'stop' | 'stop-loss' | 'take-profit' | 'bracket', required
    - `side` 'buy' | 'sell', required
    - `status` 'ORDER_STATUS_UNSPECIFIED' | 'ORDER_STATUS_PENDING' | 'ORDER_STATUS_ACCEPTED' | 'ORDER_STATUS_PARTIALLY_FILLED' | 'ORDER_STATUS_FILLED' | 'ORDER_STATUS_CANCELLED' | 'ORDER_STATUS_REJECTED' | 'ORDER_STATUS_TERMINATED', required
    - `closeReason` string, nullable, required — Reason the order was closed (e.g. `REASON_USER_REQUESTED`, `REASON_FULLY_FILLED`); null while the order is still active.
    - `funderAddress` string, required
    - `targetAsset` FlashAssetRef, required
      - `id` string, required
      - `name` string, required
      - `address` string, required
      - `ticker` string, required
      - `chain` FlashAssetChainRef, required
        - `id` string, required
        - `name` string, required
        - `namespace` string, required
    - `contraAsset` FlashAssetRef, required
      - `id` string, required
      - `name` string, required
      - `address` string, required
      - `ticker` string, required
      - `chain` FlashAssetChainRef, required
        - `id` string, required
        - `name` string, required
        - `namespace` string, required
    - `qty` string, required
    - `filled` FlashOrderFilled, nullable, required
      - `targetAmount` string, nullable, required
      - `contraAmount` string, nullable, required
      - `averagePrice` string, nullable, required
      - `averageNotionalPrice` string, nullable, required
    - `limitNotionalPrice` string, nullable, required
    - `limitCrossPrice` string, nullable, required
    - `trigger` object, nullable, required
      - `notionalPrice` string — USD-price trigger on the traded (`targetAsset`) asset.
      - `crossPrice` string — Pair-rate trigger — price of `targetAsset` denominated in `contraAsset`. Mutually exclusive with `notionalPrice`.
      - `triggerType` 'upper' | 'lower', required — "lower": fires when market drops to/below the price. "upper": rises to/above.
    - `brackets` PriceTrigger[], nullable, required
      - `notionalPrice` string — USD-price trigger on the traded (`targetAsset`) asset.
      - `crossPrice` string — Pair-rate trigger — price of `targetAsset` denominated in `contraAsset`. Mutually exclusive with `notionalPrice`.
      - `triggerType` 'upper' | 'lower', required — "lower": fires when market drops to/below the price. "upper": rises to/above.
    - `attachedBracket` AttachedBracketRead — The attached take-profit / stop-loss pair. Present only on orders submitted with an `attachedBracket` block.
      - `status` 'pending_activation' | 'never_activated' | 'active', required — pending_activation: becomes a live order on the entry's first fill. never_activated: the entry closed unfilled. active: the protective order exists — read it by `bracketOrderId`.
      - `bracketOrderId` string, nullable, required — The protective order's own id; set once status is active.
      - `takeProfit` AttachedBracketReadLeg, nullable, required — The take-profit leg as submitted. Null on stream frames — the full configuration rides GET.
        - `notionalPrice` string
        - `crossPrice` string
        - `limitPrice` string — When set, this leg exits as a limit order at this price instead of at market.
      - `stopLoss` object, nullable, required — The stop-loss leg as submitted. Null on stream frames — the full configuration rides GET.
        - `notionalPrice` string
        - `crossPrice` string
        - `limitPrice` string — When set, this leg exits as a limit order at this price instead of at market.
      - `signedMaxFromAmount` string, nullable, required — The maximum amount of the received asset the signature authorizes selling.
    - `sourceEntryOrderId` string — On a protective order created by an attached pair: the entry order it was attached to.
    - `maxPriceImpact` string, nullable, required
    - `twapBucketCount` integer, nullable, required
    - `placedAt` string, date-time, required
    - `acceptedAt` string, date-time, nullable, required
    - `closedAt` string, date-time, nullable, required
    - `expiresAt` string, date-time, nullable, required — When the order expires. Null for good-til-cancelled orders (no `expireTime` was set) and for market orders.
  - `nextPageToken` string, nullable, required — Cursor for the next page; null when there are no more orders.

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication failed
- `403` — Permission denied
- `404` — Resource not found
- `422` — Resource state prevents the requested operation
- `429` — Rate limit exceeded
- `500` — Internal server error
- `503` — Service temporarily unavailable
- `504` — Gateway timeout

## Changes

- **2026-08-14** `060b09bd6cb0` — 2 info
  - added the optional property `orders/items/attachedBracket` to the response with the `200` status
  - added the optional property `orders/items/sourceEntryOrderId` to the response with the `200` status
- **2026-07-31** `e7536bd95e54` — 2 info
  - added the new optional `query` request parameter `pageToken`
  - added the required property `nextPageToken` to the response with the `200` status
- **2026-07-26** `0722d2b04e4e` — 2 breaking, 4 info
  - the response property `orders/items/brackets/items/notionalPrice` became optional for the status `200`
  - the response property `orders/items/trigger/allOf[#/components/schemas/PriceTrigger]/notionalPrice` became optional for the status `200`
  - added the optional property `orders/items/brackets/items/crossPrice` to the response with the `200` status
  - added the optional property `orders/items/trigger/allOf[#/components/schemas/PriceTrigger]/crossPrice` to the response with the `200` status
  - …2 more

[Change history](https://skmtc.dev/definitive/apis/definitive-flash-api/changes/orders/get.md)

---

[API](https://skmtc.dev/definitive/apis/definitive-flash-api.md) · [All operations](https://skmtc.dev/definitive/apis/definitive-flash-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/definitive/definitive-flash-api/revisions/a3fee79d0a4d/schema)