Quickstart

curl https://supply-api.compute-desk.com/available_gpus \
  -H "Authorization: Bearer $TOKEN"

import requests

headers = {"Authorization": "Bearer YOUR_TOKEN"}
resp = requests.get("https://supply-api.compute-desk.com/available_gpus", headers=headers)
gpu_types = resp.json().get("gpu_types", [])
print(f"Available: {gpu_types}")

const headers = { Authorization: "Bearer YOUR_TOKEN" };
const resp = await fetch("https://supply-api.compute-desk.com/available_gpus", { headers });
const { gpu_types } = await resp.json() as any;
console.log("Available:", gpu_types);

curl -X POST https://supply-api.compute-desk.com/get_offers \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/yaml" \
  -d '
compute:
  gpu_type: H100
  gpu_count: 1
  max_price_per_gpu_hour: 5
  contract_type: ondemand
'

yaml_spec = """
compute:
  gpu_type: H100
  gpu_count: 1
  max_price_per_gpu_hour: 5
  contract_type: ondemand
"""

resp = requests.post(
    "https://supply-api.compute-desk.com/get_offers",
    data=yaml_spec,
    headers={**headers, "Content-Type": "application/yaml"},
)
offers = resp.json()["offers"]
cheapest = min(offers, key=lambda o: o["gpu_price_per_hour"])
print(f"Cheapest: {cheapest['offer_id']} at ${cheapest['gpu_price_per_hour']:.4f}/GPU/hr")

const yamlSpec = `
compute:
  gpu_type: H100
  gpu_count: 1
  max_price_per_gpu_hour: 5
  contract_type: ondemand
`;

const offersResp = await fetch("https://supply-api.compute-desk.com/get_offers", {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/yaml" },
  body: yamlSpec,
});
const { offers } = await offersResp.json() as any;
const cheapest = offers.reduce((a: any, b: any) =>
  a.gpu_price_per_hour < b.gpu_price_per_hour ? a : b
);
console.log(`Cheapest: ${cheapest.offer_id} at $${cheapest.gpu_price_per_hour.toFixed(4)}/GPU/hr`);

curl -X POST https://supply-api.compute-desk.com/procure_offer \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "offer_id": "YOUR_OFFER_ID",
    "ssh_public_key": "ssh-ed25519 AAAA... your-key"
  }'

result = requests.post(
    "https://supply-api.compute-desk.com/procure_offer",
    json={
        "offer_id": cheapest["offer_id"],
        "ssh_public_key": "ssh-ed25519 AAAA... your-key",
    },
    headers=headers,
).json()
print(f"Status: {result['status']}")

const result = await fetch("https://supply-api.compute-desk.com/procure_offer", {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({
    offer_id: cheapest.offer_id,
    ssh_public_key: "ssh-ed25519 AAAA... your-key",
  }),
}).then(r => r.json()) as any;
console.log(`Status: ${result.status}`);

curl https://supply-api.compute-desk.com/offers/YOUR_OFFER_ID/status \
  -H "Authorization: Bearer $TOKEN"

import time

offer_id = cheapest["offer_id"]
while True:
    status = requests.get(
        f"https://supply-api.compute-desk.com/offers/{offer_id}/status",
        headers=headers,
    ).json()
    print(f"Status: {status['procurement_status']}")
    if status["procurement_status"] == "ready":
        instance = status["instances"][0]
        print(f"IP: {instance['external_ip']}")
        print(f"SSH: {instance['ssh_command']}")
        break
    if status["procurement_status"] == "failed":
        raise RuntimeError(status.get("failure_reason"))
    time.sleep(15)

const offerId = cheapest.offer_id;
while (true) {
  const status = await fetch(
    `https://supply-api.compute-desk.com/offers/${offerId}/status`,
    { headers }
  ).then(r => r.json()) as any;
  console.log(`Status: ${status.procurement_status}`);
  if (status.procurement_status === "ready") {
    const instance = status.instances[0];
    console.log(`IP: ${instance.external_ip}`);
    console.log(`SSH: ${instance.ssh_command}`);
    break;
  }
  if (status.procurement_status === "failed") {
    throw new Error(status.failure_reason);
  }
  await new Promise(r => setTimeout(r, 15000));
}

# List resources for this offer
curl "https://supply-api.compute-desk.com/resources?offer_id=YOUR_OFFER_ID" \
  -H "Authorization: Bearer $TOKEN"

# Delete the resource
curl -X DELETE "https://supply-api.compute-desk.com/resources/RESOURCE_ID?force=true" \
  -H "Authorization: Bearer $TOKEN"

# List resources for this offer
resources = requests.get(
    f"https://supply-api.compute-desk.com/resources?offer_id={offer_id}",
    headers=headers,
).json()["resources"]

# Delete each resource
for r in resources:
    rid = r["resource_id"]
    requests.delete(
        f"https://supply-api.compute-desk.com/resources/{rid}?force=true",
        headers=headers,
    )
    print(f"Deleted {rid}")

// List resources for this offer
const resources = await fetch(
  `https://supply-api.compute-desk.com/resources?offer_id=${offerId}`,
  { headers }
).then(r => r.json()) as any;

// Delete each resource
for (const r of resources.resources) {
  await fetch(
    `https://supply-api.compute-desk.com/resources/${r.resource_id}?force=true`,
    { method: "DELETE", headers }
  );
  console.log(`Deleted ${r.resource_id}`);
}