# corpusAI Cloud Spot Pricing: Monthly Historical Prices

> corpusAI Cloud Spot Pricing: Monthly Historical Prices is a paid API for AI agents from cloud.trycorpus.ai, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-10).

Returns monthly historical spot instance prices for a specific AWS, GCP, or Azure instance type in a given region, from 2014 to present.

## Facts

- Endpoint: GET https://cloud.trycorpus.ai/v1/spot/monthly?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/corpusai-cloud-spot-pricing-monthly-historical-prices-17368c97
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Mca204l-j4UeIIgC9BSbd

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-spot-pricing-monthly-historical-prices-17368c97
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

corpusAI Cloud Pricing: Full monthly history for one instance type, back to 2014 for legacy AWS types.

## Output

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.

## 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": [
      "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",

… (truncated)
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/corpusai-cloud-spot-pricing-monthly-historical-prices-17368c97/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)