Skip to main content

Orders

The Partner API exposes endpoints under the Orders tag: place orders, get open orders, get an order, get trades, cancel open orders, and (via the spec) search orders/trades/executions and order stream. Full request/response details are in the Partner API OpenAPI spec — Orders.

Most order-book trading is done via FIX (see Trading (FIX)). YLDS is an exception: it cannot be bought or sold via FIX because it does not go through the order book. Use the Orders REST endpoints below for YLDS.

Placing YLDS orders​

YLDS (stablecoin) orders are placed via REST only — not via FIX — because YLDS does not go through the order book.

Place a new YLDS order: POST /api/v1/orders/ylds

Required: marketId, quantity, direction (BID or ASK). Optional uuid for idempotency (auto-generated if omitted).

Example body:

{
  "marketId": "YLDS-USD",
  "quantity": 100,
  "direction": "BID"
}

Get open orders​

Returns open (working) orders for the authenticated account. These are mainly order-book orders (e.g. placed via FIX). YLDS orders you placed with REST are included in the same response.

Get open orders: GET /api/v2/orders/search/open

Optional query: marketId (array of market ids to filter). Response includes order details (id, symbol, side, quantity, price, state, etc.). See the Orders spec for the full response schema.

Get an order​

Fetch a single order by id (or by client order id). Works for order-book (FIX) orders and for YLDS orders placed via REST.

Get an order: GET /api/v1/orders/{orderId}

Path: orderId (order id). Optional query: is_clord_id (boolean, default false) to look up by client order id instead. Returns the order with execution state, fills, etc.

Get trades​

Returns summarized trade data for the authenticated account (e.g. for reporting), mostly from order-book (FIX) trading. YLDS trades show up here too. For raw execution-level data, use the search executions endpoint in the spec.

Get trades: GET /api/v1/orders/trades

Optional query params: market_id, direction, start_date, token (pagination), size (1–200, default 20), sort (ASC/DESC). Response is paginated. See the Orders spec for the response schema.

Cancel open orders​

Cancel all open orders for a given market or base asset, including YLDS and order-book (FIX) open orders that match the filter.

Cancel all open orders: POST /api/v1/orders/cancel

Request body: marketId (market id) or baseAsset (base asset — cancels open orders across all markets for that base). Use one or the other depending on whether you want to cancel by specific market or by base asset.

Other operations​

See the full Orders spec for search orders/trades/executions (EP3 proxy), order stream, and response schemas.