# corpusAI Cloud Pricing API

> Cloud and GPU price data for agents, paid per call in USDC over x402 (Circle Gateway, 11 networks). No accounts, no API keys.

- Base URL: https://cloud.trycorpus.ai/v1
- OpenAPI 3.1: https://cloud.trycorpus.ai/openapi.json
- Docs (markdown): https://cloud.trycorpus.ai/docs.md
- Methodology (markdown): https://cloud.trycorpus.ai/methodology.md
- Status: https://cloud.trycorpus.ai/v1/status

## What it has
- Spot price-change events for AWS (13 regions), GCP (8), Azure (9), per zone, since 2026; daily history since 2022 (AWS) and monthly since 2014.
- On-demand and AWS reserved-instance list-price history.
- GPU rental quotes from RunPod, Vast.ai, DataCrunch, Lambda, Nebius, Crusoe, CoreWeave, Vultr, Linode and Oracle, normalised to USD per GPU-hour.
- Index fixings per GPU and segment (marketplace, neo-cloud, interruptible, hyperscaler on-demand, hyperscaler spot), tickers like CX.H100SXM.NEO.
- Term structure: spot, on-demand, 1-year and 3-year committed prices with discounts, per instance type (/v1/term/instance, 0.01) or per GPU across AWS, GCP and Azure (/v1/term?gpu=, 0.05).
- Capacity stress: daily 0–100 tightness score per GPU from listing availability, io.net units, Vast supply and the spot-to-on-demand ratio (/v1/capacity/stress 0.01, /v1/capacity/history 0.05, /v1/capacity/board 0.10).
- LLM token prices: USD per million input and output tokens per model across hosts, daily fixings CX.TOK.<MODEL>.IN/.OUT/.BLEND and a frontier basket (/v1/tokens/models free, /v1/tokens/fixing 0.01, /v1/tokens/quotes 0.01, /v1/tokens/history 0.05, /v1/tokens/board 0.10).

## MCP server
npm package `corpus-cloud-pricing-mcp` (28 tools): `npx -y corpus-cloud-pricing-mcp`; set CORPUS_PAYER_KEY to a wallet with a Circle Gateway USDC balance to pay automatically.

## How to call
1. GET https://cloud.trycorpus.ai/v1/catalog (free) for regions, coverage and prices; GET /v1/gpu/models and /v1/index/tickers (free) for names.
2. Any paid GET returns HTTP 402 with x402 v2 requirements (PAYMENT-REQUIRED header and JSON body). Pay with an x402 client, for example `circle services pay <url> -X GET --address <wallet> --chain <chain> --max-amount 0.10`.
3. Prices: 0.01 USDC per single-type or single-fixing call, 0.05 for a full history, 0.10 for a region or market snapshot, 0.50 to 3.00 for bulk files.