Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
curl --request PUT \
--url https://console.vast.ai/api/v0/search/asks/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"select_cols": [
"*"
],
"q": {
"verified": {
"eq": true
},
"rentable": {
"eq": true
},
"external": {
"eq": false
},
"rented": {
"eq": false
},
"order": [
[
"dph_total",
"asc"
]
],
"type": "on-demand",
"limit": 123,
"disable_bundling": true,
"allocated_storage": 123,
"reliability2": {
"gt": 0.98
},
"num_gpus": {
"gte": 4
},
"gpu_name": {
"eq": "RTX 3090"
},
"cuda_max_good": {
"gte": 11
},
"gpu_ram": {
"gte": 24000
},
"dlperf_per_dphtotal": {
"gt": 50
},
"inet_down": {
"gt": 100
},
"inet_up": {
"gt": 100
},
"direct_port_count": {
"gt": 1
},
"geolocation": {
"in": [
"TW",
"SE"
]
},
"bw_nvlink": {
"gt": 100
},
"compute_cap": {
"gte": 700
},
"cpu_arch": {
"eq": "amd64"
},
"cpu_cores": {
"gte": 8
},
"cpu_ghz": {
"gt": 3
},
"datacenter": {
"eq": true
},
"disk_bw": {
"gt": 500
},
"dlperf": {
"gt": 20
},
"dlperf_usd": {
"gt": 10
},
"driver_version": {
"gte": "535.86.05"
},
"duration": {
"gte": 30
},
"flops_usd": {
"gt": 1
},
"gpu_arch": {
"eq": "nvidia"
},
"gpu_max_power": {
"lte": 300
},
"gpu_max_temp": {
"lte": 85
},
"gpu_mem_bw": {
"gt": 500
},
"gpu_total_ram": {
"gte": 48
},
"gpu_frac": {
"eq": 1
},
"gpu_display_active": {
"eq": false
},
"has_avx": {
"eq": true
},
"pci_gen": {
"gte": 4
},
"storage_cost": {
"lte": 0.1
},
"static_ip": {
"eq": true
},
"total_flops": {
"gt": 100
},
"ubuntu_version": {
"eq": "20.04"
},
"vms_enabled": {
"eq": false
},
"machine_id": {
"eq": 12345
}
}
}'
{
"success": true,
"offers": [
{
"id": 123,
"cuda_max_good": 123,
"num_gpus": 123,
"gpu_name": "<string>",
"pcie_bw": 123,
"cpu_cores_effective": 123,
"cpu_ram": 123,
"disk_space": 123,
"dph_total": 123,
"dlperf": 123,
"dlperf_per_dphtotal": 123,
"inet_up": 123,
"inet_down": 123,
"reliability2": 123,
"verified": true,
"rentable": true,
"rented": true,
"machine_id": 123,
"geolocation": "<string>",
"direct_port_count": 123,
"max_bid": 123,
"min_bid": 123,
"bw_nvlink": 123,
"compute_cap": 123,
"cpu_arch": "<string>",
"gpu_arch": "<string>",
"driver_version": "<string>",
"ubuntu_version": "<string>"
}
]
}
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
curl --request PUT \
--url https://console.vast.ai/api/v0/search/asks/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"select_cols": [
"*"
],
"q": {
"verified": {
"eq": true
},
"rentable": {
"eq": true
},
"external": {
"eq": false
},
"rented": {
"eq": false
},
"order": [
[
"dph_total",
"asc"
]
],
"type": "on-demand",
"limit": 123,
"disable_bundling": true,
"allocated_storage": 123,
"reliability2": {
"gt": 0.98
},
"num_gpus": {
"gte": 4
},
"gpu_name": {
"eq": "RTX 3090"
},
"cuda_max_good": {
"gte": 11
},
"gpu_ram": {
"gte": 24000
},
"dlperf_per_dphtotal": {
"gt": 50
},
"inet_down": {
"gt": 100
},
"inet_up": {
"gt": 100
},
"direct_port_count": {
"gt": 1
},
"geolocation": {
"in": [
"TW",
"SE"
]
},
"bw_nvlink": {
"gt": 100
},
"compute_cap": {
"gte": 700
},
"cpu_arch": {
"eq": "amd64"
},
"cpu_cores": {
"gte": 8
},
"cpu_ghz": {
"gt": 3
},
"datacenter": {
"eq": true
},
"disk_bw": {
"gt": 500
},
"dlperf": {
"gt": 20
},
"dlperf_usd": {
"gt": 10
},
"driver_version": {
"gte": "535.86.05"
},
"duration": {
"gte": 30
},
"flops_usd": {
"gt": 1
},
"gpu_arch": {
"eq": "nvidia"
},
"gpu_max_power": {
"lte": 300
},
"gpu_max_temp": {
"lte": 85
},
"gpu_mem_bw": {
"gt": 500
},
"gpu_total_ram": {
"gte": 48
},
"gpu_frac": {
"eq": 1
},
"gpu_display_active": {
"eq": false
},
"has_avx": {
"eq": true
},
"pci_gen": {
"gte": 4
},
"storage_cost": {
"lte": 0.1
},
"static_ip": {
"eq": true
},
"total_flops": {
"gt": 100
},
"ubuntu_version": {
"eq": "20.04"
},
"vms_enabled": {
"eq": false
},
"machine_id": {
"eq": 12345
}
}
}'
{
"success": true,
"offers": [
{
"id": 123,
"cuda_max_good": 123,
"num_gpus": 123,
"gpu_name": "<string>",
"pcie_bw": 123,
"cpu_cores_effective": 123,
"cpu_ram": 123,
"disk_space": 123,
"dph_total": 123,
"dlperf": 123,
"dlperf_per_dphtotal": 123,
"inet_up": 123,
"inet_down": 123,
"reliability2": 123,
"verified": true,
"rentable": true,
"rented": true,
"machine_id": 123,
"geolocation": "<string>",
"direct_port_count": 123,
"max_bid": 123,
"min_bid": 123,
"bw_nvlink": 123,
"compute_cap": 123,
"cpu_arch": "<string>",
"gpu_arch": "<string>",
"driver_version": "<string>",
"ubuntu_version": "<string>"
}
]
}
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.