---
title: "Open spot orders (one coin, or all)"
method: GET
path: "/api/agent/orders/open"
tags: ["reads"]
---

# Open spot orders (one coin, or all)

`GET /api/agent/orders/open`

## Request

- Base URL: `https://api.coinrithm.com`
- URL: `https://api.coinrithm.com/api/agent/orders/open`
- Auth: HTTP bearer

Open (resting) spot orders. Pass `coinId` to filter to one coin; omit it
to list ALL open spot orders. Supports `updatedSince` delta polling
(use the response's `asOf` as the next cursor). Requires scope `read`.

## Query parameters

- `coinId` string
- `limit` integer
- `updatedSince` string, date-time

## Response `200`

OK

- object
  - `coinId` string, nullable: The filter that was applied; null when listing all coins.
  - `updatedSince` string, date-time, nullable
  - `asOf` string, date-time: Use as the next updatedSince cursor.
  - `rows` OpenOrder[]
    - `id` integer
    - `side` 'buy' | 'sell'
    - `orderType` 'market' | 'limit' | 'stop'
    - `coinId` string
    - `limitPrice` number, nullable
    - `stopPrice` number, nullable
    - `quantity` number
    - `quantityFilled` number, nullable
    - `triggered` boolean, nullable
    - `createdAt` string, date-time

## Other responses

- `400`: Invalid or missing parameters. On a route with a query allowlist, an undocumented query parameter returns `{"error": "unsupported_query_parameter", "message": "Unsupported query parameter: <key>. Supported: <keys>."}`.
- `401`: Missing/malformed or invalid/revoked API key
- `403`: API key missing the required scope
- `404`: No active mock_spot wallet for this user
- `429`: Rate limit exceeded for this API key (120 req/min baseline, 20 trade-writes/min). Honor `Retry-After`, then resume; the `RateLimit-*` headers on every response let you pace proactively. (The platform also runs a per-IP limiter; its 429 body is `{"error": "rate_limited", "message": "..."}`.)

---

[API](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api.md) · [All operations](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/revisions/28fb59f285fe?raw)