SFsfcompute
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

Request

  • Base URL
    https://api.sfcompute.com
  • URL
    https://api.sfcompute.com/preview/v2/orderbook/fills
  • Auth
    HTTP bearer

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
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.