List orders

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/v2.0/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

string

default:"open"

Filter orders by status. One of open, partial_filled, filled, canceled, or processing.

string

Filter by order side. Use bid for buy orders or ask for sell orders.

integer

Filter orders by market (outcome) ID.

integer

Filter orders by event ID.

string

Filter by a specific currency code. Maximum 4 characters (e.g., USDC, OOM).

string

Filter by currency mode. One of play_money or real_money.

string[]

Filter by one or more currency codes.

integer[]

Filter by one or more category IDs.

string

Full-text search query. Maximum 255 characters.

string

Field to sort results by. Prefix with - for descending order (e.g., -created_at).

integer

Number of results to return per page.

integer

Pagination offset. Number of results to skip before returning results.

Response

Returns a paginated list of limit order objects.

object

required

Pagination metadata for the result set.

Show properties

integer

Total number of orders matching the query.

string

URL for the next page of results. null if there are no more pages.

string

URL for the previous page of results. null if on the first page.

integer

Number of results returned per page.

integer

Current pagination offset.

object[]

required

Array of limit order objects.

Show Order properties

integer

required

Unique order ID.

integer

required

Market (outcome) ID the order is placed on.

string

required

Order side: bid (buy) or ask (sell).

string

required

Currency used for the order: USDC, USDT, USD, or OOM.

number

Limit price as a probability between 0 and 1. null for market orders.

number

Number of shares in the order.

number

Cost of the order in currency units.

string

Position direction: long (betting in favor of the outcome) or short (betting against).

string

required

Current order status: open, partial_filled, filled, canceled, or processing.

string

ISO 8601 datetime at which the order expires. null if no expiration is set.

string

required

ISO 8601 datetime when the order was created.

Example

curl --request GET \
  --url "https://api.futuur.com/v2.0/orders/?status=open&side=bid&limit=2" \
  --header "Key: pk_live_abc123def456" \
  --header "Timestamp: 1712534400" \
  --header "HMAC: 3a9f2c1b...sha512signature"

Sample response

{
  "pagination": {
    "total": 47,
    "next": "https://api.futuur.com/v2.0/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"
    }
  ]
}

Events

Markets

Orders

Wagers

Account

Realtime (websockets)

Endpoint

Authentication

Request

Response

Example

​Endpoint

​Authentication

​Request

​Response

​Example

Endpoint

Authentication

Request

Response

Example