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

# List Orders

`GET /orders`

Retrieves full details of orders associated with a Profile ID, with optional filters.

- Historical data prior to May 16, 2022 is unavailable.
- Pagination Limit has a max of 1000. Pagination Offset is now deprecated and nonfunctional.
- Filtering options are `account_id`, `profile_id` or neither (all orders).

## Query parameters

- `profile_id` string
- `account_id` string
- `market` 'ETHEUR' | 'ETHSGD' | 'ETHUSD' | 'BTCEUR' | 'BTCSGD' | 'BTCUSD' | 'PAXGUSD' | 'BCHUSD' | 'LTCUSD' | 'USDPUSD' | 'LINKUSD' | 'AAVEUSD' | 'UNIUSD' | 'PEPEUSD' | 'TRUMPUSD' | 'SHIBUSD' | 'ARBUSD' | 'BONKUSD' | 'ENAUSD' | 'MNTUSD' | 'ONDOUSD' | 'PENGUUSD' | 'QNTUSD' | 'RENDERUSD' | 'SKYUSD' | 'WIFUSD' | 'WLDUSD' | 'DOGEUSD' | 'AVAXUSD' | 'SUIUSD' | 'POLUSD' | 'XLMUSD' | 'BNBUSD'
- `status` 'PENDING_SUBMISSION' | 'SUBMITTED' | 'OPEN' | 'FILLED' | 'CANCELLED' | 'REJECTED' | 'EXPIRED'
- `order_time.begin` string, date-time
- `order_time.end` string, date-time
- `ref_ids` string[]
- `page_cursor` string
- `limit` integer

## Response `200`

A successful response.

- ListOrdersResponse
  - `items` Order[]
    - `id` string — The UUID of the order.
    - `profile_id` string — The profile ID the order is associated with.
    - `ref_id` string — The idempotence ID for order creation. Can be reused if the order has been closed for more than 24 hours.
    - `status` 'PENDING_SUBMISSION' | 'SUBMITTED' | 'OPEN' | 'FILLED' | 'CANCELLED' | 'REJECTED' | 'EXPIRED' — Status of the order. The `EXPIRED` status is only applicable for Smart Order Routing customers.
    - `side` 'BUY' | 'SELL' — Trade side.
    - `market` 'ETHEUR' | 'ETHSGD' | 'ETHUSD' | 'BTCEUR' | 'BTCSGD' | 'BTCUSD' | 'PAXGUSD' | 'BCHUSD' | 'LTCUSD' | 'USDPUSD' | 'LINKUSD' | 'AAVEUSD' | 'UNIUSD' | 'PEPEUSD' | 'TRUMPUSD' | 'SHIBUSD' | 'ARBUSD' | 'BONKUSD' | 'ENAUSD' | 'MNTUSD' | 'ONDOUSD' | 'PENGUUSD' | 'QNTUSD' | 'RENDERUSD' | 'SKYUSD' | 'WIFUSD' | 'WLDUSD' | 'DOGEUSD' | 'AVAXUSD' | 'SUIUSD' | 'POLUSD' | 'XLMUSD' | 'BNBUSD'
    - `type` 'LIMIT' | 'MARKET' | 'POST_ONLY_LIMIT' | 'STOP_MARKET' | 'STOP_LIMIT' — Trade type.
    - `base_amount` string, decimal — The base amount or purchase amount for a market sell order.
    - `price` string, decimal — The quote price.
    - `quote_amount` string, decimal — The quote amount of purchase for a market buy order.
    - `metadata` object — Client-specified metadata.
    - `created_at` string, date-time — The time at which the order was created.
    - `modified_at` string, date-time — The time at which the order was last modified.
    - `amount_filled` string, decimal — The amount that was filled.
    - `volume_weighted_average_price` string, decimal — The volume-weighted average price.
    - `time_in_force` 'GTC' | 'FOK' | 'IOC' | 'GTT' — How long an order will remain active before it expires. - Immediate-or-Cancel (IOC): Cancel if not executed immediately, partial fills allowed. - Good-Til-Canceled (GTC): Order can be canceled at any point until executed. - Good-Til-Time (GTT): Expires if not executed by a specified time. GTT must be greater than 10 seconds after the order is placed, otherwise the order will be rejected. - Fill-or-Kill (FOK): Fill entire order only or cancel entire order, does not allow for partial filling. **Time in Force validity for Order Types** | Order type | Immediate or Cancel (IOC) | Good Til Canceled (GTC) | Good Til Time (GTT) | Fill or Kill (FOK) | | --------------- | ------------------------- | ----------------------- | ------------------- | ------------------ | | Market Order | Default | - | - | - | | Limit Order | Valid | Default | Valid | Valid | | Post Only Limit | Valid | Default | Valid | Valid | | Stop Market | - | Default | Valid | - | | Stop Limit | - | Default | Valid | - |
    - `expiration_date` string, date-time — The date the order will expire if not completed when specified time in force is GTT.
    - `identity_id` string — The end user that requests the trade. This field must be used in conjunction with `identity_account_id`, otherwise the order is rejected. Depending on your integration type, `identity_id` and `identity_account_id` may be required.
    - `identity_account_id` string — The account under which this order is placed. The provided identity must be allowed to trade on behalf of this account. This field must be used in conjunction with `identity_id`, otherwise the order is rejected. Depending on your integration type, `identity_account_id` and `identity_id` may be required.
    - `stop_price` string, decimal
    - `recipient_profile_id` string — The profileId that will receive settled currency (base for buy orders, quote for sell orders).
    - `is_triggered` boolean — Returns `true` when a stop order has been triggered.
  - `next_page_cursor` string — Cursor token required for fetching the next page.

---

[API](https://skmtc.net/paxos/apis/paxos-api.md) · [All operations](https://skmtc.net/paxos/apis/paxos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paxos/paxos-api/versions/0687ca8c9a8d/schema)