Sign in

v1

latestOpenAPI 3.1.02026-07-2665179189.7 KB
Orderbook

Get market depth

⚠️ This endpoint is in public preview.

Depth of book for the given requirements and delivery window, aggregated by instance SKU and price level. Individual orders and participants are not exposed.

get/preview/v2/orderbook/depth

Query parameters

requirementsstring

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

start_atinteger required

Unix timestamp.

Example:1738972800

Start of the delivery window.

end_atinteger required

Unix timestamp.

Example:1738972800

End of the delivery window.

depthinteger

Maximum levels returned per side. Clamped to [1, 100]. Default 20.

Response

Market depth.

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.

start_atinteger required

Unix timestamp.

end_atinteger required

Unix timestamp.

requested_atinteger required

Unix timestamp.

Example response

{
  "requirements": {
    "accelerator": [
      "H100"
    ]
  },
  "start_at": 1738972800,
  "end_at": 1738972800,
  "requested_at": 1738972800,
  "bids": [
    {
      "instance_sku": "isku_k3R-nX9vLm7Qp2Yw5Jd8F",
      "dollars_per_node_hour": "1.500000",
      "allocation_schedule_delta": [
        {
          "start_at": 1738972800,
          "end_at": 1738972800
        }
      ]
    }
  ],
  "asks": [
    {
      "instance_sku": "isku_k3R-nX9vLm7Qp2Yw5Jd8F",
      "dollars_per_node_hour": "1.500000",
      "allocation_schedule_delta": [
        {
          "start_at": 1738972800,
          "end_at": 1738972800
        }
      ]
    }
  ]
}