Skip to main content
GET
Quote a bid
CLI equivalent, a market bid for nodes: ornn market quote --gpu-slug <gpu-slug> --nodes 2. A quote places nothing. Read it immediately before placing a bid to check each node’s price and its estimated interruption time.

Authorizations

Authorization
string
header
required

Create an organization API key in Account Settings > Developer. Do not send this key to the Kubernetes API server.

Path Parameters

gpuSlug
string
required

Catalog GPU slug of the order book, from List order books.

Query Parameters

saleType
enum<string>
default:spot

spot (the default): a reservation on the node can end the VM. on-demand: only you, the seller or the listing's end ends it.

Available options:
spot,
on-demand
region
string

A region with an order book, for example us-east-11 (see GET /v1/markets/books). Omit for every location.

gpus
integer

GPUs, one or more, taken from the lowest asks first; one node can supply part of them. Send this or nodes, not both.

Required range: x >= 1
nodes
integer

Nodes, one or more, with orderType market. Each node taken gives every GPU free on it, as one or more VMs. Send this or gpus, not both.

Required range: x >= 1
orderType
enum<string>
required

limit or market.

Available options:
limit,
market
pricePerGpuHourMicroUsd
integer<int64>

Required for limit: the most you would pay per GPU-hour, fees included.

Required range: x >= 1

Response

The nodes the bid would take now.

gpuSlug
string
required
saleType
enum<string>
required

spot: a reservation on the node can end the VM. on-demand: only a stop or the listing's end ends it.

Available options:
spot,
on-demand
region
string | null
required

The location quoted; null for any location.

nodes
object[]
required

One entry per node the bid would take now, in order, with the GPUs it would take there. Fewer GPUs or nodes than requested means the rest would rest (limit) or be cancelled (market).