GET /api/v1/compute — Discover Compute Hosts - nodepick.ai Documentation

The Compute Discovery API allows developers to search available bare metal compute hosts, query capacity and specifications (CPU, RAM, GPU, storage), and evaluate real-time hourly and monthly pricing.

Endpoint

GET https://api.nodepick.ai/api/v1/compute

Authentication: Public access (optional Bearer token)

Query Parameters

Parameter	Type	Required	Description
`min_cpu`	number	No	Minimum CPU cores required. Defaults to `1`.
`min_memory_gb`	number	No	Minimum system RAM in GiB required. Defaults to `1`.
`min_storage_gb`	number	No	Minimum disk storage in GiB required. Defaults to `10`.
`region`	string	No	Filter by target region or datacenter (e.g. `us-west-1`, `fmt1`).
`datacenter`	string	No	Filter by datacenter facility code (e.g. `fmt1`).
`status`	string	No	Host status: `"active"` (ready for immediate deployment), `"reserved"`, or `"all"`. Default: `"all"`.
`gpu`	boolean	No	Require dedicated GPU (`true`) or CPU-only (`false`).
`page`	number	No	1-based page number when paginating.
`limit`	number	No	Number of hosts per page (max `200`).

Response

Returns matching hosts with pre-calculated DRF slice pricing:

{
  "hosts": [
    {
      "id": "cf848acc-ad75-4cfc-ba16-28f25630becb",
      "status": "active",
      "region": "us-west-1",
      "datacenter": "fmt1",
      "os": "Ubuntu 26.04 LTS",
      "hostname": "fmt1-sr1",
      "cpu": {
        "cores": 24,
        "architecture": "x86_64"
      },
      "memory_gb": 31.8,
      "storage_gb": 548,
      "gpu": {
        "count": 0
      },
      "pricing": {
        "hourly": "0.0060",
        "monthly": "4.41",
        "currency": "USD"
      }
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 1,
    "total_pages": 1,
    "has_more": false
  }
}

Python SDK

from nodepick import NodePickClient

client = NodePickClient(api_key="YOUR_API_KEY")

hosts = client.find_compute(
    min_cpu=2,
    min_memory_gb=4.0,
    min_storage_gb=20,
    max_price=30.0,
    region="us-west-1",
    status="active",
)

for host in hosts:
    print(host["id"], host["pricing"]["monthly"])