nodes endpoints

browse available compute nodes

GET

/nodes

list available compute nodes

query parameters

statusstring - online, offline, maintenance

hasGpuboolean - filter by gpu availability

minGpuVramnumber - minimum vram in mb

minCpuCoresnumber - minimum cpu cores

minRamMbnumber - minimum ram in mb

regionstring - filter by region

maxHourlyRatenumber - max rate in cents

pagenumber (default: 1)

limitnumber (default: 20)

response

{
  "nodes": [
    {
      "id": "node_abc123",
      "name": "GPU Server 1",
      "status": "online",
      "specs": {
        "cpuModel": "AMD Ryzen 9 5950X",
        "cpuCores": 16,
        "cpuThreads": 32,
        "ramMb": 65536,
        "diskGb": 2000,
        "diskType": "nvme"
      },
      "gpus": [
        {
          "name": "NVIDIA RTX 4090",
          "vramMb": 24576,
          "cudaVersion": "12.3"
        }
      ],
      "region": "us-east",
      "country": "US",
      "hourlyRateCents": 150,
      "activeDeployments": 2,
      "maxDeployments": 5,
      "uptimePercent": 99.5
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 45,
    "totalPages": 3
  }
}

GET

/nodes/:id

get node details by id

response

{
  "node": {
    "id": "node_abc123",
    "operatorId": "op_xyz789",
    "name": "GPU Server 1",
    "status": "online",
    "specs": {
      "cpuModel": "AMD Ryzen 9 5950X",
      "cpuCores": 16,
      "cpuThreads": 32,
      "ramMb": 65536,
      "diskGb": 2000,
      "diskType": "nvme",
      "networkSpeedMbps": 1000,
      "os": "Ubuntu 22.04",
      "dockerVersion": "24.0.7"
    },
    "gpus": [
      {
        "name": "NVIDIA RTX 4090",
        "brand": "nvidia",
        "vramMb": 24576,
        "cudaCores": 16384,
        "tensorCores": 512,
        "cudaVersion": "12.3",
        "driverVersion": "545.23.08"
      }
    ],
    "region": "us-east",
    "country": "US",
    "hourlyRateCents": 150,
    "activeDeployments": 2,
    "maxDeployments": 5,
    "uptimePercent": 99.5,
    "lastHeartbeat": "2024-01-15T10:30:00Z"
  }
}

available regions

us-eastunited states - east coast

us-westunited states - west coast

eu-westeurope - western

eu-centraleurope - central

asia-eastasia - east

asia-southasia - south