Sign in

v1

latestOpenAPI 3.1.02026-07-2665179189.7 KB
Procurements

Create procurement

⚠️ This endpoint is in public preview.

Create a market automation that maintains capacity by placing buy/sell orders.

post/preview/v2/procurements

Request body

namestring
poolstring required
min_sell_price_dollars_per_node_hourstring required

Price in dollars per node-hour, encoded as a decimal string. Prices are rounded to the nearest $0.000060/node-hour market tick. This is one microdollar per node-minute. Responses contain the rounded value with six decimal places. Inputs must contain a decimal point, be non-negative, and not exceed $500/node-hour.

max_buy_price_dollars_per_node_hourstring required

Price in dollars per node-hour, encoded as a decimal string. Prices are rounded to the nearest $0.000060/node-hour market tick. This is one microdollar per node-minute. Responses contain the rounded value with six decimal places. Inputs must contain a decimal point, be non-negative, and not exceed $500/node-hour.

managed_window_minutesinteger required

How far ahead (in minutes) the procurement buys and sells compute. Higher values secure compute further in advance but commit to longer windows that may need to be sold when scaling down, potentially at a loss. Lower values reduce waste but risk compute being unavailable. The window contains this many complete minutes, beginning with the next minute. Buying power must cover each order's full duration.

enabledboolean

Enable/disable the procurement.

Example request

{
  "name": "my-resource-name",
  "instance_sku": "isku_k3R-nX9vLm7Qp2Yw5Jd8F",
  "min_sell_price_dollars_per_node_hour": "1.500000",
  "max_buy_price_dollars_per_node_hour": "1.500000"
}

Response

Procurement created.

idstring required
resource_pathstring required

A resource path for a procurement resource. Format: sfc:procurement:<account>:<workspace>:<name>.

ownerstring required
workspacestring required
workspace_idstring required
namestring required
object'procurement' required
min_sell_price_dollars_per_node_hourstring required

Price in dollars per node-hour, encoded as a decimal string. Prices are rounded to the nearest $0.000060/node-hour market tick. This is one microdollar per node-minute. Responses contain the rounded value with six decimal places. Inputs must contain a decimal point, be non-negative, and not exceed $500/node-hour.

max_buy_price_dollars_per_node_hourstring required

Price in dollars per node-hour, encoded as a decimal string. Prices are rounded to the nearest $0.000060/node-hour market tick. This is one microdollar per node-minute. Responses contain the rounded value with six decimal places. Inputs must contain a decimal point, be non-negative, and not exceed $500/node-hour.

managed_window_minutesinteger required

How far ahead (in minutes) the procurement buys and sells compute. Higher values secure compute further in advance but commit to longer windows that may need to be sold when scaling down, potentially at a loss. Lower values reduce waste but risk compute being unavailable. The window contains this many complete minutes, beginning with the next minute. Buying power must cover each order's full duration.

enabledboolean required

Enable/disable the procurement. Disabling cancels all standing orders.

created_atinteger required

Unix timestamp.

updated_atinteger required

Unix timestamp.

Example response

{
  "id": "proc_k3R-nX9vLm7Qp2Yw5Jd8F",
  "resource_path": "sfc:procurement:<account_id>:<workspace>:<name>",
  "owner": "my-resource-name",
  "workspace": "my-resource-name",
  "workspace_id": "wksp_k3R-nX9vLm7Qp2Yw5Jd8F",
  "name": "my-resource-name",
  "capacity": {
    "id": "cap_k3R-nX9vLm7Qp2Yw5Jd8F",
    "name": "my-resource-name"
  },
  "pool": {
    "id": "pool_k3R-nX9vLm7Qp2Yw5Jd8F",
    "name": "my-resource-name"
  },
  "instance_sku": {
    "id": "isku_k3R-nX9vLm7Qp2Yw5Jd8F",
    "alias": "my-resource-name"
  },
  "min_sell_price_dollars_per_node_hour": "1.500000",
  "max_buy_price_dollars_per_node_hour": "1.500000",
  "created_at": 1738972800,
  "updated_at": 1738972800
}