Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vast.ai/llms.txt

Use this file to discover all available pages before exploring further.

Show geographic distribution of GPUs on the marketplace
This is a host command, used for managing machines you are renting out on Vast.ai.

​
Usage

vastai metrics gpu-locations [OPTIONS]

​
Options

​
--verified
string
Filter by verification status (true, false, or all). Defaults to all.
​
--datacenter
string
Filter by datacenter hosting type (true, false, or all). Defaults to all.
​
--gpu
string
Comma-separated GPU names to filter by (e.g. "RTX 4090, H100_SXM")
​
--rented
string
Filter by rental status (true, false, or all). Defaults to all.

​
Description

Returns the geographic distribution of GPUs across the Vast marketplace. Filtering is applied locally after fetching the dataset, so filter combinations do not affect server performance.

​
Examples

# All locations, unfiltered
vastai metrics gpu-locations

# Datacenter-verified only
vastai metrics gpu-locations --verified true --datacenter true

# Specific GPU types
vastai metrics gpu-locations --gpu "RTX 4090, H100_SXM"

# Only unrented GPUs
vastai metrics gpu-locations --rented false

# JSON output
vastai metrics gpu-locations --raw

​
Global Options

The following options are available for all commands:
OptionDescription
--url URLServer REST API URL
--retry NRetry limit
--rawOutput machine-readable JSON
--explainVerbose explanation of API calls
--api-key KEYAPI key (defaults to ~/.config/vastai/vast_api_key)