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