{"uid":"cap_Mca204l-j4UeIIgC9BSbd","slug":"corpusai-cloud-spot-pricing-monthly-historical-prices-17368c97","name":"corpusAI Cloud Spot Pricing: Monthly Historical Prices","description":"corpusAI Cloud Pricing: Full monthly history for one instance type, back to 2014 for legacy AWS types.","url":"https://cloud.trycorpus.ai/v1/spot/monthly?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","description":"Last month (inclusive), YYYY-MM-DD. Default: latest."},"from":{"type":"string","format":"date","description":"First month (inclusive), YYYY-MM-DD (use the 1st). Default: earliest."},"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`."},"include_archive":{"type":"boolean","default":true,"description":"Include the raw USC/ISI archive rows in `archive`. Default true."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"count":{"type":"integer"},"months":{"type":"array","items":{"type":"object","required":["date","avg","source"],"properties":{"avg":{"type":"number","description":"Median of the month's daily averages (or the adjusted archive value), USD per hour."},"low":{"type":["number","null"]},"date":{"type":"string","format":"date","description":"First day of the month."},"days":{"type":["integer","null"],"description":"Days of daily data behind the month; null for uscisi-adjusted months."},"high":{"type":["number","null"]},"open":{"type":["number","null"]},"close":{"type":["number","null"]},"source":{"enum":["direct","titans","pauley","uscisi-adjusted","archive"],"type":"string","description":"Where a row comes from; see `sources` in /catalog for the legend and standing of each."}}}},"region":{"type":"string"},"archive":{"type":"array","items":{"type":"object","properties":{"avg":{"type":"number"},"low":{"type":"number"},"date":{"type":"string","format":"date"},"high":{"type":"number"},"open":{"type":"number"},"close":{"type":"number"}}},"description":"Raw USC/ISI archive months (AWS legacy types only), unadjusted."},"instance":{"type":"string"},"provider":{"type":"string"},"archive_note":{"type":"string","description":"Standing of the archive rows."}}}}}}},"responseSchema":{"type":"json","example":{}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iWaOLF8BfccFTpaHsfeTa","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns monthly historical spot instance prices for a specific AWS, GCP, or Azure instance type in a given region, from 2014 to present.","exampleAgentPrompt":"Pull the monthly spot price history for the AWS c5.large instance in us-east-1 from January 2021 through December 2023 so I can see how prices have trended.","exampleUseCases":[{"title":"Cloud cost trend analysis for FinOps","prompt":"Can you show me the monthly spot price history for the AWS c5.large in us-east-1 from 2019 to now? I want to see how prices have changed year over year so I can plan our cloud budget."},{"title":"Cheapest region selection for workloads","prompt":"I'm trying to figure out which region has historically had the cheapest GCP n2-standard-4 spot prices — can you pull the monthly price history for us-central1 going back to 2018?"},{"title":"Vendor pricing comparison for procurement","prompt":"Get me the monthly spot instance price history for Azure D2s_v5 in eastus from January 2022 to December 2023 — I need to understand how Azure pricing has evolved before renewing our contract."}],"resultDescription":"A JSON array of monthly records for the requested instance, each containing the date (first of month), median average price in USD/hr, high, low, open, close prices, number of days of underlying daily data, and optionally raw USC/ISI archive rows. Also includes a count of total months returned.","failureModes":["Missing required query parameters (provider, region, instance) returns a 400 error","Invalid region slug or instance name not found in /catalog or /instances returns an error or empty result","Date range with no available data returns an empty months array","Payment not completed (x402 payment required) returns a 402 response","Network timeout or service unavailability returns a 5xx error"],"whenToPreferThis":"Choose this endpoint when you need time-series monthly spot pricing data for a specific cloud instance type on AWS, GCP, or Azure, particularly for trend analysis, cost modeling, or procurement decisions. It is uniquely valuable for historical depth (back to 2014) and covers the major hyperscalers. Prefer it over real-time pricing APIs when you need trend data rather than current prices, and over generic cost-management tools when you need raw per-instance monthly price series.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:34:32.409Z","isFirstParty":false,"canonicalSlug":"corpusai-cloud-spot-pricing-monthly-historical-prices-17368c97"}