PUT
/
api
/
v0
/
search
/
asks
/
search offers
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>"
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
select_cols
string[]

Columns to select, defaults to all

Example:
["*"]
q
object

Response

Successful search response

success
boolean
Example:

true

offers
object[]