GET /v0/quote — san-francisco-compute-documentation

Quoter

get/v0/quote

Query parameters

sidestring required

Order side: buy or sell

quantityinteger required

Number of nodes (1-1024)

instance_typestring

Instance type for buy orders (h100i, h100v, h200ki)

clusterstring

Cluster constraint (hostname)

colocate_withstring

Contract ID to colocate with

durationinteger

Exact duration in seconds (mutually exclusive with min/max, minimum 3600)

min_durationinteger

Min duration in seconds (minimum 3600, requires max_duration)

max_durationinteger

Max duration in seconds (requires min_duration)

min_start_datestring

Min start date: 'NOW' or ISO8601

max_start_datestring

Max start date: 'NOW' or ISO8601

Response

Quote retrieved

objectstring required

Always "quote"

sidestring required

Matches the requested side: "buy" or "sell"

no_quote_reason'no_matching_clusters' | 'no_availability' | 'bid_price_too_low' | 'ask_price_too_high' | 'internal_solver_error'

Reason why a quote could not be provided.

Example response

{
  "quote": {
    "start_at": "NOW",
    "end_at": "NOW"
  }
}

Changes

Changed in 2 of the 44 revisions of this API.118

Dec 19, 202503edf542ab391See the full diff
- ○
  added the optional property no_quote_reason to the response with the 200 status
  response-optional-property-added
Dec 6, 20257284b205c8d1117See the full diff
- ▲
  the quote/oneOf[quoter_ApiQuoteDetails]/ response's property type/format changed from / to object/ for status 200
  response-property-type-changed
- ●
  deleted the query request parameter contract_id
  request-parameter-removed
- ○
  removed subschema #1 subschema #2 from the quote/oneOf[quoter_ApiQuoteDetails]/ response property oneOf list for the response status 200
  response-property-one-of-removed
- ○
  added the required property quote/oneOf[quoter_ApiQuoteDetails]/end_at to the response with the 200 status
  response-required-property-added
- ○
  added the required property quote/oneOf[quoter_ApiQuoteDetails]/instance_type to the response with the 200 status
  response-required-property-added
- ○
  added the required property quote/oneOf[quoter_ApiQuoteDetails]/price to the response with the 200 status
  response-required-property-added
- ○
  added the required property quote/oneOf[quoter_ApiQuoteDetails]/quantity to the response with the 200 status
  response-required-property-added
- ○
  added the required property quote/oneOf[quoter_ApiQuoteDetails]/start_at to the response with the 200 status
  response-required-property-added
- ○
  added the required property quote/oneOf[quoter_ApiQuoteDetails]/zone to the response with the 200 status
  response-required-property-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history