curl --request POST \
--url https://console.vast.ai/api/v0/network_volumes/search/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"q": {
"verified": {
"eq": true
},
"order": [
[
"storage_cost",
"asc"
]
],
"limit": 123,
"reliability2": {
"gt": 0.98
},
"inet_down": {
"gt": 100
},
"inet_up": {
"gt": 100
},
"geolocation": {
"in": [
"TW",
"SE"
]
},
"disk_bw": {
"gt": 500
},
"duration": {
"gte": 30
},
"storage_cost": {
"lte": 0.1
}
}
}
'{
"success": true,
"offers": [
{
"ask_contract_id": 123,
"disk_space": 123,
"inet_up": 123,
"inet_down": 123,
"reliability2": 123,
"verified": true,
"geolocation": "<string>",
"nw_disk_avg_bw": 123,
"nw_disk_max_bw": 123,
"nw_disk_min_bw": 123,
"start_date": 123,
"end_date": 123,
"storage_cost": 123,
"storage_cost_total": 123
}
]
}Search for available network volume offers with advanced filtering and sorting.
CLI Usage: vastai search network-volumes <query> [--order <field>]
curl --request POST \
--url https://console.vast.ai/api/v0/network_volumes/search/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"q": {
"verified": {
"eq": true
},
"order": [
[
"storage_cost",
"asc"
]
],
"limit": 123,
"reliability2": {
"gt": 0.98
},
"inet_down": {
"gt": 100
},
"inet_up": {
"gt": 100
},
"geolocation": {
"in": [
"TW",
"SE"
]
},
"disk_bw": {
"gt": 500
},
"duration": {
"gte": 30
},
"storage_cost": {
"lte": 0.1
}
}
}
'{
"success": true,
"offers": [
{
"ask_contract_id": 123,
"disk_space": 123,
"inet_up": 123,
"inet_down": 123,
"reliability2": 123,
"verified": true,
"geolocation": "<string>",
"nw_disk_avg_bw": 123,
"nw_disk_max_bw": 123,
"nw_disk_min_bw": 123,
"start_date": 123,
"end_date": 123,
"storage_cost": 123,
"storage_cost_total": 123
}
]
}API key must be provided in the Authorization header
Show child attributes
Display offers where all machines in cluster are verified
{ "eq": true }Sort fields and directions
[["storage_cost", "asc"]]Max results to return
Cluster reliability score (0-1)
{ "gt": 0.98 }Download bandwidth (MB/s)
{ "gt": 100 }Upload bandwidth (MB/s)
{ "gt": 100 }Cluster location (two letter country code)
{ "in": ["TW", "SE"] }Disk read bandwidth in MB/s
{ "gt": 500 }Maximum rental duration in days
{ "gte": 30 }Storage cost in $/GB/month
{ "lte": 0.1 }Successful search response
true
Show child attributes
Unique offer ID
Storage space in GB
Upload bandwidth (MB/s)
Download bandwidth (MB/s)
Cluster reliability score (0-1)
Cluster verification status
Geographic location
Average read bw of network disk from machines in cluster
Max read bw of network disk from machines in cluster
Min read bw of network disk from machines in cluster
start date of offer, in epoch time
end date of offer, in epoch time
storage cost in $/GB/month
total storage cost per hour for rented space