RIrivermarkets
orders

List Orders

Changed on

List orders with optional filters.

Returns a paginated list of orders across all accessible subaccounts, ordered by created_at descending.

Filters: All filters are optional and can be combined. If no subaccount_id is specified, returns orders from all subaccounts the user has access to.

Order Statuses:

  • PENDING_SUBMISSION: Order received, awaiting exchange submission.
  • PROCESSING: Being processed by the order consumer.
  • RESTING: Live on the exchange order book (may include partially-filled live orders).
  • EXECUTED: Terminal — fully filled.
  • PARTIALLY_FILLED: Terminal — cancelled with some quantity filled.
  • CANCELLED: Terminal — cancelled with no fills.
  • REJECTED: Rejected by exchange (see order details for reason).

Aggregated Fields: Each order includes traded_qty, average_price, and fees_paid computed from fills.

get/v1/orders

Request

  • Base URL
    https://api.rivermarkets.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.rivermarkets.com/v1/orders
  • Auth
    none declared

Query parameters

statusstring nullable

Filter by order status. Accepts a single OrderStatus name (e.g. 'RESTING') or the meta-value 'ACTIVE' which resolves to RESTING.

river_idinteger nullable

Filter by instrument ID

generic_asset_idstring uuid nullable

Filter by generic asset ID

subaccount_idstring uuid nullable

Filter to a specific subaccount

parent_iceberg_order_idstring uuid nullable

Filter to child tranches of a specific iceberg parent.

parent_peg_order_idstring uuid nullable

Filter to child tranches of a specific peg parent.

parent_smart_taker_order_idstring uuid nullable

Filter to IOC children of a specific smart-taker parent.

parent_generic_order_idstring uuid nullable

Filter to the per-exchange children of a specific generic resting order.

buy_flagboolean nullable

Filter by direction: true=buys, false=sells

order_typestring nullable

Filter by order type: LIMIT, MARKET, RFQ_TAKER or RFQ_MAKER.

created_afterstring date-time nullable

Only orders created at or after this time (inclusive, ISO 8601; naive values are treated as UTC).

created_beforestring date-time nullable

Only orders created before this time (exclusive, ISO 8601; naive values are treated as UTC).

searchstring nullable

Free-text search across the order's market: ticker/slug, the human-readable question (event title, market name, outcome) via full-text + substring match, plus the order's river_id / order id / generic asset id. Applied server-side over all matching orders, not just the current page.

show_tp_sl_activeboolean

When true, complex_order_ids only includes attached TP/SL orders with status PENDING or ACTIVE.

limitinteger

Results per page (max 10000)

offsetinteger

Pagination offset

Response

Successful Response

has_moreboolean required

True when more orders exist past this page

Changes

  • 26fe30a7ffd6Revision changes
    • info

      added the new optional query request parameter parent_generic_order_id

    • info

      added the optional property // to the response with the status

  • 0f3134d38e5cRevision changes
    • breaking

      the response property // became optional for the status

    • breaking

      response property orders/items/buy_flag list-of-types was widened by adding types null to media type application/json of response 200