{"uid":"cap_knOsiST-2Z0Fy35mYYn8g","slug":"corpusai-cloud-pricing-reserved-instance-price-history-62a86e03","name":"corpusAI Cloud Pricing: Reserved Instance Price History","description":"corpusAI Cloud Pricing: Reserved / reservation price history of one instance type (AWS standard RIs 1y/3y no-upfront/all-upfront; Azure reservations 1y/3y).","url":"https://cloud.trycorpus.ai/v1/reserved?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":["region","instance"],"properties":{"region":{"type":"string","examples":["us-east-1"],"description":"Region slug (for example `us-east-1`, `us-east` for Azure, `us-central1` for GCP)."},"ri_type":{"enum":["ri_1y_no_upfront_standard","ri_1y_all_upfront_standard","ri_3y_no_upfront_standard","ri_3y_all_upfront_standard","cud_1y","cud_3y"],"type":"string","description":"Restrict to one ri_type."},"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","azure","gcp"],"type":"string","default":"aws","description":"Provider: `aws` (default), `azure` or `gcp`."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"note":{"type":"string"},"region":{"type":"string"},"series":{"type":"array","items":{"type":"object","properties":{"count":{"type":"integer"},"changes":{"type":"array","items":{"type":"object","required":["date","price"],"properties":{"date":{"type":"string","format":"date","description":"Day the price took effect."},"price":{"type":"number","description":"USD per hour."}}}},"current":{"type":"object","required":["date","price"],"properties":{"date":{"type":"string","format":"date","description":"Day the price took effect."},"price":{"type":"number","description":"USD per hour."}}},"ri_type":{"type":"string"}}}},"instance":{"type":"string"},"provider":{"type":"string","const":"aws"}}}}}}},"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_34Z8_EGfQ_jQlG3DAIH4E","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 the historical reserved instance (RI/CUD) pricing time series for a specific instance type and region across AWS, Azure, or GCP.","exampleAgentPrompt":"What's the full price history for AWS reserved instances on a c5.large in us-east-1 — specifically the 1-year no-upfront standard RI — and when did the price last change?","exampleUseCases":[{"title":"Cloud cost audit for FinOps team","prompt":"Pull the complete reserved instance price history for an AWS c5.large in us-east-1, including every price change since it was launched, so I can benchmark our current contract against historical rates."},{"title":"GCP committed use discount trend analysis","prompt":"Show me the 1-year CUD pricing history for a GCP n2-standard-4 in us-central1 — I want to see how prices have trended and what the current rate is."},{"title":"Azure reserved instance price comparison","prompt":"Get me the historical 3-year all-upfront reserved instance prices for an Azure D2s_v5 in the us-east region so I can see how much they've shifted over time."}],"resultDescription":"A JSON object containing the provider, region, instance type, and a series array of reserved instance pricing records. Each series entry includes the ri_type, the current price (USD/hr) with its effective date, a count of historical changes, and an array of all past price changes with their effective dates and prices.","failureModes":["Missing required 'instance' or 'region' query parameters returns a 400 error","Invalid instance type name (not matching provider's exact SKU) returns empty or error response","Invalid region slug for the selected provider returns no data","Unsupported ri_type enum value returns a validation error","Payment failure over x402 (insufficient USDC) blocks the request","Rate limiting if too many requests are made in succession"],"whenToPreferThis":"Use this endpoint when you need granular historical reserved instance or committed use discount (CUD) pricing data for a specific instance type and region on AWS, GCP, or Azure — especially for FinOps analysis, contract benchmarking, or cost trend monitoring. Prefer this over on-demand pricing endpoints when the user specifically asks about reserved, committed, or long-term pricing contracts. It covers data back to 2014, making it uniquely suited for long-horizon trend analysis that cloud provider APIs themselves don't expose historically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T01:35:52.250Z","isFirstParty":false,"canonicalSlug":"corpusai-cloud-pricing-reserved-instance-price-history-62a86e03"}