Retrieve a list of limit orders associated with your account. By default, only open orders are returned. Use the query parameters to filter by market, event, currency mode, status, or order side.
Endpoint GET https://api.futuur.com/orders/
Authentication This endpoint requires HMAC authentication. Include the Key, Timestamp, and HMAC headers on every request. See the authentication guide for signing instructions. Request Filter orders by status. One of open, partial_filled, filled, canceled, or processing.
Filter by order side. Use bid for buy orders or ask for sell orders.
Filter orders by market (outcome) ID.
Filter orders by event ID.
Filter by a specific currency code. Maximum 4 characters (e.g., USDC, OOM).
Filter by currency mode. One of play_money or real_money.
Filter by one or more currency codes.
Filter by one or more category IDs.
Full-text search query. Maximum 255 characters.
Field to sort results by. Prefix with - for descending order (e.g., -created_at).
Number of results to return per page.
Pagination offset. Number of results to skip before returning results.
Response Returns a paginated list of limit order objects.
Pagination metadata for the result set. Total number of orders matching the query.
URL for the next page of results. null if there are no more pages.
URL for the previous page of results. null if on the first page.
Number of results returned per page.
Current pagination offset.
Array of limit order objects. Market (outcome) ID the order is placed on.
Order side: bid (buy) or ask (sell).
Currency used for the order: USDC, USDT, USD, or OOM.
Limit price as a probability between 0 and 1. null for market orders.
Number of shares in the order.
Cost of the order in currency units.
Position direction: long (betting in favor of the outcome) or short (betting against).
Current order status: open, partial_filled, filled, canceled, or processing.
ISO 8601 datetime at which the order expires. null if no expiration is set.
ISO 8601 datetime when the order was created.
Example curl --request GET \ --url "https://api.futuur.com/orders/?status=open&side=bid&limit=2" \ --header "Key: pk_live_abc123def456" \ --header "Timestamp: 1712534400" \ --header "HMAC: 3a9f2c1b...sha512signature"
{ "pagination" : { "total" : 47 , "next" : "https://api.futuur.com/orders/?limit=2&offset=2&status=open" , "previous" : null , "page_size" : 2 , "offset" : 0 }, "results" : [ { "id" : 10482 , "market" : 3801 , "side" : "bid" , "currency" : "USDC" , "price" : 0.65 , "shares" : 100.0 , "amount" : 65.0 , "position" : "long" , "status" : "open" , "expired_at" : null , "created_at" : "2026-04-05T14:22:10Z" }, { "id" : 10479 , "market" : 4112 , "side" : "bid" , "currency" : "USDC" , "price" : 0.42 , "shares" : 50.0 , "amount" : 21.0 , "position" : "long" , "status" : "open" , "expired_at" : "2026-04-30T00:00:00Z" , "created_at" : "2026-04-04T09:05:33Z" } ] }
