v1

latestOpenAPI 3.1.02026-07-2665179189.7 KB

Orderbook

List market windows

⚠️ This endpoint is in public preview.

List every instance SKU and delivery window with resting orders matching the requirements, within the given time range. Each row is a summary; use /quote or /depth for detail on a specific SKU window.

get/preview/v2/orderbook/windows

Query parameters

requirementsstring

URL-safe field[:op]:value triples joined by ;.

range_start_atinteger required

Unix timestamp.

Example:1738972800

Start of the delivery-window range to browse. Unix epoch seconds, minute-aligned.

range_end_atinteger required

Unix timestamp.

Example:1738972800

End of the delivery-window range to browse. Unix epoch seconds, minute-aligned, must be > range_start_at.

limitinteger

Maximum results to return. Clamped to [1, 200]. Default 50.

starting_afterstring

Example:mwin_gqXR7s0Kj5mHvE2wNpLc4Q

Set to the response's cursor to fetch the next page.

Response

Active windows in the range.

object'list' required

requirementsRequirements required

Key/value filters on instance SKU properties.

Valid keys and values are published at GET /v2/instance_sku_property_catalog.

Empty map = no constraints.

range_start_atinteger required

Unix timestamp.

range_end_atinteger required

Unix timestamp.

cursorstring

has_moreboolean required

Example response

{
  "requirements": {
    "accelerator": [
      "H100"
    ]
  },
  "range_start_at": 1738972800,
  "range_end_at": 1738972800,
  "cursor": "mwin_gqXR7s0Kj5mHvE2wNpLc4Q",
  "data": [
    {
      "instance_sku": "isku_k3R-nX9vLm7Qp2Yw5Jd8F",
      "start_at": 1738972800,
      "end_at": 1738972800,
      "duration_hours": 168,
      "total_bid_order_count": 3,
      "total_ask_order_count": 5,
      "best_bid": {
        "instance_sku": "isku_k3R-nX9vLm7Qp2Yw5Jd8F",
        "dollars_per_node_hour": "1.500000",
        "allocation_schedule_delta": [
          {
            "start_at": 1738972800,
            "end_at": 1738972800
          }
        ]
      },
      "best_ask": {
        "instance_sku": "isku_k3R-nX9vLm7Qp2Yw5Jd8F",
        "dollars_per_node_hour": "1.500000",
        "allocation_schedule_delta": [
          {
            "start_at": 1738972800,
            "end_at": 1738972800
          }
        ]
      }
    }
  ]
}