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

# List Orders

`GET /v0/orders`

List active and historical orders

## Query parameters

- `side` 'buy' | 'sell'
- `instance_type` string
- `min_price` integer
- `max_price` integer
- `min_start_date` string, date-time — An ISO 8601 datetime string
- `max_start_date` string, date-time — An ISO 8601 datetime string
- `min_duration` integer — Unix timestamp.
- `max_duration` integer — Unix timestamp.
- `min_quantity` integer
- `max_quantity` integer
- `contract_id` string
- `only_open` boolean
- `exclude_filled` boolean
- `only_filled` boolean
- `min_filled_at` string, date-time — An ISO 8601 datetime string
- `max_filled_at` string, date-time — An ISO 8601 datetime string
- `min_fill_price` integer
- `max_fill_price` integer
- `exclude_cancelled` boolean
- `only_cancelled` boolean
- `min_cancelled_at` string, date-time — An ISO 8601 datetime string
- `max_cancelled_at` string, date-time — An ISO 8601 datetime string
- `min_placed_at` string, date-time — An ISO 8601 datetime string
- `max_placed_at` string, date-time — An ISO 8601 datetime string
- `limit` integer
- `offset` integer
- `sort_by` 'created_at' | 'start_time' — Sort field for listing orders
- `sort_direction` 'ASC' | 'DESC' — Sort direction for listing orders
- `include_public` unknown

## Response `200`

List of orders

- MarketApiListOrdersResponse
  - `object` 'list', required
  - `data` MarketApiOrderResponse[], required
    - `object` 'order', required
    - `id` string, required
    - `side` 'buy' | 'sell', required
    - `status` 'open' | 'filled' | 'cancelled' | 'rejected', required
    - `instance_type` string, required
    - `quantity` integer, required
    - `start_at` string, date-time, required — An ISO 8601 datetime string
    - `end_at` string, date-time, required — An ISO 8601 datetime string
    - `price` integer, required — Price in cents
    - `flags` MarketApiOrderFlags, required — Configure more fine grained order behavior.
      - `ioc` boolean — If true, the order will be automatically cancelled if it doesn't immediately fill when being placed.
      - `post_only` boolean — If true, places the order straight into the book without trying to match against existing orders.
      - `market` boolean — If true, ignores the set limit price and matches any price that is available.
      - `prorate` boolean — If the order start time should be automatically changed to "now" once start time < "now", proportionally changing it's limit price to reflect it's shorter duration.
    - `executed` boolean, required
    - `executed_at` string, date-time — An ISO 8601 datetime string
    - `execution_price` integer, nullable
    - `cancelled` boolean, required
    - `cancelled_at` string, date-time — An ISO 8601 datetime string
    - `colocate_with` MarketApiContractId[]
    - `created_at` string, date-time, required — An ISO 8601 datetime string
    - `rejected` boolean, required
    - `rejected_reason` string, nullable
    - `cluster` string
    - `duration` integer, required — Unix timestamp.
  - `has_more` boolean, required

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthorized - missing or invalid authentication token
- `403` — Forbidden - account frozen
- `500` — Internal server error

---

[API](https://skmtc.net/sfcompute/apis/san-francisco-compute-documentation.md) · [All operations](https://skmtc.net/sfcompute/apis/san-francisco-compute-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sfcompute/san-francisco-compute-documentation/revisions/93dd7661e9bb/schema)