{ "openapi": "3.1.0", "info": { "title": "corpusAI Cloud Pricing API", "version": "1.0.0", "summary": "corpusAI: event-level spot price history for AWS, GCP and Azure, paid per call in USDC over x402.", "description": "Every spot price change collected directly from the provider APIs (EC2 DescribeSpotPriceHistory, GCP Capacity Advisor, Azure Resource Graph), stored as immutable events with the exact timestamp, availability zone and product, plus the full legacy history behind the dashboard: AWS daily back to 2022-05 (measured, with open/high/low/close), daily averages back to 2024 (SpotLake TITANS, all providers), and AWS monthly back to 2014 (USC/ISI archive). Every row names its source. Endpoints return raw events, hourly bars, stitched daily and monthly series across all eras, the current price per zone, whole-provider snapshots and region-level file exports, on-demand and reserved-instance list-price history, Azure eviction-rate history, and GPU rental quotes from neo-clouds and marketplaces (RunPod, Vast.ai, DataCrunch, Lambda, Vultr, Linode, Oracle) normalised to USD per GPU-hour with hyperscaler spot beside them. The free public dashboard at https://tools.traversa.dev/cloud-pricing shows one daily average per instance for the trailing 90 days (weekly for a year, monthly beyond); this API is the full-precision, per-zone tier behind it. Built and operated by corpusAI (https://www.trycorpus.ai), software that outlives its owners.", "contact": { "name": "corpusAI", "email": "julian@traversa.dev", "url": "https://www.trycorpus.ai" }, "x-logo": { "url": "https://cloud.trycorpus.ai/mark.svg", "altText": "corpusAI" }, "x-methodology": { "url": "https://cloud.trycorpus.ai/methodology", "markdown": "https://cloud.trycorpus.ai/methodology.md" }, "x-agent-card": "https://cloud.trycorpus.ai/.well-known/agent-card.json", "x-llms-txt": "https://cloud.trycorpus.ai/llms.txt", "x-mcp-server": { "npm": "corpus-cloud-pricing-mcp", "command": "npx -y corpus-cloud-pricing-mcp" }, "license": { "name": "Per-call data licence (see docs)", "url": "https://cloud.trycorpus.ai/docs" }, "x-guidance": "Cloud and GPU prices for agents. Spot: exact price-change events per zone (AWS since 2026-06, GCP 2026-04, Azure 2025-07), hourly bars, daily series back to 2022 (AWS) or 2024, monthly back to 2014 (AWS legacy types), current price per zone, Azure eviction rates; 13 AWS, 8 GCP, 9 Azure regions (live list in /catalog; the original three per cloud carry the deep history). Start with the free GET /catalog (regions, coverage, prices, source legend), /instances?provider=®ion= (exact type names), /gpu/models, /index/tickers and /status. Paid calls: 0.010000 USDC for GET /spot/events (raw events), /spot/hourly (hourly bars), /spot/latest (current price per zone for one type) and /azure/eviction; 0.050000 USDC for GET /spot/daily (full daily history of one type, each row carries `source`: direct, titans, pauley) and /spot/monthly (full monthly history, adds uscisi-adjusted months and the raw archive); 0.100000 USDC for GET /spot/snapshot (current price of every type and zone in a whole region in one call) and for GET /ondemand/snapshot or /reserved/snapshot (current list prices for every type in a region); 0.010000 USDC for GET /ondemand (on-demand list-price change history of one type, all providers) and GET /reserved (AWS standard reserved-instance effective hourly price history of one type, 1y/3y, no-upfront/all-upfront, back to 2016). Index: free GET /index/tickers lists tickers like CX.H100SXM.NEO (segments MKT marketplace, NEO neo-cloud on-demand, INT interruptible, HYP hyperscaler on-demand, SPOT hyperscaler spot, SPOT.); 0.010000 USDC for GET /index/fixing?ticker= (median USD per GPU-hour of eligible quotes that day, with lo/hi/n; SPOT tickers reach back to 2022), 0.050000 USDC for GET /index/history?ticker=, 0.100000 USDC for GET /index/board (every ticker for a day). Methodology at /methodology.md, versioned. GPU rental market: free GET /gpu/models lists normalised GPU names (H100 SXM, H200, B200, A100 SXM 80GB, L40S, L4, RTX 4090, ...); 0.010000 USDC for GET /gpu/quotes?gpu= (latest quotes from every provider and market, USD per GPU-hour), 0.050000 USDC for GET /gpu/index?gpu= (daily lo/median/mean/hi per provider and market, with aws-spot and gcp-spot legs computed from our own events), 0.100000 USDC for GET /gpu/snapshot (every GPU × provider × market at once). Capacity stress: 0.010000 USDC for GET /capacity/stress?gpu= (0 slack … 100 tight with every component), 0.050000 for /capacity/history, 0.100000 for /capacity/board. Token prices: GET /tokens/models (free) lists every LLM with a fixing; 0.010000 USDC for GET /tokens/fixing?ticker=CX.TOK.CLAUDESONNET5.IN (or .OUT, .BLEND, or CX.TOK.FRONTIER.BLEND) and GET /tokens/quotes?model= (every host's price), 0.050000 for /tokens/history, 0.100000 for /tokens/board. Term structure: 0.010000 USDC for GET /term/instance?provider=®ion=&instance= (spot, on-demand, 1y, 3y prices with discounts for one type) and 0.050000 USDC for GET /term?gpu= (the same per GPU-hour across hyperscalers). Bulk: 1.000000 USDC for GET /spot/snapshot/all (every region of a provider), 3.000000 USDC for GET /spot/export/history (a whole region's legacy daily+monthly history as one gzip TSV, all types), 0.500000 USDC for GET /spot/export/events (one region-day of raw events as gzip TSV). Rows carry a `source`; only `direct` rows have zones and intraday timing, `archive` rows are third-party and indicative. Inputs are query parameters matching the catalog exactly; times ISO 8601 UTC; prices USD per hour (per GPU-hour for /gpu and /index). Spot events are price CHANGES: a price holds until the next event for the same (instance, az, product). Payment: an unpaid call returns HTTP 402 with x402 v2 requirements (PAYMENT-REQUIRED header and JSON body), USDC via Circle Gateway on every network listed. 400/404 are never charged; 503 means the store is warming up, retry shortly." }, "security": [], "externalDocs": { "description": "Usage guide, data semantics, payment walkthrough and examples.", "url": "https://cloud.trycorpus.ai/docs" }, "servers": [ { "url": "https://cloud.trycorpus.ai/v1", "description": "Production" } ], "tags": [ { "name": "discovery", "description": "Free. Learn what data exists before paying." }, { "name": "spot", "description": "Paid. Spot price history (events since 2026, daily since 2022, monthly since 2014) and snapshots: 0.010000 USDC per call for events, hourly and single-type latest; 0.050000 USDC for the full daily or monthly history of a type; 0.100000 USDC for a whole-region snapshot." }, { "name": "bulk", "description": "Paid. Whole-provider and whole-region products: 1.000000 USDC for every region of a provider, 3.000000 USDC for a region's legacy history file, 0.500000 USDC for a region-day of raw events." }, { "name": "list-prices", "description": "Paid. On-demand (all providers) and AWS reserved-instance list prices: 0.010000 USDC per single-type history, 0.100000 USDC per region snapshot." }, { "name": "gpu", "description": "GPU rental market: neo-cloud and marketplace quotes normalised to USD per GPU-hour, with hyperscaler spot legs. /gpu/models is free; 0.010000 USDC per quotes call, 0.050000 USDC per index call, 0.100000 USDC per full snapshot." }, { "name": "index", "description": "Compute price index fixings by GPU and segment, versioned methodology at /methodology. /index/tickers is free; 0.010000 USDC per fixing, 0.050000 USDC per history, 0.100000 USDC per board." }, { "name": "tokens", "description": "LLM token price index: USD per million input and output tokens per model across hosts, with daily fixings (CX.TOK..IN | .OUT | .BLEND). /tokens/models is free; quotes and fixings 0.010000 USDC, history 0.050000, board 0.100000." }, { "name": "capacity", "description": "Capacity stress: a daily 0–100 tightness score per GPU model from listing availability, io.net deployable units, Vast supply vs its 30-day baseline and the hyperscaler spot-to-on-demand ratio. 0.010000 USDC per model-day, 0.050000 history, 0.100000 board." }, { "name": "term", "description": "Term structure: spot → on-demand → 1y → 3y from list prices. 0.010000 USDC per instance ladder, 0.050000 USDC per GPU curve across hyperscalers." }, { "name": "azure", "description": "Paid (0.010000 USDC per call). Azure-specific series." } ], "paths": { "/health": { "get": { "operationId": "health", "tags": [ "discovery" ], "summary": "Liveness and store readiness (free).", "description": "Returns 200 whenever the server is up. `ready` is false while the store is still ingesting after a restart; paid endpoints answer 503 (and take no payment) until it is true.", "responses": { "200": { "description": "Status.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Health" } } } } } } }, "/catalog": { "get": { "operationId": "getCatalog", "tags": [ "discovery" ], "summary": "Providers, regions, coverage window and event counts (free).", "description": "One row per (provider, region) with raw-event coverage (instance types, events, first/last event) and legacy-history coverage (daily and monthly date ranges), plus `sources`, the legend explaining every `source` value returned by /spot/daily and /spot/monthly. Use the `region` values here verbatim in every other call.", "responses": { "200": { "description": "Catalog.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Catalog" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/instances": { "get": { "operationId": "listInstances", "tags": [ "discovery" ], "summary": "Instance types available in a region (free).", "description": "Exact type names with per-type coverage: raw events (`events`, `first_event`, `last_event`; zero/null for types that only exist in the legacy history) and legacy history ranges (`history_daily_from/to`, `history_monthly_from/to`). Optional `prefix` narrows the list (for example `c5.` or `n2-`).", "parameters": [ { "name": "provider", "in": "query", "description": "Cloud provider. One of `aws`, `gcp`, `azure`.", "schema": { "type": "string", "enum": [ "aws", "gcp", "azure" ] }, "required": true }, { "name": "region", "in": "query", "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`.", "schema": { "type": "string", "examples": [ "us-east-1" ] }, "required": true }, { "name": "prefix", "in": "query", "description": "Case-sensitive prefix filter on the type name.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Instance list.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InstanceList" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/spot/events": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.010000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getSpotEvents", "tags": [ "spot" ], "summary": "Raw spot price-change events for one instance type.", "description": "Every price change for the type in the window, with exact timestamp, availability zone and product (OS). Sorted by time. Repeated identical prices are dropped by default (`include_repeats=true` keeps them). Up to `limit` rows; when `truncated` is true, continue with `from` = `next_from`.", "parameters": [ { "name": "provider", "in": "query", "description": "Cloud provider. One of `aws`, `gcp`, `azure`.", "schema": { "type": "string", "enum": [ "aws", "gcp", "azure" ] }, "required": true }, { "name": "region", "in": "query", "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`.", "schema": { "type": "string", "examples": [ "us-east-1" ] }, "required": true }, { "name": "instance", "in": "query", "description": "Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`).", "schema": { "type": "string", "examples": [ "c5.large" ] }, "required": true }, { "name": "from", "in": "query", "description": "Start of the window (inclusive), ISO 8601 UTC. Default: 7 days before `to`.", "schema": { "type": "string", "format": "date-time" } }, { "name": "to", "in": "query", "description": "End of the window (exclusive), ISO 8601 UTC. Default: now.", "schema": { "type": "string", "format": "date-time" } }, { "name": "az", "in": "query", "description": "Restrict to one availability zone / zone id (for example `use1-az1`). Default: all zones.", "schema": { "type": "string" } }, { "name": "product", "in": "query", "description": "Restrict to one product / OS string (for example `Linux/UNIX`, `Spot`, `Linux`). Default: all.", "schema": { "type": "string" } }, { "name": "include_repeats", "in": "query", "description": "Keep events whose price equals the previous event of the same (az, product) series. Default false.", "schema": { "type": "boolean", "default": false } }, { "name": "limit", "in": "query", "description": "Maximum rows to return (1 to 10000). Default 5000.", "schema": { "type": "integer", "minimum": 1, "maximum": 10000, "default": 5000 } } ], "responses": { "200": { "description": "Events.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventList" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/spot/hourly": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.010000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getSpotHourly", "tags": [ "spot" ], "summary": "Hourly time-weighted OHLC bars for one instance type.", "description": "Per-zone series are bucketed by UTC hour with time weighting (a price counts for as long as it was in force), then collapsed across zones: open/close/avg are the median across zones, high is the max, low is the min. Window is capped at 366 days.", "parameters": [ { "name": "provider", "in": "query", "description": "Cloud provider. One of `aws`, `gcp`, `azure`.", "schema": { "type": "string", "enum": [ "aws", "gcp", "azure" ] }, "required": true }, { "name": "region", "in": "query", "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`.", "schema": { "type": "string", "examples": [ "us-east-1" ] }, "required": true }, { "name": "instance", "in": "query", "description": "Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`).", "schema": { "type": "string", "examples": [ "c5.large" ] }, "required": true }, { "name": "from", "in": "query", "description": "Start of the window (inclusive), ISO 8601 UTC. Default: 30 days before `to`.", "schema": { "type": "string", "format": "date-time" } }, { "name": "to", "in": "query", "description": "End of the window (exclusive), ISO 8601 UTC. Default: now.", "schema": { "type": "string", "format": "date-time" } } ], "responses": { "200": { "description": "Hourly bars.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HourlyBars" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/spot/daily": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.050000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getSpotDaily", "tags": [ "spot" ], "summary": "Full daily history for one instance type, all eras stitched.", "description": "One row per UTC day from the earliest data for the type to now. Rows dated before the type's first raw event come from the legacy history (`source` = `pauley`: measured 2022-05 to 2024-01 AWS, open/high/low/close present on days the price moved; `titans`: daily average only, 2024 to 2026). Rows from `direct_from` on are time-weighted, zone-collapsed bars from the raw event store (`source` = `direct`, same method as /spot/hourly; `avg` equals the public dashboard value). open/high/low/close are null where the source only has an average.", "parameters": [ { "name": "provider", "in": "query", "description": "Cloud provider. One of `aws`, `gcp`, `azure`.", "schema": { "type": "string", "enum": [ "aws", "gcp", "azure" ] }, "required": true }, { "name": "region", "in": "query", "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`.", "schema": { "type": "string", "examples": [ "us-east-1" ] }, "required": true }, { "name": "instance", "in": "query", "description": "Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`).", "schema": { "type": "string", "examples": [ "c5.large" ] }, "required": true }, { "name": "from", "in": "query", "description": "Start of the window (inclusive), ISO 8601 UTC. Default: the earliest row for the type.", "schema": { "type": "string", "format": "date-time" } }, { "name": "to", "in": "query", "description": "End of the window (exclusive), ISO 8601 UTC. Default: now.", "schema": { "type": "string", "format": "date-time" } } ], "responses": { "200": { "description": "Daily bars.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DailyBars" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/spot/monthly": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.050000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getSpotMonthly", "tags": [ "spot" ], "summary": "Full monthly history for one instance type, back to 2014 for legacy AWS types.", "description": "Calendar months from the earliest data to now. `months` is the curated series: `uscisi-adjusted` months (2017 to 2022-04, AWS types with a stable correction factor, average only), then months rolled up from the daily series (`pauley`, `titans`, `direct`: `avg` = median of daily averages, open/close from the first/last day, high/low the extremes, `days` = days covered, `source` = the source covering most days). `archive` (AWS, default on) is the USC/ISI monthly dataset 2014-02 to 2023-12 as published, with open/high/low/close, for 51 legacy types: third-party, mixes OS products, provenance partly unverified; returned separately so it never silently blends into the curated series.", "parameters": [ { "name": "provider", "in": "query", "description": "Cloud provider. One of `aws`, `gcp`, `azure`.", "schema": { "type": "string", "enum": [ "aws", "gcp", "azure" ] }, "required": true }, { "name": "region", "in": "query", "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`.", "schema": { "type": "string", "examples": [ "us-east-1" ] }, "required": true }, { "name": "instance", "in": "query", "description": "Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`).", "schema": { "type": "string", "examples": [ "c5.large" ] }, "required": true }, { "name": "from", "in": "query", "description": "First month (inclusive), YYYY-MM-DD (use the 1st). Default: earliest.", "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "description": "Last month (inclusive), YYYY-MM-DD. Default: latest.", "schema": { "type": "string", "format": "date" } }, { "name": "include_archive", "in": "query", "description": "Include the raw USC/ISI archive rows in `archive`. Default true.", "schema": { "type": "boolean", "default": true } } ], "responses": { "200": { "description": "Monthly series.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MonthlySeries" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/spot/latest": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.010000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getSpotLatest", "tags": [ "spot" ], "summary": "Price currently in force per zone and product for one instance type.", "description": "The most recent event of every (zone, product) series of the type, with its timestamp and age. A price is only meaningful while the provider still offers the type; AWS series older than ~10 days are likely retired, GCP/Azure reprice rarely so old timestamps are normal. For every type in a region at once use /spot/snapshot.", "parameters": [ { "name": "provider", "in": "query", "description": "Cloud provider. One of `aws`, `gcp`, `azure`.", "schema": { "type": "string", "enum": [ "aws", "gcp", "azure" ] }, "required": true }, { "name": "region", "in": "query", "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`.", "schema": { "type": "string", "examples": [ "us-east-1" ] }, "required": true }, { "name": "instance", "in": "query", "description": "Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`).", "schema": { "type": "string", "examples": [ "c5.large" ] }, "required": true } ], "responses": { "200": { "description": "Latest prices.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LatestList" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/spot/snapshot": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.100000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getSpotSnapshot", "tags": [ "spot" ], "summary": "Current price of every instance type, zone and product in a whole region, in one call.", "description": "Bulk snapshot: the most recent event of every series in the region (about 6,000 rows for an AWS region), with timestamp and age per row. Same semantics as /spot/latest. Priced higher because one call returns the entire current price surface of the region.", "parameters": [ { "name": "provider", "in": "query", "description": "Cloud provider. One of `aws`, `gcp`, `azure`.", "schema": { "type": "string", "enum": [ "aws", "gcp", "azure" ] }, "required": true }, { "name": "region", "in": "query", "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`.", "schema": { "type": "string", "examples": [ "us-east-1" ] }, "required": true } ], "responses": { "200": { "description": "Region snapshot.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LatestList" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/spot/snapshot/all": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "1.000000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getSpotSnapshotAll", "tags": [ "bulk" ], "summary": "Current spot price of every type and zone in every region of a provider, in one call.", "description": "Same rows as /spot/snapshot, for all regions of the provider (about 80,000 rows for AWS). `regions` lists each region with its as-of time.", "parameters": [ { "name": "provider", "in": "query", "description": "Cloud provider. One of `aws`, `gcp`, `azure`.", "schema": { "type": "string", "enum": [ "aws", "gcp", "azure" ] }, "required": true } ], "responses": { "200": { "description": "Provider snapshot.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProviderSnapshot" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/spot/export/history": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "3.000000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "exportSpotHistory", "tags": [ "bulk" ], "summary": "Legacy daily and monthly history of every type in a region as one gzip TSV file.", "description": "Columns: instance, res (daily|monthly), date, open, high, low, close, avg, source. Covers the pauley, titans, uscisi-adjusted and archive eras for the region (the same rows /spot/daily and /spot/monthly serve before a type's first raw event). Only the original three regions per provider have legacy history; other regions answer 404. Pair with /spot/export/events for the direct era. About 10 MB for an AWS region.", "parameters": [ { "name": "provider", "in": "query", "description": "Cloud provider. One of `aws`, `gcp`, `azure`.", "schema": { "type": "string", "enum": [ "aws", "gcp", "azure" ] }, "required": true }, { "name": "region", "in": "query", "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`.", "schema": { "type": "string", "examples": [ "us-east-1" ] }, "required": true } ], "responses": { "200": { "description": "The gzip file (tab-separated).", "content": { "application/gzip": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/spot/export/events": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.500000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "exportSpotEvents", "tags": [ "bulk" ], "summary": "Every raw spot price-change event of a region for one UTC day, as a gzip TSV file.", "description": "Columns: ts (ISO 8601), az, instance, product, price. The exact file the store ingests: every type and zone, repeats included. About 25,000 rows / 170 KB for a large AWS region-day. Use /catalog for the covered window.", "parameters": [ { "name": "provider", "in": "query", "description": "Cloud provider. One of `aws`, `gcp`, `azure`.", "schema": { "type": "string", "enum": [ "aws", "gcp", "azure" ] }, "required": true }, { "name": "region", "in": "query", "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`.", "schema": { "type": "string", "examples": [ "us-east-1" ] }, "required": true }, { "name": "date", "in": "query", "description": "UTC day, YYYY-MM-DD.", "schema": { "type": "string", "format": "date" }, "required": true } ], "responses": { "200": { "description": "The gzip file (tab-separated).", "content": { "application/gzip": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/ondemand": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.010000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getOnDemand", "tags": [ "list-prices" ], "summary": "On-demand list-price history of one instance type.", "description": "Change-point series: one row per day the on-demand (pay-as-you-go) hourly list price changed; `current` is the price in force. AWS: Linux, shared tenancy, from the AWS Price List API, refreshed weekly, since 2024-01 (13 regions). Azure: every Linux VM SKU from the public Retail Prices API, refreshed daily, since 2026-09-13 (9 regions). GCP: the TITANS-era series (2024 to 2026-08), not refreshed.", "parameters": [ { "name": "provider", "in": "query", "description": "Cloud provider. One of `aws`, `gcp`, `azure`.", "schema": { "type": "string", "enum": [ "aws", "gcp", "azure" ] }, "required": true }, { "name": "region", "in": "query", "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`.", "schema": { "type": "string", "examples": [ "us-east-1" ] }, "required": true }, { "name": "instance", "in": "query", "description": "Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`).", "schema": { "type": "string", "examples": [ "c5.large" ] }, "required": true } ], "responses": { "200": { "description": "On-demand history.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OnDemandHistory" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/ondemand/snapshot": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.100000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getOnDemandSnapshot", "tags": [ "list-prices" ], "summary": "Current on-demand list price of every instance type in a region.", "parameters": [ { "name": "provider", "in": "query", "description": "Cloud provider. One of `aws`, `gcp`, `azure`.", "schema": { "type": "string", "enum": [ "aws", "gcp", "azure" ] }, "required": true }, { "name": "region", "in": "query", "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`.", "schema": { "type": "string", "examples": [ "us-east-1" ] }, "required": true } ], "responses": { "200": { "description": "On-demand snapshot.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OnDemandSnapshot" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/reserved": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.010000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getReserved", "tags": [ "list-prices" ], "summary": "Reserved / reservation price history of one instance type (AWS standard RIs 1y/3y no-upfront/all-upfront; Azure reservations 1y/3y).", "description": "Effective hourly USD with any upfront amortised over the term, as change-point series per `ri_type` (`ri_1y_no_upfront_standard`, `ri_1y_all_upfront_standard`, `ri_3y_no_upfront_standard`, `ri_3y_all_upfront_standard`; GCP `cud_1y`, `cud_3y`). AWS: Linux, shared tenancy, history back to 2016 for the original three regions, weekly refresh from the AWS Price List API. Azure: all-upfront reservations from the public Retail Prices API, daily, since 2026-09-13. GCP: resource-based committed-use discounts from the Cloud Billing Catalog (vCPU, RAM and GPU commitment SKUs), daily, since 2026-09-13.", "parameters": [ { "name": "provider", "in": "query", "description": "Provider: `aws` (default), `azure` or `gcp`.", "schema": { "type": "string", "enum": [ "aws", "azure", "gcp" ], "default": "aws" } }, { "name": "region", "in": "query", "description": "Region slug (for example `us-east-1`, `us-east` for Azure, `us-central1` for GCP).", "schema": { "type": "string", "examples": [ "us-east-1" ] }, "required": true }, { "name": "instance", "in": "query", "description": "Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`).", "schema": { "type": "string", "examples": [ "c5.large" ] }, "required": true }, { "name": "ri_type", "in": "query", "description": "Restrict to one ri_type.", "schema": { "type": "string", "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" ] } } ], "responses": { "200": { "description": "Reserved history.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReservedHistory" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/reserved/snapshot": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.100000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getReservedSnapshot", "tags": [ "list-prices" ], "summary": "Current reserved effective hourly price of every instance type and ri_type in a region (AWS or Azure).", "parameters": [ { "name": "provider", "in": "query", "description": "Provider: `aws` (default), `azure` or `gcp`.", "schema": { "type": "string", "enum": [ "aws", "azure", "gcp" ], "default": "aws" } }, { "name": "region", "in": "query", "description": "Region slug (for example `us-east-1`, `us-east` for Azure, `us-central1` for GCP).", "schema": { "type": "string", "examples": [ "us-east-1" ] }, "required": true } ], "responses": { "200": { "description": "Reserved snapshot.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReservedSnapshot" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/gpu/models": { "get": { "operationId": "listGpuModels", "tags": [ "gpu" ], "summary": "GPU models with rental quotes, and which providers quote them (free).", "description": "Normalised model names (use verbatim as `gpu`), number of providers quoting each, quote counts, first/last snapshot day, the lowest observed USD per GPU-hour, and which hyperscaler spot instance families map to the model.", "responses": { "200": { "description": "Models.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GpuModels" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/gpu/quotes": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.010000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getGpuQuotes", "tags": [ "gpu" ], "summary": "Latest rental quotes for one GPU model across neo-clouds, marketplaces and other clouds.", "description": "One row per quote in each provider's latest daily snapshot: provider, market (`ondemand`, `spot` = interruptible, `bid` = marketplace minimum bid, `secure`/`community` = RunPod tiers), GPUs in the quoted unit, USD per GPU-hour, quoted unit price, region where the provider exposes one, and provider-specific detail in `extra` (marketplace host reliability, VRAM, stock status). Sources: RunPod GraphQL, Vast.ai marketplace (cheapest 64 offers per model, on-demand and bid), DataCrunch, Lambda, Vultr, Linode, Oracle Cloud list prices. Snapshots are taken daily.", "parameters": [ { "name": "gpu", "in": "query", "description": "Normalised GPU model from /gpu/models, e.g. `H100 SXM`, `H200`, `B200`, `A100 SXM 80GB`, `L40S`, `RTX 4090`.", "schema": { "type": "string" }, "required": true }, { "name": "provider", "in": "query", "description": "Restrict to one provider (`runpod`, `vast`, `datacrunch`, `lambda`, `vultr`, `linode`, `oci`).", "schema": { "type": "string" } }, { "name": "market", "in": "query", "description": "Restrict to one market (`ondemand`, `spot`, `bid`, `secure`, `community`).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Quotes.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GpuQuotes" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/gpu/index": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.050000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getGpuIndex", "tags": [ "gpu" ], "summary": "Daily USD per GPU-hour index per provider and market for one GPU model, with hyperscaler spot legs.", "description": "For each snapshot day and (provider, market): number of quotes and the lowest, median, mean and highest USD per GPU-hour. Rows with provider `aws-spot` or `gcp-spot` are computed from our own spot price events for the instance family that carries the GPU (time-weighted daily bar divided by GPUs per node, per region), so the neo-cloud market and hyperscaler spot are comparable in one series. Quote history starts 2026-09-13; hyperscaler spot legs reach back to the start of our event data.", "parameters": [ { "name": "gpu", "in": "query", "description": "Normalised GPU model from /gpu/models.", "schema": { "type": "string" }, "required": true }, { "name": "from", "in": "query", "description": "First day (inclusive), YYYY-MM-DD. Default: earliest.", "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "description": "Last day (inclusive), YYYY-MM-DD. Default: latest.", "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "Index series.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GpuIndex" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/gpu/snapshot": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.100000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getGpuSnapshot", "tags": [ "gpu" ], "summary": "Every GPU model × provider × market: lowest and median USD per GPU-hour in the latest snapshot, plus hyperscaler spot per region.", "responses": { "200": { "description": "Snapshot.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GpuSnapshot" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/status": { "get": { "operationId": "status", "tags": [ "discovery" ], "summary": "Freshness of every data source (free).", "description": "Per source: last successful snapshot or event, staleness in days, and the public URL it is read from. Use it to decide whether a fixing or quote is current before paying for it.", "responses": { "200": { "description": "Source status.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "ready": { "type": "boolean" }, "methodology": { "type": "string" }, "sources": { "type": "object", "additionalProperties": { "type": "object" } } } } } } } } } }, "/index/tickers": { "get": { "operationId": "listTickers", "tags": [ "index" ], "summary": "Every index ticker, its segment and definition (free).", "description": "Tickers are CX.. (for example CX.H100SXM.NEO) or CX..SPOT.. Includes the segment membership lists and the methodology version.", "responses": { "200": { "description": "Tickers.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Tickers" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/index/fixing": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.010000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getIndexFixing", "tags": [ "index" ], "summary": "One day's fixing for a ticker: median USD per GPU-hour of eligible quotes, with low, high and count.", "description": "Quote segments (MKT, NEO, INT, HYP) fix from that day's snapshots; the default day is the latest snapshot. SPOT fixes from the full UTC day of spot events, so the default is yesterday; SPOT composites carry per-region values and spread_vs_neo. See /methodology for eligibility and aggregation.", "parameters": [ { "name": "ticker", "in": "query", "description": "Ticker from /index/tickers, e.g. `CX.H100SXM.NEO` or `CX.H100SXM.SPOT.US-EAST-1`.", "schema": { "type": "string" }, "required": true }, { "name": "day", "in": "query", "description": "Fixing day, YYYY-MM-DD. Default: latest available.", "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "Fixing.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fixing" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/index/history": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.050000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getIndexHistory", "tags": [ "index" ], "summary": "Daily fixings for a ticker over a date range.", "description": "Quote segments start 2026-09-13. SPOT tickers reach back to the start of the spot series (AWS daily from 2022-05-31 for A100, V100, T4, A10; from 2023-07 for H100), each row carrying its data source.", "parameters": [ { "name": "ticker", "in": "query", "description": "Ticker from /index/tickers.", "schema": { "type": "string" }, "required": true }, { "name": "from", "in": "query", "description": "First day, YYYY-MM-DD. Default: earliest.", "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "description": "Last day, YYYY-MM-DD. Default: today.", "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "Series.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FixingSeries" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/index/board": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.100000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getIndexBoard", "tags": [ "index" ], "summary": "Every ticker's fixing for one day in one call.", "parameters": [ { "name": "day", "in": "query", "description": "Fixing day, YYYY-MM-DD. Default: latest.", "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "Board.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Board" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/capacity/headline": { "get": { "operationId": "getCapacityHeadline", "tags": [ "capacity" ], "summary": "Free: capacity stress score per GPU model for the latest day, score only.", "description": "Rounded 0–100 score per GPU with at least two signals, tightest first, cached ten minutes. The components and their inputs are in the paid /capacity/stress and /capacity/board.", "responses": { "200": { "description": "Scores.", "content": { "application/json": { "schema": { "type": "object", "properties": { "day": { "type": [ "string", "null" ] }, "methodology": { "type": "string" }, "scale": { "type": "string" }, "count": { "type": "integer" }, "models": { "type": "array", "items": { "type": "object", "properties": { "gpu": { "type": "string" }, "score": { "type": "integer" }, "signals": { "type": "integer" } } } } } } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/capacity/stress": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.010000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getCapacityStress", "tags": [ "capacity" ], "summary": "Capacity stress score (0 slack … 100 tight) for one GPU model on one day, with every component.", "description": "Mean of the components available that day: availability (share of Shadeform and Lambda listings flagged available), ionet (deployable ÷ total units on io.net regional SKUs), supply (Vast on-demand offers vs the trailing 30-day median) and spot_ratio (hyperscaler SPOT fixing ÷ HYP fixing, 0.3 → 0 and 0.9 → 100). Each component carries its inputs.", "parameters": [ { "name": "gpu", "in": "query", "description": "Normalised GPU model, e.g. `H100 SXM`.", "schema": { "type": "string" }, "required": true }, { "name": "day", "in": "query", "description": "YYYY-MM-DD; default latest.", "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "Score.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CapacityStress" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/capacity/history": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.050000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getCapacityHistory", "tags": [ "capacity" ], "summary": "Daily capacity stress scores for one GPU model.", "parameters": [ { "name": "gpu", "in": "query", "description": "Normalised GPU model.", "schema": { "type": "string" }, "required": true }, { "name": "from", "in": "query", "description": "YYYY-MM-DD.", "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "description": "YYYY-MM-DD.", "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "Series.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CapacitySeries" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/capacity/board": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.100000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getCapacityBoard", "tags": [ "capacity" ], "summary": "Every GPU model's capacity stress score for one day, tightest first.", "parameters": [ { "name": "day", "in": "query", "description": "YYYY-MM-DD; default latest.", "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "Board.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CapacityBoard" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/tokens/models": { "get": { "operationId": "listTokenModels", "tags": [ "tokens" ], "summary": "Every LLM with a token price fixing, its ticker codes and today's price range (free).", "description": "Canonical model slugs (for example `claude-sonnet-5`, `gpt-6-astra`, `llama-4-maverick`), their ticker codes, how many sources and hosts list them, and the min/max input and output price seen today. Also lists the frontier basket.", "responses": { "200": { "description": "Models.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenModels" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/tokens/quotes": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.010000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getTokenQuotes", "tags": [ "tokens" ], "summary": "Every listed price for one model on one day: each source and hosting provider, USD per million tokens.", "description": "Rows from the OpenRouter catalog, OpenRouter per-host endpoints (Azure, Amazon Bedrock, Google, Together, DeepInfra, …), the LiteLLM price table and DeepInfra. Includes cache-read price and context length where known; variants such as batch tiers are marked in `extra.variant`.", "parameters": [ { "name": "model", "in": "query", "description": "Canonical model slug from /tokens/models.", "schema": { "type": "string" }, "required": true }, { "name": "day", "in": "query", "description": "YYYY-MM-DD; default latest.", "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "Quotes.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenQuotes" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/tokens/fixing": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.010000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getTokenFixing", "tags": [ "tokens" ], "summary": "One day's token price fixing for a ticker such as CX.TOK.CLAUDESONNET5.IN.", "description": "Median across every source and host at the standard tier (batch and free variants excluded). `.IN` and `.OUT` are input and output USD per million tokens; `.BLEND` is (3·input + output) / 4. `CX.TOK.FRONTIER.` is the median across the frontier basket listed by /tokens/models.", "parameters": [ { "name": "ticker", "in": "query", "description": "CX.TOK..IN | OUT | BLEND, or CX.TOK.FRONTIER..", "schema": { "type": "string" }, "required": true }, { "name": "day", "in": "query", "description": "YYYY-MM-DD; default latest.", "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "Fixing.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenFixing" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/tokens/history": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.050000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getTokenHistory", "tags": [ "tokens" ], "summary": "Daily fixings for a token ticker, from the first snapshot (2026-09-14).", "parameters": [ { "name": "ticker", "in": "query", "description": "Token ticker.", "schema": { "type": "string" }, "required": true }, { "name": "from", "in": "query", "description": "YYYY-MM-DD.", "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "description": "YYYY-MM-DD.", "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "Series.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenSeries" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/tokens/board": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.100000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getTokenBoard", "tags": [ "tokens" ], "summary": "Every model's input, output and blended fixing for one day, plus the frontier basket.", "parameters": [ { "name": "day", "in": "query", "description": "YYYY-MM-DD; default latest.", "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "Board.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenBoard" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/term/instance": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.010000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getTermInstance", "tags": [ "term" ], "summary": "Price ladder for one instance type: spot, on-demand, 1-year and 3-year commitments, with discounts.", "description": "Current prices from our series: spot median across zones (where spot events exist), on-demand list price, and reserved/reservation terms as effective hourly with upfront amortised. `discount_pct` is relative to on-demand. AWS carries four reserved terms (1y/3y × no/all upfront), Azure two (1y/3y all upfront), GCP two resource-based committed-use terms (`cud_1y`, `cud_3y`, no upfront).", "parameters": [ { "name": "provider", "in": "query", "description": "Cloud provider. One of `aws`, `gcp`, `azure`.", "schema": { "type": "string", "enum": [ "aws", "gcp", "azure" ] }, "required": true }, { "name": "region", "in": "query", "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`.", "schema": { "type": "string", "examples": [ "us-east-1" ] }, "required": true }, { "name": "instance", "in": "query", "description": "Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`).", "schema": { "type": "string", "examples": [ "c5.large" ] }, "required": true } ], "responses": { "200": { "description": "Ladder.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TermLadder" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/term": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.050000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getTermCurve", "tags": [ "term" ], "summary": "Term structure per hyperscaler for one GPU model, USD per GPU-hour: spot, on-demand, 1y, 3y.", "description": "For each hyperscaler with a mapped instance family (see /gpu/models hyperscaler_spot_legs), the median across regions of each term's price divided by GPUs per node, with lo/hi across regions and the discount to on-demand. Answers \"what does a committed H100 cost against spot and on-demand, per cloud\". Neo-cloud commitment prices are quote-only and excluded.", "parameters": [ { "name": "gpu", "in": "query", "description": "Normalised GPU model with a hyperscaler mapping, e.g. `H100 SXM`, `A100 SXM 80GB`, `L4`, `T4`.", "schema": { "type": "string" }, "required": true } ], "responses": { "200": { "description": "Curve.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TermCurve" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/azure/eviction": { "get": { "security": [ { "x402": [] }, { "apiKey": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USDC", "amount": "0.010000" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "facilitator": "circle-gateway", "asset": "USDC", "networks": [ "eip155:1", "eip155:8453", "eip155:43114", "eip155:42161", "eip155:10", "eip155:137", "eip155:130", "eip155:146", "eip155:480", "eip155:1329", "eip155:999", "eip155:5042" ], "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C" } } ] }, "operationId": "getAzureEviction", "tags": [ "azure" ], "summary": "Azure spot eviction-rate history (28-day buckets, sampled daily).", "description": "Daily samples of the eviction-rate bucket Azure reports per SKU (`0-5`, `5-10`, `10-15`, `15-20`, `20+` percent over the trailing 28 days). Collected daily since 2026-09-05; there is no history before the first sample.", "parameters": [ { "name": "region", "in": "query", "description": "Azure region slug: `us-east`, `us-west-2` or `eu-west`.", "schema": { "type": "string", "enum": [ "us-east", "us-west-2", "eu-west" ] }, "required": true }, { "name": "sku", "in": "query", "description": "Optional SKU name (for example `D2s_v5`). Default: every SKU.", "schema": { "type": "string" } }, { "name": "from", "in": "query", "description": "First sample date (inclusive), YYYY-MM-DD. Default: earliest.", "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "description": "Last sample date (inclusive), YYYY-MM-DD. Default: latest.", "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "Eviction samples.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvictionList" } } } }, "400": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every network (12 Circle Gateway mainnet networks: eip155:1, eip155:8453, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042), USDC asset, amount and payTo address accepted. Retry with a PAYMENT-SIGNATURE header, or let an x402 client (e.g. `circle services pay`) handle it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentRequired" }, "example": { "x402Version": 2, "resource": { "url": "https://cloud.trycorpus.ai/v1/spot/events?provider=aws®ion=us-east-1&instance=c5.large", "description": "Historical Cloud Pricing", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:1", "asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:43114", "asset": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:42161", "asset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:10", "asset": "0x0b2c639c533813f4aa9d7837caf62653d097ff85", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:137", "asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:130", "asset": "0x078d782b760474a361dda0af3839290b0ef57ad6", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:146", "asset": "0x29219dd400f2bf60e5a23d13be72b486d4038894", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:480", "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:1329", "asset": "0xe15fc38f6d8c56af07bbcbe3baf5708a2bf42392", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:999", "asset": "0xb88339cb7199b77e23db6e890353e22632ba630f", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 }, { "scheme": "exact", "network": "eip155:5042", "asset": "0x3600000000000000000000000000000000000000", "amount": "10000", "payTo": "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C", "maxTimeoutSeconds": 604900 } ] } } } }, "404": { "description": "Unknown provider, region or instance type.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "The store is still warming up after a restart; retry in a minute. No payment is taken.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } } }, "components": { "securitySchemes": { "apiKey": { "type": "apiKey", "in": "header", "name": "X-Api-Key", "description": "Prepaid key (ck_live_…). Each call is charged the same USD price the 402 quotes, from the key's balance; the response carries X-Charge-USD and X-Balance-USD. Get a key and top up at the docs (Pay with a key)." }, "x402": { "type": "apiKey", "in": "header", "name": "PAYMENT-SIGNATURE", "description": "x402 v2 payment. Call once without it to receive a 402 whose PAYMENT-REQUIRED header / JSON body lists the accepted networks; sign a USDC authorisation for one of them and retry with it base64-encoded in this header. Any x402 client (Circle CLI `circle services pay`, @circle-fin/x402-batching GatewayClient, @x402/fetch) does this automatically. There are no API keys." } }, "schemas": { "Error": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "string", "description": "Human-readable problem." } } }, "PaymentRequired": { "type": "object", "description": "x402 v2 payment requirements.", "properties": { "x402Version": { "type": "integer", "const": 2 }, "resource": { "type": "object", "properties": { "url": { "type": "string" }, "description": { "type": "string" }, "mimeType": { "type": "string" } } }, "accepts": { "type": "array", "description": "One entry per accepted network; pay any one of them.", "items": { "type": "object", "properties": { "scheme": { "type": "string", "description": "Payment scheme, `exact`." }, "network": { "type": "string", "description": "CAIP-2 network id, e.g. `eip155:8453`." }, "asset": { "type": "string", "description": "USDC contract address on that network." }, "amount": { "type": "string", "description": "Price in USDC atomic units (6 decimals)." }, "payTo": { "type": "string", "description": "Seller address." }, "maxTimeoutSeconds": { "type": "integer" }, "extra": { "type": "object", "description": "Circle Gateway signing domain (verifyingContract, name, version)." } } } } } }, "Health": { "type": "object", "properties": { "ok": { "type": "boolean" }, "ready": { "type": "boolean", "description": "True once the store has ingested every raw file." }, "ingest": { "type": "object", "properties": { "done": { "type": "integer" }, "total": { "type": "integer" }, "added": { "type": "integer" }, "error": { "type": [ "string", "null" ] } } }, "version": { "type": "string" } } }, "Catalog": { "type": "object", "properties": { "generated_at": { "type": "string", "format": "date-time" }, "price_usdc": { "type": "string", "description": "Base price of one paid call (events, hourly, latest, eviction)." }, "prices_usdc": { "type": "object", "description": "Price per operation family: events, hourly, latest, eviction, daily, monthly, snapshot.", "additionalProperties": { "type": "string" } }, "sources": { "type": "object", "description": "Legend: source value → what it is and how much to trust it.", "additionalProperties": { "type": "string" } }, "regions": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string" }, "region": { "type": "string", "description": "Slug to pass as `region`." }, "instances": { "type": "integer", "description": "Types with raw events." }, "events": { "type": "integer" }, "first_event": { "type": [ "string", "null" ], "format": "date-time" }, "last_event": { "type": [ "string", "null" ], "format": "date-time" }, "history_instances": { "type": "integer", "description": "Types with legacy history rows." }, "history_daily_from": { "type": [ "string", "null" ], "format": "date" }, "history_daily_to": { "type": [ "string", "null" ], "format": "date" }, "history_monthly_from": { "type": [ "string", "null" ], "format": "date" }, "history_monthly_to": { "type": [ "string", "null" ], "format": "date" }, "ondemand": { "type": [ "object", "null" ], "description": "On-demand series coverage (types, change points, from, to) or null.", "properties": { "types": { "type": "integer" }, "points": { "type": "integer" }, "from": { "type": "string", "format": "date" }, "to": { "type": "string", "format": "date" } } }, "reserved": { "type": [ "object", "null" ], "description": "AWS reserved-instance series coverage or null.", "properties": { "types": { "type": "integer" }, "points": { "type": "integer" }, "from": { "type": "string", "format": "date" }, "to": { "type": "string", "format": "date" } } } } } } } }, "InstanceList": { "type": "object", "properties": { "provider": { "type": "string" }, "region": { "type": "string" }, "count": { "type": "integer" }, "instances": { "type": "array", "items": { "type": "object", "properties": { "instance": { "type": "string" }, "events": { "type": "integer", "description": "Raw events; 0 for legacy-only types." }, "first_event": { "type": [ "string", "null" ], "format": "date-time" }, "last_event": { "type": [ "string", "null" ], "format": "date-time" }, "history_daily_from": { "type": [ "string", "null" ], "format": "date" }, "history_daily_to": { "type": [ "string", "null" ], "format": "date" }, "history_monthly_from": { "type": [ "string", "null" ], "format": "date" }, "history_monthly_to": { "type": [ "string", "null" ], "format": "date" } } } } } }, "Event": { "type": "object", "required": [ "ts", "az", "product", "price" ], "properties": { "ts": { "type": "string", "format": "date-time", "description": "When the price took effect (UTC)." }, "az": { "type": "string", "description": "Availability zone or zone id; the region name for GCP." }, "product": { "type": "string", "description": "Product / OS the price applies to." }, "price": { "type": "number", "description": "USD per hour." } } }, "EventList": { "type": "object", "properties": { "provider": { "type": "string" }, "region": { "type": "string" }, "instance": { "type": "string" }, "from": { "type": "string", "format": "date-time" }, "to": { "type": "string", "format": "date-time" }, "count": { "type": "integer" }, "truncated": { "type": "boolean", "description": "True when `limit` was hit." }, "next_from": { "type": [ "string", "null" ], "format": "date-time", "description": "Pass as `from` to continue when truncated." }, "events": { "type": "array", "items": { "$ref": "#/components/schemas/Event" } } } }, "HourlyBars": { "type": "object", "properties": { "provider": { "type": "string" }, "region": { "type": "string" }, "instance": { "type": "string" }, "zones": { "type": "integer", "description": "Number of zone series collapsed." }, "from": { "type": "string", "format": "date-time" }, "to": { "type": "string", "format": "date-time" }, "count": { "type": "integer" }, "bars": { "type": "array", "items": { "type": "object", "required": [ "hour", "open", "high", "low", "close", "avg" ], "properties": { "hour": { "type": "string", "description": "Bucket start, ISO 8601 UTC hour." }, "open": { "type": "number", "description": "Price in force at the start of the bucket, USD per hour (median across AZs)." }, "high": { "type": "number", "description": "Highest price seen in any AZ during the bucket." }, "low": { "type": "number", "description": "Lowest price seen in any AZ during the bucket." }, "close": { "type": "number", "description": "Price in force at the end of the bucket (median across AZs)." }, "avg": { "type": "number", "description": "Time-weighted average price over the bucket (median across AZs). This is the value the public dashboard shows." }, "dur": { "type": "integer", "description": "Seconds of the bucket covered by known prices (a partial value means the series starts or ends inside the bucket)." } } } } } }, "Source": { "type": "string", "enum": [ "direct", "titans", "pauley", "uscisi-adjusted", "archive" ], "description": "Where a row comes from; see `sources` in /catalog for the legend and standing of each." }, "DailyBars": { "type": "object", "properties": { "provider": { "type": "string" }, "region": { "type": "string" }, "instance": { "type": "string" }, "zones": { "type": "integer", "description": "Zone series collapsed in the `direct` rows." }, "direct_from": { "type": [ "string", "null" ], "format": "date", "description": "First day served from the raw event store; earlier rows are legacy history. Null for a type with legacy history only." }, "from": { "type": "string", "format": "date-time" }, "to": { "type": "string", "format": "date-time" }, "count": { "type": "integer" }, "bars": { "type": "array", "items": { "type": "object", "required": [ "date", "avg", "source" ], "properties": { "date": { "type": "string", "format": "date", "description": "UTC day." }, "open": { "type": [ "number", "null" ], "description": "Price at the start of the day (median across zones for `direct`); null when the source only has an average." }, "high": { "type": [ "number", "null" ], "description": "Highest price of the day, any zone; null when unavailable." }, "low": { "type": [ "number", "null" ], "description": "Lowest price of the day, any zone; null when unavailable." }, "close": { "type": [ "number", "null" ], "description": "Price at the end of the day; null when unavailable." }, "avg": { "type": "number", "description": "Time-weighted (or, for titans, sampled) daily average, USD per hour. Equals the public dashboard value." }, "dur": { "type": [ "integer", "null" ], "description": "Seconds of the day covered by known prices (`direct` rows only)." }, "source": { "$ref": "#/components/schemas/Source" } } } } } }, "MonthlySeries": { "type": "object", "properties": { "provider": { "type": "string" }, "region": { "type": "string" }, "instance": { "type": "string" }, "count": { "type": "integer" }, "months": { "type": "array", "items": { "type": "object", "required": [ "date", "avg", "source" ], "properties": { "date": { "type": "string", "format": "date", "description": "First day of the month." }, "open": { "type": [ "number", "null" ] }, "high": { "type": [ "number", "null" ] }, "low": { "type": [ "number", "null" ] }, "close": { "type": [ "number", "null" ] }, "avg": { "type": "number", "description": "Median of the month's daily averages (or the adjusted archive value), USD per hour." }, "days": { "type": [ "integer", "null" ], "description": "Days of daily data behind the month; null for uscisi-adjusted months." }, "source": { "$ref": "#/components/schemas/Source" } } } }, "archive": { "type": "array", "description": "Raw USC/ISI archive months (AWS legacy types only), unadjusted.", "items": { "type": "object", "properties": { "date": { "type": "string", "format": "date" }, "open": { "type": "number" }, "high": { "type": "number" }, "low": { "type": "number" }, "close": { "type": "number" }, "avg": { "type": "number" } } } }, "archive_note": { "type": "string", "description": "Standing of the archive rows." } } }, "LatestList": { "type": "object", "properties": { "provider": { "type": "string" }, "region": { "type": "string" }, "as_of": { "type": "string", "format": "date-time", "description": "Newest event in the region; the snapshot is current to this time." }, "count": { "type": "integer" }, "prices": { "type": "array", "items": { "type": "object", "properties": { "instance": { "type": "string" }, "az": { "type": "string" }, "product": { "type": "string" }, "price": { "type": "number", "description": "USD per hour." }, "since": { "type": "string", "format": "date-time", "description": "When this price took effect." }, "age_seconds": { "type": "integer", "description": "Seconds since `since`, at response time." } } } } } }, "ProviderSnapshot": { "type": "object", "properties": { "provider": { "type": "string" }, "regions": { "type": "array", "items": { "type": "object", "properties": { "region": { "type": "string" }, "instances": { "type": "integer" }, "as_of": { "type": "string", "format": "date-time" } } } }, "count": { "type": "integer" }, "prices": { "type": "array", "items": { "type": "object", "properties": { "region": { "type": "string" }, "instance": { "type": "string" }, "az": { "type": "string" }, "product": { "type": "string" }, "price": { "type": "number" }, "since": { "type": "string", "format": "date-time" }, "age_seconds": { "type": "integer" } } } } } }, "PricePoint": { "type": "object", "required": [ "date", "price" ], "properties": { "date": { "type": "string", "format": "date", "description": "Day the price took effect." }, "price": { "type": "number", "description": "USD per hour." } } }, "OnDemandHistory": { "type": "object", "properties": { "provider": { "type": "string" }, "region": { "type": "string" }, "instance": { "type": "string" }, "note": { "type": "string" }, "current": { "$ref": "#/components/schemas/PricePoint" }, "count": { "type": "integer" }, "changes": { "type": "array", "items": { "$ref": "#/components/schemas/PricePoint" } } } }, "OnDemandSnapshot": { "type": "object", "properties": { "provider": { "type": "string" }, "region": { "type": "string" }, "note": { "type": "string" }, "count": { "type": "integer" }, "prices": { "type": "array", "items": { "type": "object", "properties": { "instance": { "type": "string" }, "price": { "type": "number" }, "since": { "type": "string", "format": "date" } } } } } }, "ReservedHistory": { "type": "object", "properties": { "provider": { "type": "string", "const": "aws" }, "region": { "type": "string" }, "instance": { "type": "string" }, "note": { "type": "string" }, "series": { "type": "array", "items": { "type": "object", "properties": { "ri_type": { "type": "string" }, "current": { "$ref": "#/components/schemas/PricePoint" }, "count": { "type": "integer" }, "changes": { "type": "array", "items": { "$ref": "#/components/schemas/PricePoint" } } } } } } }, "ReservedSnapshot": { "type": "object", "properties": { "provider": { "type": "string", "const": "aws" }, "region": { "type": "string" }, "note": { "type": "string" }, "count": { "type": "integer" }, "prices": { "type": "array", "items": { "type": "object", "properties": { "instance": { "type": "string" }, "ri_type": { "type": "string" }, "price": { "type": "number" }, "since": { "type": "string", "format": "date" } } } } } }, "GpuModels": { "type": "object", "properties": { "note": { "type": "string" }, "providers": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string" }, "latest_day": { "type": "string", "format": "date" }, "quotes": { "type": "integer" } } } }, "models": { "type": "array", "items": { "type": "object", "properties": { "gpu": { "type": "string" }, "providers": { "type": "integer" }, "quotes": { "type": "integer" }, "first_day": { "type": "string", "format": "date" }, "last_day": { "type": "string", "format": "date" }, "min_price_gpu_hr": { "type": "number" }, "hyperscaler_spot_legs": { "type": "array", "items": { "type": "string" } } } } } } }, "GpuQuote": { "type": "object", "required": [ "provider", "market", "gpus", "price_gpu_hr" ], "properties": { "provider": { "type": "string" }, "market": { "type": "string", "enum": [ "ondemand", "spot", "bid", "secure", "community" ] }, "gpus": { "type": "integer", "description": "GPUs in the quoted unit." }, "price_gpu_hr": { "type": "number", "description": "USD per GPU-hour." }, "price_unit_hr": { "type": "number", "description": "USD per hour for the quoted unit." }, "region": { "type": [ "string", "null" ] }, "sku": { "type": [ "string", "null" ] }, "observed": { "type": "string", "format": "date-time" }, "extra": { "type": [ "object", "null" ], "description": "Provider-specific detail (offer id, host reliability, VRAM, stock)." } } }, "GpuQuotes": { "type": "object", "properties": { "gpu": { "type": "string" }, "count": { "type": "integer" }, "note": { "type": "string" }, "quotes": { "type": "array", "items": { "$ref": "#/components/schemas/GpuQuote" } } } }, "GpuIndexRow": { "type": "object", "required": [ "day", "provider", "market", "n", "lo", "median" ], "properties": { "day": { "type": "string", "format": "date" }, "provider": { "type": "string", "description": "A quote provider, or `aws-spot` / `gcp-spot` for legs from our own events." }, "market": { "type": "string" }, "region": { "type": "string", "description": "Hyperscaler legs only." }, "instance": { "type": "string", "description": "Hyperscaler legs only." }, "gpus": { "type": "integer", "description": "Hyperscaler legs only: GPUs per node." }, "n": { "type": "integer", "description": "Quotes behind the row (1 for hyperscaler legs)." }, "lo": { "type": "number" }, "hi": { "type": "number" }, "median": { "type": "number" }, "mean": { "type": "number" } } }, "GpuIndex": { "type": "object", "properties": { "gpu": { "type": "string" }, "note": { "type": "string" }, "count": { "type": "integer" }, "series": { "type": "array", "items": { "$ref": "#/components/schemas/GpuIndexRow" } } } }, "GpuSnapshot": { "type": "object", "properties": { "note": { "type": "string" }, "count": { "type": "integer" }, "rows": { "type": "array", "items": { "type": "object", "properties": { "gpu": { "type": "string" }, "provider": { "type": "string" }, "market": { "type": "string" }, "region": { "type": "string" }, "instance": { "type": "string" }, "n": { "type": "integer" }, "lo": { "type": "number" }, "median": { "type": "number" }, "as_of": { "type": "string", "format": "date-time" }, "age_seconds": { "type": "integer" } } } } } }, "Tickers": { "type": "object", "properties": { "methodology": { "type": "string" }, "methodology_url": { "type": "string" }, "unit": { "type": "string" }, "segments": { "type": "object", "additionalProperties": { "type": "object" } }, "count": { "type": "integer" }, "tickers": { "type": "array", "items": { "type": "object", "properties": { "ticker": { "type": "string" }, "gpu": { "type": "string" }, "segment": { "type": "string" }, "segment_name": { "type": "string" }, "description": { "type": "string" } } } } } }, "Fixing": { "type": "object", "required": [ "ticker", "day", "value", "n", "methodology" ], "properties": { "ticker": { "type": "string" }, "gpu": { "type": "string" }, "segment": { "type": "string" }, "day": { "type": "string", "format": "date" }, "methodology": { "type": "string" }, "unit": { "type": "string" }, "value": { "type": "number", "description": "Median USD per GPU-hour of eligible quotes (or median across regions for SPOT composites)." }, "lo": { "type": "number" }, "hi": { "type": "number" }, "n": { "type": "integer", "description": "Quotes (or regions) behind the fixing." }, "members": { "type": "object", "description": "Quote counts per provider/market.", "additionalProperties": { "type": "integer" } }, "regions": { "type": "array", "description": "SPOT composites: per-region values.", "items": { "type": "object", "properties": { "region": { "type": "string" }, "value": { "type": "number" } } } }, "spread_vs_neo": { "type": [ "number", "null" ], "description": "SPOT composite minus the latest NEO fixing." }, "instance": { "type": "string" }, "source": { "type": "string" } } }, "FixingSeries": { "type": "object", "properties": { "ticker": { "type": "string" }, "gpu": { "type": "string" }, "segment": { "type": "string" }, "methodology": { "type": "string" }, "unit": { "type": "string" }, "count": { "type": "integer" }, "series": { "type": "array", "items": { "type": "object", "properties": { "day": { "type": "string", "format": "date" }, "value": { "type": "number" }, "lo": { "type": [ "number", "null" ] }, "hi": { "type": [ "number", "null" ] }, "n": { "type": "integer" }, "source": { "type": "string" }, "instance": { "type": "string" } } } } } }, "Board": { "type": "object", "properties": { "day": { "type": "string", "format": "date" }, "methodology": { "type": "string" }, "unit": { "type": "string" }, "count": { "type": "integer" }, "fixings": { "type": "array", "items": { "type": "object", "properties": { "ticker": { "type": "string" }, "gpu": { "type": "string" }, "segment": { "type": "string" }, "day": { "type": "string", "format": "date" }, "value": { "type": "number" }, "lo": { "type": "number" }, "hi": { "type": "number" }, "n": { "type": "integer" }, "spread_vs_neo": { "type": [ "number", "null" ] } } } } } }, "CapacityStress": { "type": "object", "required": [ "gpu", "day", "score", "components" ], "properties": { "gpu": { "type": "string" }, "day": { "type": "string", "format": "date" }, "methodology": { "type": "string" }, "score": { "type": "number", "description": "0 slack … 100 tight" }, "n_components": { "type": "integer" }, "scale": { "type": "string" }, "components": { "type": "object", "additionalProperties": { "type": "object", "properties": { "stress": { "type": "number" }, "note": { "type": "string" } }, "additionalProperties": true } } } }, "CapacitySeries": { "type": "object", "properties": { "gpu": { "type": "string" }, "methodology": { "type": "string" }, "scale": { "type": "string" }, "count": { "type": "integer" }, "series": { "type": "array", "items": { "type": "object", "properties": { "day": { "type": "string" }, "score": { "type": "number" }, "n_components": { "type": "integer" }, "components": { "type": "object", "additionalProperties": { "type": "number" } } } } } } }, "CapacityBoard": { "type": "object", "properties": { "day": { "type": "string", "format": "date" }, "methodology": { "type": "string" }, "scale": { "type": "string" }, "note": { "type": "string" }, "count": { "type": "integer" }, "models": { "type": "array", "items": { "type": "object", "properties": { "gpu": { "type": "string" }, "score": { "type": "number" }, "n_components": { "type": "integer" }, "components": { "type": "object", "additionalProperties": { "type": "number" } } } } } } }, "TokenModels": { "type": "object", "properties": { "day": { "type": "string", "format": "date" }, "methodology": { "type": "string" }, "unit": { "type": "string" }, "fixing": { "type": "string" }, "frontier_basket": { "type": "array", "items": { "type": "string" } }, "frontier_tickers": { "type": "array", "items": { "type": "string" } }, "count": { "type": "integer" }, "models": { "type": "array", "items": { "type": "object", "properties": { "model": { "type": "string" }, "code": { "type": "string" }, "tickers": { "type": "array", "items": { "type": "string" } }, "rows": { "type": "integer" }, "sources": { "type": "integer" }, "providers": { "type": "integer" }, "input_lo": { "type": [ "number", "null" ] }, "input_hi": { "type": [ "number", "null" ] }, "output_lo": { "type": [ "number", "null" ] }, "output_hi": { "type": [ "number", "null" ] } } } } } }, "TokenQuotes": { "type": "object", "properties": { "model": { "type": "string" }, "code": { "type": "string" }, "day": { "type": "string", "format": "date" }, "unit": { "type": "string" }, "count": { "type": "integer" }, "quotes": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "provider": { "type": "string" }, "sku": { "type": "string" }, "as_of": { "type": "string" }, "input_per_m": { "type": [ "number", "null" ] }, "output_per_m": { "type": [ "number", "null" ] }, "cache_read_per_m": { "type": [ "number", "null" ] }, "context": { "type": [ "integer", "null" ] }, "extra": { "type": [ "object", "null" ] } } } } } }, "TokenFixing": { "type": "object", "required": [ "ticker", "day", "value", "n", "methodology" ], "properties": { "ticker": { "type": "string" }, "model": { "type": "string" }, "basket": { "type": "array", "items": { "type": "string" } }, "side": { "type": "string", "enum": [ "IN", "OUT", "BLEND" ] }, "day": { "type": "string", "format": "date" }, "methodology": { "type": "string" }, "unit": { "type": "string" }, "value": { "type": "number" }, "input": { "type": [ "number", "null" ] }, "output": { "type": [ "number", "null" ] }, "lo": { "type": "number" }, "hi": { "type": "number" }, "n": { "type": "integer" }, "members": { "type": "object", "additionalProperties": { "type": "number" } } } }, "TokenSeries": { "type": "object", "properties": { "ticker": { "type": "string" }, "model": { "type": [ "string", "null" ] }, "side": { "type": "string" }, "methodology": { "type": "string" }, "unit": { "type": "string" }, "count": { "type": "integer" }, "series": { "type": "array", "items": { "type": "object", "properties": { "day": { "type": "string" }, "value": { "type": "number" }, "lo": { "type": "number" }, "hi": { "type": "number" }, "n": { "type": "integer" } } } } } }, "TokenBoard": { "type": "object", "properties": { "day": { "type": "string", "format": "date" }, "methodology": { "type": "string" }, "unit": { "type": "string" }, "frontier": { "type": "object", "additionalProperties": { "type": "object" } }, "count": { "type": "integer" }, "models": { "type": "array", "items": { "type": "object", "properties": { "model": { "type": "string" }, "code": { "type": "string" }, "input": { "type": [ "number", "null" ] }, "output": { "type": [ "number", "null" ] }, "blend": { "type": [ "number", "null" ] }, "n": { "type": "integer" }, "sources": { "type": "integer" }, "providers": { "type": "integer" } } } } } }, "TermPoint": { "type": "object", "required": [ "term", "price" ], "properties": { "term": { "type": "string", "enum": [ "spot", "ondemand", "ri_1y_no_upfront_standard", "ri_1y_all_upfront_standard", "ri_3y_no_upfront_standard", "ri_3y_all_upfront_standard", "cud_1y", "cud_3y" ] }, "label": { "type": "string" }, "price": { "type": "number", "description": "USD per hour for the instance." }, "since": { "type": "string" }, "discount_pct": { "type": "number", "description": "Percent below on-demand." }, "zones": { "type": "integer", "description": "spot only: zones behind the median." } } }, "TermLadder": { "type": "object", "properties": { "provider": { "type": "string" }, "region": { "type": "string" }, "instance": { "type": "string" }, "unit": { "type": "string" }, "note": { "type": "string" }, "terms": { "type": "array", "items": { "$ref": "#/components/schemas/TermPoint" } } } }, "TermCurve": { "type": "object", "properties": { "gpu": { "type": "string" }, "unit": { "type": "string" }, "methodology": { "type": "string" }, "note": { "type": "string" }, "providers": { "type": "object", "additionalProperties": { "type": "object", "properties": { "instance": { "type": "string" }, "gpus_per_node": { "type": "integer" }, "regions": { "type": "integer" }, "terms": { "type": "array", "items": { "type": "object", "properties": { "term": { "type": "string" }, "label": { "type": "string" }, "value": { "type": "number", "description": "Median across regions, USD per GPU-hour." }, "lo": { "type": "number" }, "hi": { "type": "number" }, "regions": { "type": "integer" }, "discount_pct": { "type": [ "number", "null" ] } } } } } } } } }, "EvictionList": { "type": "object", "properties": { "region": { "type": "string" }, "count": { "type": "integer" }, "samples": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "format": "date", "description": "Sample day." }, "sku": { "type": "string" }, "bucket": { "type": "string", "description": "Eviction-rate bucket in percent over the trailing 28 days: `0-5`, `5-10`, `10-15`, `15-20`, `20+`." } } } } } } } } }