v1

latestOpenAPI 3.1.02026-07-2665179189.7 KB

Orderbook

List market fills

⚠️ This endpoint is in public preview.

All contracts that filled on hardware meeting the requirements for the given delivery window, sorted newest first. One row per fill (contract), including the instance SKU. Participant identity is never exposed.

get/preview/v2/orderbook/fills

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.

since_atinteger

Unix timestamp.

Example:1738972800

Lower bound on the contract's created_at (when the fill was recorded). Unix epoch seconds. Defaults to now - 7d. Must be no more than 30 days before now; older values return 422.

limitinteger

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

starting_afterstring

Example:mfilc_gqXR7s0Kj5mHvE2wNpLc4Q

Set to the response's cursor to fetch the next (older) page.

Response

Paginated list of fills.

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.

start_atinteger required

Unix timestamp.

end_atinteger required

Unix timestamp.

requested_atinteger required

Unix timestamp.

cursorstring

has_moreboolean required

Example response

{
  "requirements": {
    "accelerator": [
      "H100"
    ]
  },
  "start_at": 1738972800,
  "end_at": 1738972800,
  "requested_at": 1738972800,
  "cursor": "mfilc_gqXR7s0Kj5mHvE2wNpLc4Q",
  "data": [
    {
      "instance_sku": "isku_k3R-nX9vLm7Qp2Yw5Jd8F",
      "dollars_per_node_hour": "1.500000",
      "allocation_schedule_delta": [
        {
          "start_at": 1738972800,
          "end_at": 1738972800
        }
      ],
      "filled_at": 1738972800
    }
  ]
}