{"uid":"cap_bjvkQKRuph0xRdX6eSdjm","slug":"corpusai-cloud-pricing-spot-price-events-6d0442d3","name":"corpusAI Cloud Pricing – Spot Price Events","description":"corpusAI Cloud Pricing: Raw spot price-change events for one instance type.","url":"https://cloud.trycorpus.ai/v1/spot/events?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["provider","region","instance"],"properties":{"az":{"type":"string","description":"Restrict to one availability zone / zone id (for example `use1-az1`). Default: all zones."},"to":{"type":"string","format":"date-time","description":"End of the window (exclusive), ISO 8601 UTC. Default: now."},"from":{"type":"string","format":"date-time","description":"Start of the window (inclusive), ISO 8601 UTC. Default: 7 days before `to`."},"limit":{"type":"integer","default":5000,"maximum":10000,"minimum":1,"description":"Maximum rows to return (1 to 10000). Default 5000."},"region":{"type":"string","examples":["us-east-1"],"description":"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`."},"product":{"type":"string","description":"Restrict to one product / OS string (for example `Linux/UNIX`, `Spot`, `Linux`). Default: all."},"instance":{"type":"string","examples":["c5.large"],"description":"Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`)."},"provider":{"enum":["aws","gcp","azure"],"type":"string","description":"Cloud provider. One of `aws`, `gcp`, `azure`."},"include_repeats":{"type":"boolean","default":false,"description":"Keep events whose price equals the previous event of the same (az, product) series. Default false."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"to":{"type":"string","format":"date-time"},"from":{"type":"string","format":"date-time"},"count":{"type":"integer"},"events":{"type":"array","items":{"type":"object","required":["ts","az","product","price"],"properties":{"az":{"type":"string","description":"Availability zone or zone id; the region name for GCP."},"ts":{"type":"string","format":"date-time","description":"When the price took effect (UTC)."},"price":{"type":"number","description":"USD per hour."},"product":{"type":"string","description":"Product / OS the price applies to."}}}},"region":{"type":"string"},"instance":{"type":"string"},"provider":{"type":"string"},"next_from":{"type":["string","null"],"format":"date-time","description":"Pass as `from` to continue when truncated."},"truncated":{"type":"boolean","description":"True when `limit` was hit."}}}}}}},"responseSchema":{"type":"json","example":{}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2a2mIYsBfWIR62-J48_Hu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns time-series spot price change events for a specific cloud instance type (AWS, GCP, or Azure) over a given time window","exampleAgentPrompt":"Pull the spot price change events for AWS c5.large in us-east-1 over the last 7 days — just Linux/UNIX product, up to 5000 rows.","exampleUseCases":[{"title":"Cloud cost spike investigation","prompt":"Show me all spot price events for AWS m5.xlarge in us-east-1 from January 1 to January 31 2024 so I can see when prices spiked above normal."},{"title":"Cheapest availability zone selection","prompt":"Get spot price history for GCP n2-standard-4 in us-central1 broken down by availability zone for the last 14 days — I want to see which zone has been consistently cheapest."},{"title":"Azure spot instance budget planning","prompt":"Fetch the last 30 days of spot price change events for Azure D4s_v5 in the us-east region so I can estimate what our monthly compute spend would look like."}],"resultDescription":"A JSON object containing a time-windowed list of spot price change events for the requested instance, with fields for timestamp, price, availability zone, product/OS, event count, and the queried from/to window boundaries. Up to 10,000 rows per request, defaulting to 5,000.","failureModes":["Missing required parameters (provider, region, instance) returns a 400 error","Invalid provider enum value returns a 400 validation error","Unrecognized instance type or region slug returns empty results or 404","Time window too broad returning truncated results at row limit","Payment failure via x402 returns 402 Payment Required","Rate limiting or quota exceeded returns 429"],"whenToPreferThis":"Use this endpoint when you need granular, time-series spot price change events for a specific cloud instance type — not just current prices. It is ideal for cost trend analysis, spike detection, and AZ-level price comparison across AWS, GCP, and Azure. Prefer this over static pricing APIs when you need historical depth (back to 2014 for major clouds) or when building cost optimization workflows that respond to price changes over time.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:44:26.898Z","isFirstParty":false,"canonicalSlug":"corpusai-cloud-pricing-spot-price-events-6d0442d3"}