Get Available GPUs

​

Overview

​

Function Signature

def get_available_gpus() -> str

​

Input Schema

​

Response

​

API Endpoint

POST https://api.hyperbolic.xyz/v1/marketplace

​

Example Response

Available GPU Options:

Cluster: us-east-1
Node ID: node-abc123
GPU Model: NVIDIA H100
Available GPUs: 4/8
Price: $2.50/hour per GPU
----------------------------------------

Cluster: us-west-2
Node ID: node-def456
GPU Model: NVIDIA A100
Available GPUs: 2/4
Price: $1.75/hour per GPU
----------------------------------------

​

Example Usage

from hyperbolic_agentkit_core.actions import get_available_gpus

# Get all available GPU options
available_gpus = get_available_gpus()
print(available_gpus)

​

Important Notes

• Authorization key (HYPERBOLIC_API_KEY) is required for this operation
• GPU prices are returned in dollars per hour (converted from cents)
• Only non-reserved instances with available GPUs are displayed
• If no GPU instances are available, returns: “No available GPU instances found.”
• Use the cluster_name and node_name from this response when calling rent_compute

​

Response Details

• Non-reserved instances (reserved: false)
• Instances with available GPUs (gpus_available > 0)
• Instances with valid hardware specifications

• Cluster: Geographic or logical cluster identifier
• Node ID: Unique node identifier for use in rent_compute
• GPU Model: Hardware model (e.g., NVIDIA H100, A100, etc.)
• Available GPUs: Number of GPUs available out of total
• Price: Cost per GPU per hour in USD

​

Related Actions

• Rent Compute - Rent GPUs from available nodes
• Get GPU Status - Check status of your rented instances