# corpusAI Cloud Pricing – Spot Price Events

> corpusAI Cloud Pricing – Spot Price Events 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-11).

Returns time-series spot price change events for a specific cloud instance type (AWS, GCP, or Azure) over a given time window

## Facts

- Endpoint: GET https://cloud.trycorpus.ai/v1/spot/events?utm_source=zero.xyz
- Price: $0.01/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-pricing-spot-price-events-6d0442d3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bjvkQKRuph0xRdX6eSdjm

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-spot-price-events-6d0442d3
```

Example prompt: Pull the spot price change events for AWS c5.large in us-east-1 over the last 7 days — just Linux/UNIX product, up to 5000 rows.

## When to prefer this

Use this endpoint when you need granular, time-series spot price change events for a specific cloud instance type — not just current prices. It is ideal for cost trend analysis, spike detection, and AZ-level price comparison across AWS, GCP, and Azure. Prefer this over static pricing APIs when you need historical depth (back to 2014 for major clouds) or when building cost optimization workflows that respond to price changes over time.

## Known failure modes

- Missing required parameters (provider, region, instance) returns a 400 error
- Invalid provider enum value returns a 400 validation error
- Unrecognized instance type or region slug returns empty results or 404
- Time window too broad returning truncated results at row limit
- Payment failure via x402 returns 402 Payment Required
- Rate limiting or quota exceeded returns 429

## How this service works

corpusAI Cloud Pricing: Raw spot price-change events for one instance type.

## Output

A JSON object containing a time-windowed list of spot price change events for the requested instance, with fields for timestamp, price, availability zone, product/OS, event count, and the queried from/to window boundaries. Up to 10,000 rows per request, defaulting to 5,000.

## 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": {
      "az": {
       "type": "string",
       "description": "Restrict to one availability zone / zone id (for example `use1-az1`). Default: all zones."
      },
      "to": {
       "type": "string",
       "format": "date-time",
       "description": "End of the window (exclusive), ISO 8601 UTC. Default: now."
      },
      "from": {
       "type": "string",
       "format": "date-time",
       "description": "Start of the window (inclusive), ISO 8601 UTC. Default: 7 days before `to`."
      },
      "limit": {
       "type": "integer",
       "default": 5000,
       "maximum": 10000,
       "minimum": 1,
       "description": "Maximum rows to return (1 to 10000). Default 5000."
      },
      "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`."
      },
      "product": {
       "type": "string",
       "description": "Restrict to one product / OS string (for example `Linux/UNIX`, `Spot`, `Linux`). Default: all."
      },
      "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_repeats": {
       "type": "boolean",
       "default": false,
       "description": "Keep events whose price equals the previous event of the same (az, product) series. Default false."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "prop
… (truncated)
```

## Response schema (JSON Schema)

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

## More

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