Spot Market Requests Management. Check out the product docs to learn more about Spot Market features.

Create a spot market request


Creates a new spot market request.

Type-specific options (such as operating_system for baremetal devices) should be included in the main data structure alongside hostname and plan.

The features attribute allows you to optionally specify what features your server should have. For example, if you require a server with a TPM chip, you may specify { "features": { "tpm": "required" } } (or { "features": ["tpm"] } in shorthand).

The request will fail if there are no available servers matching your criteria. Alternatively, if you do not require a certain feature, but would prefer to be assigned a server with that feature if there are any available, you may specify that feature with a preferred value (see the example request below).

The request will not fail if we have no servers with that feature in our inventory.

  • Parameters
  • id
    string  (required) in path

    Project UUID

     (required) in body

    Spot Market Request to create

        "instance_attributes": "object",
        "devices_min": "integer",
        "devices_max": "integer",
        "max_bid_price": "number",
        "end_at": "string",
        "facilities": [

List spot market requests


View all spot market requests for a given project.

Retrieve a spot market request


Returns a single spot market request

  • Parameters
  • id
    string  (required) in path

    SpotMarketRequest UUID

    string in query

    related attributes to include

  • Response Body Show Hide
  • Request URL Show Hide
  • cURL Show Hide

Delete the spot market request


Deletes the spot market request.

  • Parameters
  • id
    string  (required) in path

    SpotMarketRequest UUID

    boolean in query

    Terminate associated spot instances