# corpusAI Cloud Pricing: Reserved Instance Price History

> corpusAI Cloud Pricing: Reserved Instance Price History is a paid API for AI agents from cloud.trycorpus.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12).

Returns the historical reserved instance (RI/CUD) pricing time series for a specific instance type and region across AWS, Azure, or GCP.

## Facts

- Endpoint: GET https://cloud.trycorpus.ai/v1/reserved?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/corpusai-cloud-pricing-reserved-instance-price-history-62a86e03
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_knOsiST-2Z0Fy35mYYn8g

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability corpusai-cloud-pricing-reserved-instance-price-history-62a86e03
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

corpusAI Cloud Pricing: Reserved / reservation price history of one instance type (AWS standard RIs 1y/3y no-upfront/all-upfront; Azure reservations 1y/3y).

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
  
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/corpusai-cloud-pricing-reserved-instance-price-history-62a86e03/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cloud.trycorpus.ai](https://www.zero.xyz/host/cloud.trycorpus.ai/llms.txt)