---
title: "List Spot orders"
method: GET
path: "/v1/spot/orders"
tags: ["Spot trading"]
---

# List Spot orders

`GET /v1/spot/orders`

## Request

- Base URL: `https://api.ondoperps.xyz`
- URL: `https://api.ondoperps.xyz/v1/spot/orders`
- Auth: one of:
  - HTTP bearer
  - API key in header `ONDO-KEY-ID`

An open or canceled order may already have fills. Paginate using pageInfo.nextCursor.

See the [Spot API guide](/api-reference/spot-api-guide). Requires authentication; API-key scope: `view`.

## Query parameters

- `cursor` string
- `limit` integer
- `market` string
- `status` 'open' | 'fullyFilled' | 'canceled'
- `orderType` string
- `hasFill` boolean
- `activeOnly` boolean
- `startTime` integer
- `endTime` integer

## Response `200`

Success. Inspect item-level outcomes for batch operations.

- object
  - `success` boolean, required
  - `result` SpotOrder[], nullable
    - `orderId` string, required: Internal order ID
    - `clientOrderId` string: Client-provided order ID (if set)
    - `side` 'buy' | 'sell', required: buy or sell
    - `price` string, required: Limit price
    - `size` string, required: Order quantity in base currency
    - `market` string, required: Trading market
    - `filledSize` string, required: Quantity of the order that has been filled
    - `lastFillSize` string, required: Quantity filled in the most recent trade
    - `filledCost` string, required: Cost of the filled portion of the order (filledSize × fill price)
    - `fee` string, required: Fee in the asset received: base equivalent quantity for buys, USDC for sells. Zero during the launch promotion.
    - `status` 'open' | 'fullyfilled' | 'canceled', required: Order status
    - `createdAt` string, date-time, required: Order creation time
    - `filledAt` string, date-time: Time when the order was fully filled (if applicable)
    - `canceledAt` string, date-time: Order cancellation time (if cancelled)
    - `cancelReason` string: Cancellation reason when provided. Treat this as an extensible string.
    - `type` 'limit' | 'market', required: Order type
    - `timeInForce` 'GTC' | 'IOC': Time in force (GTC or IOC). Not returned for market orders.
  - `pageInfo` object
    - `prevCursor` string
    - `nextCursor` string

## Other responses

- `400`: Validation error; inspect error_code and error.
- `429`: Rate limit exceeded. Slow down request frequency.

## Changes

- **2026-11-03** `1601c3adedda`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api/changes/v1/spot/orders/get.md)

---

[API](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api.md) - [All operations](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api/revisions/1601c3adedda?raw)