# corpusAI Cloud Spot Pricing Events Export

> corpusAI Cloud Spot Pricing Events Export is a paid API for AI agents from cloud.trycorpus.ai, paid per call via x402, $0.5/call, status unknown (last checked 2026-10-11).

Returns historical spot instance pricing events for a specific cloud provider, region, and date as a structured export.

## Facts

- Endpoint: GET https://cloud.trycorpus.ai/v1/spot/export/events?utm_source=zero.xyz
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/corpusai-cloud-spot-pricing-events-export-637f1d18
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_m_PexBSvqDuu4H_kV2yE3

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-events-export-637f1d18
```

Example prompt: Pull the spot instance pricing events from corpusAI for AWS in us-east-1 for September 1, 2025.

## When to prefer this

Use this endpoint when you need structured, exportable historical spot instance pricing event data for a specific cloud provider, region, and date — especially for cost analysis, auditing, or building pricing trend datasets. Prefer this over scraping cloud consoles or provider pricing APIs when you need consistent historical data back to 2014 across AWS, GCP, and Azure in a unified format.

## Known failure modes

- Missing required query parameters (provider, region, date) returns a 400 error
- Invalid provider value (not aws/gcp/azure) returns validation error
- Invalid region slug not matching provider's catalog returns an error or empty result
- Future dates or dates before 2014 may return empty or error responses
- Payment failure via x402 (insufficient USDC) blocks the request
- Date format not matching YYYY-MM-DD returns a validation error

## How this service works

corpusAI Cloud Pricing: Every raw spot price-change event of a region for one UTC day, as a gzip TSV file.

## Output

A JSON array or object containing spot instance pricing events for the specified cloud provider, region, and UTC date, including instance types and their historical spot price data points for that day.

## 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",
      "date"
     ],
     "properties": {
      "date": {
       "type": "string",
       "format": "date",
       "examples": [
        "2026-09-01"
       ],
       "description": "UTC day, YYYY-MM-DD."
      },
      "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`."
      },
      "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/corpusai-cloud-spot-pricing-events-export-637f1d18/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)