Vast.ai API

search offers

1min

PUT
https://console.vast.ai/api/v0/search/asks/
Production server
Search for available GPU machine offers with advanced filtering and sorting.
Default filters applied unless --no-default: - verified: true - external: false - rentable: true - rented: false
CLI Usage Examples: vast search offers 'reliability > 0.99 num_gpus>=4' vast search offers 'gpu_name=RTX_3090' --order=dph_total vast search offers 'cuda_vers>=11.0' --no-default
Authentication
BearerAuth
http
Body Parameters
body
object
*
select_cols
string[]
q
object
Responses
200
Successful search response
object
success
boolean
offers
object[]
400
Bad request - invalid query parameters
Error
success
boolean
error
string
msg
string
401
Unauthorized - invalid or missing API key
Error
success
boolean
error
string
msg
string
429
Too many requests
Error
success
boolean
error
string
msg
string
﻿
﻿

search benchmarks

search invoices

Docs powered by Archbee

Curl

Ruby

Python

curl --location --request PUT 'https://console.vast.ai/api/v0/search/asks/' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'

Responses

200

400

401

429

// Successful search response 
{
  "success": true,
  "offers": [
    {
      "id": 0,
      "cuda_max_good": 0,
      "num_gpus": 0,
      "gpu_name": "",
      "pcie_bw": 0,
      "cpu_cores_effective": 0,
      "cpu_ram": 0,
      "disk_space": 0,
      "dph_total": 0,
      "dlperf": 0,
      "dlperf_per_dphtotal": 0,
      "inet_up": 0,
      "inet_down": 0,
      "reliability2": 0,
      "verified": false,
      "rentable": false,
      "rented": false,
      "machine_id": 0,
      "geolocation": "",
      "direct_port_count": 0,
      "max_bid": 0,
      "min_bid": 0,
      "bw_nvlink": 0,
      "compute_cap": 0,
      "cpu_arch": "",
      "gpu_arch": "",
      "driver_version": "",
      "ubuntu_version": ""
    }
  ]
}

// Successful search response 
{
  "success": true,
  "offers": [
    {
      "id": 0,
      "cuda_max_good": 0,
      "num_gpus": 0,
      "gpu_name": "",
      "pcie_bw": 0,
      "cpu_cores_effective": 0,
      "cpu_ram": 0,
      "disk_space": 0,
      "dph_total": 0,
      "dlperf": 0,
      "dlperf_per_dphtotal": 0,
      "inet_up": 0,
      "inet_down": 0,
      "reliability2": 0,
      "verified": false,
      "rentable": false,
      "rented": false,
      "machine_id": 0,
      "geolocation": "",
      "direct_port_count": 0,
      "max_bid": 0,
      "min_bid": 0,
      "bw_nvlink": 0,
      "compute_cap": 0,
      "cpu_arch": "",
      "gpu_arch": "",
      "driver_version": "",
      "ubuntu_version": ""
    }
  ]
}