Skip to main content

Orders

On the Standard API, Orders covers YLDS placement and order-book reporting endpoints documented in OpenAPI specs). Use your Trader API bearer token (Authentication, Standard API).

Live order-book entry (insert, cancel, replace, working-order subscriptions) is on the low-latency API on trade.figuremarkets.* — see Orders.

Order history: low-latency vs standard API​

note

Low-latency trading exposes search, list, and download for order and trade history only for a limited retention window. After that, data is archived and those endpoints no longer return it.

For order-book reporting beyond that window, use the standard API endpoints on this page. If you trade on trade.figuremarkets.*, keep using the low-latency Orders API for place, cancel, replace, subscriptions, and in-window history—do not use the standard API as an alternate path to the same EP3 search or stream operations. Confirm the retention period for trade.figuremarkets.* with Figure Markets.

Placing YLDS orders​

YLDS (stablecoin) orders are placed via REST only; they do not go through the central limit order book.

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

Required: uuid (client order id; must be non-null for Trader API), marketId, quantity, direction (BID or ASK). Use the correct YLDS market name for marketId (e.g. YLDS-USD-2F, YLDS-USDC-2F).

Example body:

{
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "marketId": "YLDS-USD-2F",
  "quantity": 100,
  "direction": "BID"
}

Get an order​

Fetch a single order by id (or by client order id). Applies to order-book orders. YLDS orders you placed on this API are available here too.

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

Path: orderId. Optional query: is_clord_id (boolean, default false) to look up by client order id instead. See the Orders tag in Trader API (standard REST) for the response schema.

Get trades​

Returns summarized trade data for the authenticated account (e.g. for reporting). Covers order-book trades and YLDS trades.

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

Optional query params include market_id, direction, start_date, token (pagination), size (1–200, default 20), sort (ASC/DESC). Response is paginated. See the Orders tag in Trader API (standard REST) for the full schema.

Where live trading runs​

For insert, cancel, replace, subscriptions to working orders, and short-window search/download on trade.figuremarkets.*, use Orders on the low-latency API.