Sign in

v44

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-20129390589.6 KB
Procurements

Create procurement

Create a procurement. A procurement tries to continuously buy small blocks of compute over and over again. Advantage being that you might be able to get a cheaper price than a longer term reservation. Disadvantage being that you can never be sure if you're nodes will spin up and down as market prices fluctuate.

post/v0/procurements

Request body

status'active' | 'disabled'
instance_typestring required
desired_quantityinteger required

Desired quantity of nodes

buy_limit_price_per_gpu_hourinteger

Maximum price per GPU hour in cents

sell_limit_price_per_gpu_hourinteger

Minimum price per GPU hour in cents when selling back

horizoninteger

Planning horizon in minutes

Example request

{
  "instance_type": "h100i",
  "desired_quantity": 5,
  "buy_limit_price_per_gpu_hour": 250,
  "sell_limit_price_per_gpu_hour": 25,
  "horizon": 60,
  "colocation_strategy": {
    "cluster_name": "richmond"
  }
}

Response

Successfully created procurement

object'procurement' required
idstring required
instance_typestring required
status'active' | 'disabled' required
desired_quantityinteger required
buy_limit_price_per_gpu_hourinteger required
sell_limit_price_per_gpu_hourinteger required
horizoninteger required
last_message'insufficient_balance' | 'running' required

Example response

{
  "object": "procurement",
  "id": "proc_W9TRG",
  "instance_type": "h100i",
  "desired_quantity": 1,
  "buy_limit_price_per_gpu_hour": 250,
  "sell_limit_price_per_gpu_hour": 25,
  "horizon": 60,
  "colocation_strategy": {
    "cluster_name": "richmond"
  }
}