{"uid":"cap_V2hmgw9rBuWtU3C8JxIhn","slug":"corpusai-cloud-pricing-spot-instance-hourly-price-history-32fd0f11","name":"corpusAI Cloud Pricing: Spot Instance Hourly Price History","description":"corpusAI Cloud Pricing: Hourly time-weighted OHLC bars for one instance type.","url":"https://cloud.trycorpus.ai/v1/spot/hourly?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":{"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: 30 days before `to`."},"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`."},"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`."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"to":{"type":"string","format":"date-time"},"bars":{"type":"array","items":{"type":"object","required":["hour","open","high","low","close","avg"],"properties":{"avg":{"type":"number","description":"Time-weighted average price over the bucket (median across AZs). This is the value the public dashboard shows."},"dur":{"type":"integer","description":"Seconds of the bucket covered by known prices (a partial value means the series starts or ends inside the bucket)."},"low":{"type":"number","description":"Lowest price seen in any AZ during the bucket."},"high":{"type":"number","description":"Highest price seen in any AZ during the bucket."},"hour":{"type":"string","description":"Bucket start, ISO 8601 UTC hour."},"open":{"type":"number","description":"Price in force at the start of the bucket, USD per hour (median across AZs)."},"close":{"type":"number","description":"Price in force at the end of the bucket (median across AZs)."}}}},"from":{"type":"string","format":"date-time"},"count":{"type":"integer"},"zones":{"type":"integer","description":"Number of zone series collapsed."},"region":{"type":"string"},"instance":{"type":"string"},"provider":{"type":"string"}}}}}}},"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_Q1CDRLfXgePCbnF8d84QJ","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 hourly OHLC (open/high/low/close/avg) spot price bars for a specific AWS, GCP, or Azure instance type in a given region over a specified time window.","exampleAgentPrompt":"Pull the hourly spot price history for AWS c5.large in us-east-1 from corpusAI Cloud Pricing for the last 30 days so I can see how prices have moved.","exampleUseCases":[{"title":"Spot price trend for cost forecasting","prompt":"Can you get me the hourly spot price bars for a GCP n2-standard-4 instance in us-central1 over the past 30 days? I want to see the open, high, low, and average prices to forecast my cloud costs."},{"title":"AWS vs Azure spot price comparison","prompt":"Fetch the last 30 days of hourly spot pricing history for AWS c5.large in us-east-1 and Azure D2s_v5 in eastus so I can compare which one is cheaper on average."},{"title":"Spot price volatility monitoring","prompt":"I need to check how volatile spot prices have been for AWS p3.2xlarge in us-east-1 over the past week — can you pull the hourly high and low prices from corpusAI Cloud Pricing so I can see the spread?"}],"resultDescription":"Returns a JSON object containing an array of hourly price bars for the requested cloud instance, each bar including: hour timestamp, open, high, low, close, and time-weighted average (avg) prices in USD, plus a duration field indicating how many seconds of price data are covered in that bucket. Also includes the end-of-window timestamp.","failureModes":["Missing required parameters (provider, region, instance) returns a 4xx validation error","Invalid provider enum value (not aws/gcp/azure) causes a bad request error","Instance type name not matching catalog returns empty results or 404","Region slug not matching provider-specific format causes lookup failure","Payment not completed in USDC via x402 results in 402 Payment Required","Time window with no available price data returns empty bars array","Date format not ISO 8601 UTC causes parsing error"],"whenToPreferThis":"Use this endpoint when you need granular hourly spot price history for a specific AWS, GCP, or Azure instance in a specific region, especially for time-series analysis, cost optimization, volatility assessment, or FinOps dashboards. Prefer this over general cloud pricing APIs when you need OHLC-style bar data with per-AZ high/low breakdowns and historical coverage back to 2014. It is particularly strong for agents doing infrastructure cost forecasting or arbitrage between cloud providers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:44:08.262Z","isFirstParty":false,"canonicalSlug":"corpusai-cloud-pricing-spot-instance-hourly-price-history-32fd0f11"}