spot

Raw spot price-change events for one instance type.

Every price change for the type in the window, with exact timestamp, availability zone and product (OS). Sorted by time. Repeated identical prices are dropped by default (include_repeats=true keeps them). Up to limit rows; when truncated is true, continue with from = next_from.

get/v1/spot/events

Request

  • Base URL: https://cloud.trycorpus.ai
  • URL: https://cloud.trycorpus.ai/v1/spot/events
  • Auth: one of:
    • API key in header PAYMENT-SIGNATURE
    • API key in header Authorization
    • API key in header X-Api-Key

Query parameters

provider'aws' | 'gcp' | 'azure' required

Cloud provider. One of aws, gcp, azure.

regionstring required
Example:us-east-1

Region slug as listed by /catalog (for example us-east-1 for AWS, us-central1 for GCP, us-east for Azure). Azure slugs map to eastus, westus2, westeurope.

instancestring required
Example:c5.large

Instance / machine / SKU type name exactly as listed by /instances (for example c5.large, n2-standard-4, D2s_v5).

fromstring date-time

Start of the window (inclusive), ISO 8601 UTC. Default: 7 days before to.

tostring date-time

End of the window (exclusive), ISO 8601 UTC. Default: now.

azstring

Restrict to one availability zone / zone id (for example use1-az1). Default: all zones.

productstring

Restrict to one product / OS string (for example Linux/UNIX, Spot, Linux). Default: all.

include_repeatsboolean

Keep events whose price equals the previous event of the same (az, product) series. Default false.

limitinteger

Maximum rows to return (1 to 10000). Default 5000.

Response

Events.

providerstring
regionstring
instancestring
fromstring date-time
tostring date-time
countinteger
truncatedboolean

True when limit was hit.

next_fromstring date-time nullable

Pass as from to continue when truncated.

Changes

No recorded changes to this operation across all 1 revision of this API.