Rentals

The rental is the core resource. You create one to provision a GPU, poll it until the tunnel is up, then delete it to stop the meter.

A rental ties together a listing, one of your SSH keys, and an optional spend cap. Creating it kicks off provisioning on the cheapest acceptable cloud. The box boots, injects your public key, and dials home to open a reverse SSH tunnel to gpu.ipxtechholding.com. Once that tunnel connects, a connection_string appears and the per-second meter starts. Deleting the rental tears the box down and stops billing.

The rental object

Every endpoint returns the same shape. Money is expressed in micro-USD, where 1000000 equals one dollar.

Lifecycle

A rental moves through three states. You will only ever see these values in the state field.

1. provisioning_requested

   The state right after POST. We have picked a box and are booting it, injecting your key, and waiting for it to dial home. connection_string is null and nothing is billing yet.

2. active_connected

   The reverse tunnel is up. connection_string is populated and the per-second meter is running. This is when you SSH in and work.

3. terminated

   The box has been torn down, either by your DELETE call or because the spend cap was reached. The meter has stopped. connection_string returns to null.

Create a rental

Provisions a GPU from a listing and starts the lifecycle. Returns the new rental in provisioning_requested with a null connection string.

$ curl -s -X POST https://gpu.ipxtechholding.com/api/v1/rentals \\
    -H "Authorization: Bearer $IPX_TOKEN" \\
    -H "Content-Type: application/json" \\
    -d '{
      "gpu_listing_id": 4271,
      "customer_ssh_key_id": 88,
      "max_cost_micro_usd": 5000000
    }'

{
  "id": 9012,
  "state": "provisioning_requested",
  "gpu_name": "RTX 4090",
  "vram_gb": 24,
  "price_micro_usd_per_hour": 680000,
  "accumulated_cost_micro_usd": 0,
  "max_cost_micro_usd": 5000000,
  "connection_string": null,
  "created_at": "2026-06-24T17:02:11Z"
}

Retrieve a rental

Fetches the current state of one rental. This is the endpoint you poll while waiting for the tunnel.

$ curl -s https://gpu.ipxtechholding.com/api/v1/rentals/9012 \\
    -H "Authorization: Bearer $IPX_TOKEN"

{
  "id": 9012,
  "state": "active_connected",
  "gpu_name": "RTX 4090",
  "vram_gb": 24,
  "price_micro_usd_per_hour": 680000,
  "accumulated_cost_micro_usd": 11333,
  "max_cost_micro_usd": 5000000,
  "connection_string": "ssh -p 20137 root@gpu.ipxtechholding.com",
  "created_at": "2026-06-24T17:02:11Z"
}

# poll every 3s until the tunnel is up
$ until curl -s https://gpu.ipxtechholding.com/api/v1/rentals/9012 \\
    -H "Authorization: Bearer $IPX_TOKEN" \\
    | grep -q '"state":"active_connected"'; do sleep 3; done

# the connection_string points only at IPX
$ ssh -p 20137 root@gpu.ipxtechholding.com
root@gpu:~# nvidia-smi

Terminate a rental

Tears the box down and stops the meter. Returns the rental in its final terminated state. The reason recorded is customer requested.

$ curl -s -X DELETE https://gpu.ipxtechholding.com/api/v1/rentals/9012 \\
    -H "Authorization: Bearer $IPX_TOKEN"

{
  "id": 9012,
  "state": "terminated",
  "gpu_name": "RTX 4090",
  "vram_gb": 24,
  "price_micro_usd_per_hour": 680000,
  "accumulated_cost_micro_usd": 47600,
  "max_cost_micro_usd": 5000000,
  "connection_string": null,
  "created_at": "2026-06-24T17:02:11Z"
}

Next steps