MCP 服务器

corpusAI Cloud Pricing

io.github.JTraversa/corpus-cloud-pricing-mcp
云与基础设施 数据与分析 公开且可连接 MCP 2025-11-25

此 MCP 可以做什么

Provides historical and current cloud instance, GPU rental, spot, on-demand, reserved-price, capacity, and pricing-index data.

attestations
Attestations
Free. Daily on-chain attestations of the fixing set. One record per store day: the keccak256 of the day's signed fixings file (served at /attest/<day>.json), the Ethereum Attestation Service UID and transaction on Base (eip155:8453), the publisher address and the schema UID. Re-hash the file bytes and compare with fixingsHash to verify; every row inside the file carries its own EIP-712 signature. See /governance.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'eas': {'type': 'string'}, 'chain': {'type': 'string'}, 'count': {'type': 'number'}, 'publisher': {'type': ['string', 'null']}, 'schemaUid': {'type': 'string'}, 'attestations': {'type': 'array', 'items': {'type': 'object', 'properties': {'tx': {'type': 'string'}, 'day': {'type': 'string'}, 'uid': {'type': ['string', 'null']}, 'uri': {'type': 'string'}, 'count': {'type': 'number'}, 'attested_at': {'type': 'string'}, 'fixingsHash': {'type': 'string'}, 'methodology': {'type': 'string'}}, 'additionalProperties': True}}}, 'additionalProperties': True}
azure_eviction
Azure eviction rates
Paid (0.01 USDC per call). Azure spot eviction-rate history (28-day buckets, sampled daily). 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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['region'], 'properties': {'to': {'type': 'string', 'description': 'Last sample date (inclusive), YYYY-MM-DD. Default: latest.'}, 'sku': {'type': 'string', 'description': 'Optional SKU name (for example `D2s_v5`). Default: every SKU.'}, 'from': {'type': 'string', 'description': 'First sample date (inclusive), YYYY-MM-DD. Default: earliest.'}, 'region': {'enum': ['us-east', 'us-west-2', 'eu-west'], 'type': 'string', 'description': 'Azure region slug: `us-east`, `us-west-2` or `eu-west`.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'count': {'type': 'number'}, 'region': {'type': 'string'}, 'samples': {'type': 'array', 'items': {'type': 'object', 'properties': {'sku': {'type': 'string'}, 'date': {'type': 'string', 'description': 'Sample day.'}, 'bucket': {'type': 'string', 'description': 'Eviction-rate bucket in percent over the trailing 28 days: `0-5`, `5-10`, `10-15`, `15-20`, `20+`.'}}, 'additionalProperties': True}}}, 'additionalProperties': True}
capacity_board
Capacity stress board
Paid (0.10 USDC per call). Every GPU model's capacity stress score for one day, tightest first.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'day': {'type': 'string', 'description': 'YYYY-MM-DD; default latest.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'day': {'type': 'string'}, 'note': {'type': 'string'}, 'count': {'type': 'number'}, 'scale': {'type': 'string'}, 'models': {'type': 'array', 'items': {'type': 'object', 'properties': {'gpu': {'type': 'string'}, 'score': {'type': 'number'}, 'components': {'type': 'object', 'properties': {}, 'additionalProperties': True}, 'n_components': {'type': 'number'}}, 'additionalProperties': True}}, 'methodology': {'type': 'string'}}, 'additionalProperties': True}
capacity_headline
Capacity stress headline
Free. Capacity stress score per GPU model for the latest day, score only. Rounded score from 0 (slack) to 100 (tight) 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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'day': {'type': ['string', 'null']}, 'count': {'type': 'number'}, 'scale': {'type': 'string'}, 'models': {'type': 'array', 'items': {'type': 'object', 'properties': {'gpu': {'type': 'string'}, 'score': {'type': 'number'}, 'signals': {'type': 'number'}}, 'additionalProperties': True}}, 'methodology': {'type': 'string'}}, 'additionalProperties': True}
capacity_history
Capacity stress history
Paid (0.05 USDC per call). Daily capacity stress scores for one GPU model.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['gpu'], 'properties': {'to': {'type': 'string', 'description': 'YYYY-MM-DD.'}, 'gpu': {'type': 'string', 'description': 'Normalized GPU model. Example: H100 SXM'}, 'from': {'type': 'string', 'description': 'YYYY-MM-DD.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'gpu': {'type': 'string'}, 'count': {'type': 'number'}, 'scale': {'type': 'string'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'day': {'type': 'string'}, 'score': {'type': 'number'}, 'components': {'type': 'object', 'properties': {}, 'additionalProperties': True}, 'n_components': {'type': 'number'}}, 'additionalProperties': True}}, 'methodology': {'type': 'string'}}, 'additionalProperties': True}
capacity_stress
Capacity stress score
Paid (0.01 USDC per call). Capacity stress score, 0 (slack) to 100 (tight), for one GPU model on one day, with every component. 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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['gpu'], 'properties': {'day': {'type': 'string', 'description': 'YYYY-MM-DD; default latest.'}, 'gpu': {'type': 'string', 'description': 'Normalized GPU model, e.g. `H100 SXM`. Example: H100 SXM'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['gpu', 'day', 'score', 'components'], 'properties': {'day': {'type': 'string'}, 'gpu': {'type': 'string'}, 'scale': {'type': 'string'}, 'score': {'type': 'number', 'description': '0 (slack) to 100 (tight)'}, 'components': {'type': 'object', 'properties': {}, 'additionalProperties': True}, 'methodology': {'type': 'string'}, 'n_components': {'type': 'number'}}, 'additionalProperties': True}
catalog
Data catalog
Free. Providers, regions, coverage window and event counts. 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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'regions': {'type': 'array', 'items': {'type': 'object', 'properties': {'events': {'type': 'number'}, 'region': {'type': 'string', 'description': 'Slug to pass as `region`.'}, 'ondemand': {'anyOf': [{'type': 'object', 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'types': {'type': 'number'}, 'points': {'type': 'number'}}, 'description': 'On-demand series coverage (types, change points, from, to) or null.', 'additionalProperties': True}, {'type': 'null'}], 'description': 'On-demand series coverage (types, change points, from, to) or null.'}, 'provider': {'type': 'string'}, 'reserved': {'anyOf': [{'type': 'object', 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'types': {'type': 'number'}, 'points': {'type': 'number'}}, 'description': 'AWS reserved-instance series coverage or null.', 'additionalProperties': True}, {'type': 'null'}], 'description': 'AWS reserved-instance series coverage or null.'}, 'instances': {'type': 'number', 'description': 'Types with raw events.'}, 'last_event': {'type': ['string', 'null']}, 'first_event': {'type': ['string', 'null']}, 'history_daily_to': {'type': ['string', 'null']}, 'history_instances': {'type': 'number', 'description': 'Types with legacy history rows.'}, 'history_daily_from': {'type': ['string', 'null']}, 'history_monthly_to': {'type': ['string', 'null']}, 'history_monthly_from': {'type': ['string', 'null']}}, 'additionalProperties': True}}, 'sources': {'type': 'object', 'properties': {}, 'description': 'Legend: source value → what it is and how much to trust it.', 'additionalProperties': True}, 'price_usdc': {'type': 'string', 'description': 'Base price of one paid call (events, hourly, latest, eviction).'}, 'prices_usdc': {'type': 'object', 'properties': {}, 'description': 'Price per operation family: events, hourly, latest, eviction, daily, monthly, snapshot.', 'additionalProperties': True}, 'generated_at': {'type': 'string'}}, 'additionalProperties': True}
gpu_index
GPU rental index
Paid (0.05 USDC per call). Daily USD per GPU-hour index per provider and market for one GPU model, with hyperscaler spot legs. 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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['gpu'], 'properties': {'to': {'type': 'string', 'description': 'Last day (inclusive), YYYY-MM-DD. Default: latest.'}, 'gpu': {'type': 'string', 'description': 'Normalized GPU model from /gpu/models. Example: H100 SXM'}, 'from': {'type': 'string', 'description': 'First day (inclusive), YYYY-MM-DD. Default: earliest.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'gpu': {'type': 'string'}, 'note': {'type': 'string'}, 'count': {'type': 'number'}, 'series': {'type': 'array', 'items': {'type': 'object', 'required': ['day', 'provider', 'market', 'n', 'lo', 'median'], 'properties': {'n': {'type': 'number', 'description': 'Quotes behind the row (1 for hyperscaler legs).'}, 'hi': {'type': 'number'}, 'lo': {'type': 'number'}, 'day': {'type': 'string'}, 'gpus': {'type': 'number', 'description': 'Hyperscaler legs only: GPUs per node.'}, 'mean': {'type': 'number'}, 'market': {'type': 'string'}, 'median': {'type': 'number'}, 'region': {'type': 'string', 'description': 'Hyperscaler legs only.'}, 'instance': {'type': 'string', 'description': 'Hyperscaler legs only.'}, 'provider': {'type': 'string', 'description': 'A quote provider, or `aws-spot` / `gcp-spot` for legs from our own events.'}}, 'additionalProperties': True}}}, 'additionalProperties': True}
gpu_models
GPU models
Free. GPU models with rental quotes, and which providers quote them. Normalized 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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'note': {'type': 'string'}, 'models': {'type': 'array', 'items': {'type': 'object', 'properties': {'gpu': {'type': 'string'}, 'quotes': {'type': 'number'}, 'last_day': {'type': 'string'}, 'first_day': {'type': 'string'}, 'providers': {'type': 'number'}, 'min_price_gpu_hr': {'type': 'number'}, 'hyperscaler_spot_legs': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': True}}, 'providers': {'type': 'array', 'items': {'type': 'object', 'properties': {'quotes': {'type': 'number'}, 'provider': {'type': 'string'}, 'latest_day': {'type': 'string'}}, 'additionalProperties': True}}}, 'additionalProperties': True}
gpu_quotes
GPU rental quotes
Paid (0.01 USDC per call). Latest rental quotes for one GPU model across neo-clouds, marketplaces and other clouds. 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 are each provider's public price feed or page (Vast.ai: the cheapest 64 offers per model, on-demand and bid); /gpu/models lists who quotes each model. Snapshots are taken several times a day.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['gpu'], 'properties': {'gpu': {'type': 'string', 'description': 'Normalized GPU model from /gpu/models, e.g. `H100 SXM`, `H200`, `B200`, `A100 SXM 80GB`, `L40S`, `RTX 4090`. Example: H100 SXM'}, 'market': {'type': 'string', 'description': 'Restrict to one market (`ondemand`, `spot`, `bid`, `secure`, `community`, `network`, `lease`, `executed`).'}, 'provider': {'type': 'string', 'description': 'Restrict to one provider slug as listed by /gpu/models (for example `runpod`, `vast`, `lambda`).'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'gpu': {'type': 'string'}, 'note': {'type': 'string'}, 'count': {'type': 'number'}, 'quotes': {'type': 'array', 'items': {'type': 'object', 'required': ['provider', 'market', 'gpus', 'price_gpu_hr'], 'properties': {'sku': {'type': ['string', 'null']}, 'gpus': {'type': 'number', 'description': 'GPUs in the quoted unit.'}, 'extra': {'anyOf': [{'type': 'object', 'properties': {}, 'description': 'Provider-specific detail (offer id, host reliability, VRAM, stock).', 'additionalProperties': True}, {'type': 'null'}], 'description': 'Provider-specific detail (offer id, host reliability, VRAM, stock).'}, 'market': {'type': 'string', 'description': 'ondemand; spot (interruptible); bid (marketplace minimum bid); secure/community (RunPod tiers); network (io.net network tier); executed (Nosana jobs that ran); lease (Akash active leases); rented (Vast offers inferred taken).'}, 'region': {'type': ['string', 'null']}, 'observed': {'type': 'string'}, 'provider': {'type': 'string'}, 'price_gpu_hr': {'type': 'number', 'description': 'USD per GPU-hour.'}, 'price_unit_hr': {'type': 'number', 'description': 'USD per hour for the quoted unit.'}}, 'additionalProperties': True}}}, 'additionalProperties': True}
gpu_snapshot
GPU market snapshot
Paid (0.10 USDC per call). Every GPU model × provider × market: lowest and median USD per GPU-hour in the latest snapshot, plus hyperscaler spot per region.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'note': {'type': 'string'}, 'rows': {'type': 'array', 'items': {'type': 'object', 'properties': {'n': {'type': 'number'}, 'lo': {'type': 'number'}, 'gpu': {'type': 'string'}, 'as_of': {'type': 'string'}, 'market': {'type': 'string'}, 'median': {'type': 'number'}, 'region': {'type': 'string'}, 'instance': {'type': 'string'}, 'provider': {'type': 'string'}, 'age_seconds': {'type': 'number'}}, 'additionalProperties': True}}, 'count': {'type': 'number'}}, 'additionalProperties': True}
health
Service health
Free. Liveness and store readiness. 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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ok': {'type': 'boolean'}, 'ready': {'type': 'boolean', 'description': 'True once the store has ingested every raw file.'}, 'ingest': {'type': 'object', 'properties': {'done': {'type': 'number'}, 'added': {'type': 'number'}, 'error': {'type': ['string', 'null']}, 'total': {'type': 'number'}}, 'additionalProperties': True}, 'version': {'type': 'string'}}, 'additionalProperties': True}
index_board
Index board
Paid (0.10 USDC per call). Every ticker's fixing for one day in one call.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'day': {'type': 'string', 'description': 'Fixing day, YYYY-MM-DD. Default: latest.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'day': {'type': 'string'}, 'unit': {'type': 'string'}, 'count': {'type': 'number'}, 'fixings': {'type': 'array', 'items': {'type': 'object', 'properties': {'n': {'type': 'number'}, 'hi': {'type': 'number'}, 'lo': {'type': 'number'}, 'day': {'type': 'string'}, 'gpu': {'type': 'string'}, 'value': {'type': 'number'}, 'ticker': {'type': 'string'}, 'segment': {'type': 'string'}, 'spread_vs_neo': {'type': ['number', 'null']}}, 'additionalProperties': True}}, 'methodology': {'type': 'string'}}, 'additionalProperties': True}
index_fixing
Index fixing
Paid (0.01 USDC per call). One day's fixing for a ticker: median USD per GPU-hour of eligible quotes, with low, high and count. Quote segments (MKT, AGG, NEO, INT, EXE, 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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker'], 'properties': {'day': {'type': 'string', 'description': 'Fixing day, YYYY-MM-DD. Default: latest available.'}, 'ticker': {'type': 'string', 'description': 'Ticker from /index/tickers, e.g. `CX.H100SXM.NEO` or `CX.H100SXM.SPOT.US-EAST-1`. Example: CX.H100SXM.NEO'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker', 'day', 'methodology', 'value', 'n'], 'properties': {'n': {'type': 'number', 'description': 'Quotes (or regions) behind the fixing.'}, 'hi': {'type': 'number'}, 'lo': {'type': 'number'}, 'day': {'type': 'string'}, 'gpu': {'type': 'string'}, 'unit': {'type': 'string'}, 'value': {'type': 'number', 'description': 'Median USD per GPU-hour of eligible quotes (or median across regions for SPOT composites).'}, 'source': {'type': 'string'}, 'ticker': {'type': 'string'}, 'members': {'type': 'object', 'properties': {}, 'description': 'Quote counts per provider/market.', 'additionalProperties': True}, 'regions': {'type': 'array', 'items': {'type': 'object', 'properties': {'value': {'type': 'number'}, 'region': {'type': 'string'}}, 'additionalProperties': True}, 'description': 'SPOT composites: per-region values.'}, 'segment': {'type': 'string'}, 'instance': {'type': 'string'}, 'methodology': {'type': 'string'}, 'spread_vs_neo': {'type': ['number', 'null'], 'description': 'SPOT composite minus the latest NEO fixing.'}}, 'additionalProperties': True}
index_history
Index history
Paid (0.05 USDC per call). Daily fixings for a ticker over a date range. 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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker'], 'properties': {'to': {'type': 'string', 'description': 'Last day, YYYY-MM-DD. Default: today.'}, 'from': {'type': 'string', 'description': 'First day, YYYY-MM-DD. Default: earliest.'}, 'ticker': {'type': 'string', 'description': 'Ticker from /index/tickers. Example: CX.H100SXM.NEO'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'gpu': {'type': 'string'}, 'unit': {'type': 'string'}, 'count': {'type': 'number'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'n': {'type': 'number'}, 'hi': {'type': ['number', 'null']}, 'lo': {'type': ['number', 'null']}, 'day': {'type': 'string'}, 'value': {'type': 'number'}, 'source': {'type': 'string'}, 'instance': {'type': 'string'}}, 'additionalProperties': True}}, 'ticker': {'type': 'string'}, 'segment': {'type': 'string'}, 'methodology': {'type': 'string'}}, 'additionalProperties': True}
index_tickers
Index tickers
Free. Every index ticker, its segment and definition. Tickers are CX.<MODEL>.<SEGMENT> (for example CX.H100SXM.NEO) or CX.<MODEL>.SPOT.<REGION>. Includes the segment membership lists and the methodology version.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'unit': {'type': 'string'}, 'count': {'type': 'number'}, 'tickers': {'type': 'array', 'items': {'type': 'object', 'properties': {'gpu': {'type': 'string'}, 'ticker': {'type': 'string'}, 'segment': {'type': 'string'}, 'description': {'type': 'string'}, 'segment_name': {'type': 'string'}}, 'additionalProperties': True}}, 'segments': {'type': 'object', 'properties': {}, 'additionalProperties': True}, 'methodology': {'type': 'string'}, 'methodology_url': {'type': 'string'}}, 'additionalProperties': True}
instances
Instance types in a region
Free. Instance types available in a region. 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-`).
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['provider', 'region'], 'properties': {'prefix': {'type': 'string', 'description': 'Case-sensitive prefix filter on the type name.'}, 'region': {'type': 'string', '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`. Example: us-east-1'}, 'provider': {'enum': ['aws', 'gcp', 'azure'], 'type': 'string', 'description': 'Cloud provider. One of `aws`, `gcp`, `azure`.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'count': {'type': 'number'}, 'region': {'type': 'string'}, 'provider': {'type': 'string'}, 'instances': {'type': 'array', 'items': {'type': 'object', 'properties': {'events': {'type': 'number', 'description': 'Raw events; 0 for legacy-only types.'}, 'instance': {'type': 'string'}, 'last_event': {'type': ['string', 'null']}, 'first_event': {'type': ['string', 'null']}, 'history_daily_to': {'type': ['string', 'null']}, 'history_daily_from': {'type': ['string', 'null']}, 'history_monthly_to': {'type': ['string', 'null']}, 'history_monthly_from': {'type': ['string', 'null']}}, 'additionalProperties': True}}}, 'additionalProperties': True}
ondemand
On-demand price history
Paid (0.01 USDC per call). On-demand list-price history of one instance type. 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 (every AWS region in /catalog). Azure: every Linux VM SKU from the public Retail Prices API, refreshed daily, since 2026-09-13 (every Azure region in /catalog). GCP: the TITANS-era series (2024 to 2026-08), not refreshed.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['provider', 'region', 'instance'], 'properties': {'region': {'type': 'string', '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`. Example: us-east-1'}, 'instance': {'type': 'string', 'description': 'Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large'}, 'provider': {'enum': ['aws', 'gcp', 'azure'], 'type': 'string', 'description': 'Cloud provider. One of `aws`, `gcp`, `azure`.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'note': {'type': 'string'}, 'count': {'type': 'number'}, 'region': {'type': 'string'}, 'changes': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'price'], 'properties': {'date': {'type': 'string', 'description': 'Day the price took effect.'}, 'price': {'type': 'number', 'description': 'USD per hour.'}}, 'additionalProperties': True}}, 'current': {'type': 'object', 'required': ['date', 'price'], 'properties': {'date': {'type': 'string', 'description': 'Day the price took effect.'}, 'price': {'type': 'number', 'description': 'USD per hour.'}}, 'additionalProperties': True}, 'instance': {'type': 'string'}, 'provider': {'type': 'string'}}, 'additionalProperties': True}
ondemand_snapshot
Region on-demand snapshot
Paid (0.10 USDC per call). Current on-demand list price of every instance type in a region.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['provider', 'region'], 'properties': {'region': {'type': 'string', '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`. Example: us-east-1'}, 'provider': {'enum': ['aws', 'gcp', 'azure'], 'type': 'string', 'description': 'Cloud provider. One of `aws`, `gcp`, `azure`.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'note': {'type': 'string'}, 'count': {'type': 'number'}, 'prices': {'type': 'array', 'items': {'type': 'object', 'properties': {'price': {'type': 'number'}, 'since': {'type': 'string'}, 'instance': {'type': 'string'}}, 'additionalProperties': True}}, 'region': {'type': 'string'}, 'provider': {'type': 'string'}}, 'additionalProperties': True}
reserved
Reserved price history
Paid (0.01 USDC per call). Reserved / reservation price history of one instance type (AWS standard RIs 1y/3y no-upfront/all-upfront; Azure reservations 1y/3y). Effective hourly USD with any upfront amortized 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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['region', 'instance'], 'properties': {'region': {'type': 'string', 'description': 'Region slug (for example `us-east-1`, `us-east` for Azure, `us-central1` for GCP). Example: us-east-1'}, 'ri_type': {'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'], 'type': 'string', 'description': 'Restrict to one ri_type.'}, 'instance': {'type': 'string', 'description': 'Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large'}, 'provider': {'enum': ['aws', 'azure', 'gcp'], 'type': 'string', 'description': 'Provider: `aws` (default), `azure` or `gcp`.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'note': {'type': 'string'}, 'region': {'type': 'string'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'count': {'type': 'number'}, 'changes': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'price'], 'properties': {'date': {'type': 'string', 'description': 'Day the price took effect.'}, 'price': {'type': 'number', 'description': 'USD per hour.'}}, 'additionalProperties': True}}, 'current': {'type': 'object', 'required': ['date', 'price'], 'properties': {'date': {'type': 'string', 'description': 'Day the price took effect.'}, 'price': {'type': 'number', 'description': 'USD per hour.'}}, 'additionalProperties': True}, 'ri_type': {'type': 'string'}}, 'additionalProperties': True}}, 'instance': {'type': 'string'}, 'provider': {'type': 'string'}}, 'additionalProperties': True}
reserved_snapshot
Region reserved snapshot
Paid (0.10 USDC per call). Current reserved effective hourly price of every instance type and ri_type in a region (AWS or Azure).
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['region'], 'properties': {'region': {'type': 'string', 'description': 'Region slug (for example `us-east-1`, `us-east` for Azure, `us-central1` for GCP). Example: us-east-1'}, 'provider': {'enum': ['aws', 'azure', 'gcp'], 'type': 'string', 'description': 'Provider: `aws` (default), `azure` or `gcp`.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'note': {'type': 'string'}, 'count': {'type': 'number'}, 'prices': {'type': 'array', 'items': {'type': 'object', 'properties': {'price': {'type': 'number'}, 'since': {'type': 'string'}, 'ri_type': {'type': 'string'}, 'instance': {'type': 'string'}}, 'additionalProperties': True}}, 'region': {'type': 'string'}, 'provider': {'type': 'string'}}, 'additionalProperties': True}
spot_daily
Daily spot history
Paid (0.05 USDC per call). Full daily history for one instance type, all eras stitched. 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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['provider', 'region', 'instance'], 'properties': {'to': {'type': 'string', 'description': 'End of the window (exclusive), ISO 8601 UTC. Default: now.'}, 'from': {'type': 'string', 'description': 'Start of the window (inclusive), ISO 8601 UTC. Default: the earliest row for the type.'}, 'region': {'type': 'string', '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`. Example: us-east-1'}, 'instance': {'type': 'string', 'description': 'Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large'}, 'provider': {'enum': ['aws', 'gcp', 'azure'], 'type': 'string', 'description': 'Cloud provider. One of `aws`, `gcp`, `azure`.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string'}, 'bars': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'avg', 'source'], 'properties': {'avg': {'type': 'number', 'description': 'Time-weighted (or, for titans, sampled) daily average, USD per hour. Equals the public dashboard value.'}, 'dur': {'type': ['number', 'null'], 'description': 'Seconds of the day covered by known prices (`direct` rows only).'}, 'low': {'type': ['number', 'null'], 'description': 'Lowest price of the day, any zone; null when unavailable.'}, 'date': {'type': 'string', 'description': 'UTC day.'}, 'high': {'type': ['number', 'null'], 'description': 'Highest price of the day, any zone; null when unavailable.'}, '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.'}, 'close': {'type': ['number', 'null'], 'description': 'Price at the end of the day; null when unavailable.'}, 'source': {'type': 'string', 'description': 'Where a row comes from; see `sources` in /catalog for the legend and standing of each.'}}, 'additionalProperties': True}}, 'from': {'type': 'string'}, 'count': {'type': 'number'}, 'zones': {'type': 'number', 'description': 'Zone series collapsed in the `direct` rows.'}, 'region': {'type': 'string'}, 'instance': {'type': 'string'}, 'provider': {'type': 'string'}, 'direct_from': {'type': ['string', 'null'], 'description': 'First day served from the raw event store; earlier rows are legacy history. Null for a type with legacy history only.'}}, 'additionalProperties': True}
spot_events
Spot price events
Paid (0.01 USDC per call). Raw spot price-change events for one instance type. 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`.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['provider', 'region', 'instance'], 'properties': {'az': {'type': 'string', 'description': 'Restrict to one availability zone / zone id (for example `use1-az1`). Default: all zones.'}, 'to': {'type': 'string', 'description': 'End of the window (exclusive), ISO 8601 UTC. Default: now.'}, 'from': {'type': 'string', 'description': 'Start of the window (inclusive), ISO 8601 UTC. Default: 7 days before `to`.'}, 'limit': {'type': 'integer', 'description': 'Maximum rows to return (1 to 10000). Default 5000.'}, 'region': {'type': 'string', '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`. Example: us-east-1'}, 'product': {'type': 'string', 'description': 'Restrict to one product / OS string (for example `Linux/UNIX`, `Spot`, `Linux`). Default: all.'}, 'instance': {'type': 'string', 'description': 'Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large'}, 'provider': {'enum': ['aws', 'gcp', 'azure'], 'type': 'string', 'description': 'Cloud provider. One of `aws`, `gcp`, `azure`.'}, 'include_repeats': {'type': 'boolean', 'description': 'Keep events whose price equals the previous event of the same (az, product) series. Default false.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'count': {'type': 'number'}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['ts', 'az', 'product', 'price'], 'properties': {'az': {'type': 'string', 'description': 'Availability zone or zone id; the region name for GCP.'}, 'ts': {'type': 'string', 'description': 'When the price took effect (UTC).'}, 'price': {'type': 'number', 'description': 'USD per hour.'}, 'product': {'type': 'string', 'description': 'Product / OS the price applies to.'}}, 'additionalProperties': True}}, 'region': {'type': 'string'}, 'instance': {'type': 'string'}, 'provider': {'type': 'string'}, 'next_from': {'type': ['string', 'null'], 'description': 'Pass as `from` to continue when truncated.'}, 'truncated': {'type': 'boolean', 'description': 'True when `limit` was hit.'}}, 'additionalProperties': True}
spot_hourly
Hourly spot bars
Paid (0.01 USDC per call). Hourly time-weighted OHLC bars for one instance type. 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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['provider', 'region', 'instance'], 'properties': {'to': {'type': 'string', 'description': 'End of the window (exclusive), ISO 8601 UTC. Default: now.'}, 'from': {'type': 'string', 'description': 'Start of the window (inclusive), ISO 8601 UTC. Default: 30 days before `to`.'}, 'region': {'type': 'string', '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`. Example: us-east-1'}, 'instance': {'type': 'string', 'description': 'Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large'}, 'provider': {'enum': ['aws', 'gcp', 'azure'], 'type': 'string', 'description': 'Cloud provider. One of `aws`, `gcp`, `azure`.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string'}, 'bars': {'type': 'array', 'items': {'type': 'object', 'required': ['hour', 'open', 'high', 'low', 'close', 'avg'], 'properties': {'avg': {'type': 'number', 'description': 'Time-weighted average price over the bucket (median across AZs). This is the value the public dashboard shows.'}, 'dur': {'type': 'number', 'description': 'Seconds of the bucket covered by known prices (a partial value means the series starts or ends inside the bucket).'}, 'low': {'type': 'number', 'description': 'Lowest price seen in any AZ during the bucket.'}, 'high': {'type': 'number', 'description': 'Highest price seen in any AZ during the bucket.'}, '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).'}, 'close': {'type': 'number', 'description': 'Price in force at the end of the bucket (median across AZs).'}}, 'additionalProperties': True}}, 'from': {'type': 'string'}, 'count': {'type': 'number'}, 'zones': {'type': 'number', 'description': 'Number of zone series collapsed.'}, 'region': {'type': 'string'}, 'instance': {'type': 'string'}, 'provider': {'type': 'string'}}, 'additionalProperties': True}
spot_latest
Current spot price per zone
Paid (0.01 USDC per call). Price currently in force per zone and product for one instance type. 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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['provider', 'region', 'instance'], 'properties': {'region': {'type': 'string', '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`. Example: us-east-1'}, 'instance': {'type': 'string', 'description': 'Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large'}, 'provider': {'enum': ['aws', 'gcp', 'azure'], 'type': 'string', 'description': 'Cloud provider. One of `aws`, `gcp`, `azure`.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'as_of': {'type': 'string', 'description': 'Newest event in the region; the snapshot is current to this time.'}, 'count': {'type': 'number'}, 'prices': {'type': 'array', 'items': {'type': 'object', 'properties': {'az': {'type': 'string'}, 'price': {'type': 'number', 'description': 'USD per hour.'}, 'since': {'type': 'string', 'description': 'When this price took effect.'}, 'product': {'type': 'string'}, 'instance': {'type': 'string'}, 'age_seconds': {'type': 'number', 'description': 'Seconds since `since`, at response time.'}}, 'additionalProperties': True}}, 'region': {'type': 'string'}, 'provider': {'type': 'string'}}, 'additionalProperties': True}
spot_monthly
Monthly spot history
Paid (0.05 USDC per call). Full monthly history for one instance type, back to 2014 for legacy AWS types. 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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['provider', 'region', 'instance'], 'properties': {'to': {'type': 'string', 'description': 'Last month (inclusive), YYYY-MM-DD. Default: latest.'}, 'from': {'type': 'string', 'description': 'First month (inclusive), YYYY-MM-DD (use the 1st). Default: earliest.'}, 'region': {'type': 'string', '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`. Example: us-east-1'}, 'instance': {'type': 'string', 'description': 'Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large'}, 'provider': {'enum': ['aws', 'gcp', 'azure'], 'type': 'string', 'description': 'Cloud provider. One of `aws`, `gcp`, `azure`.'}, 'include_archive': {'type': 'boolean', 'description': 'Include the raw USC/ISI archive rows in `archive`. Default true.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'count': {'type': 'number'}, 'months': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'avg', 'source'], 'properties': {'avg': {'type': 'number', 'description': "Median of the month's daily averages (or the adjusted archive value), USD per hour."}, 'low': {'type': ['number', 'null']}, 'date': {'type': 'string', 'description': 'First day of the month.'}, 'days': {'type': ['number', 'null'], 'description': 'Days of daily data behind the month; null for uscisi-adjusted months.'}, 'high': {'type': ['number', 'null']}, 'open': {'type': ['number', 'null']}, 'close': {'type': ['number', 'null']}, 'source': {'type': 'string', 'description': 'Where a row comes from; see `sources` in /catalog for the legend and standing of each.'}}, 'additionalProperties': True}}, 'region': {'type': 'string'}, 'archive': {'type': 'array', 'items': {'type': 'object', 'properties': {'avg': {'type': 'number'}, 'low': {'type': 'number'}, 'date': {'type': 'string'}, 'high': {'type': 'number'}, 'open': {'type': 'number'}, 'close': {'type': 'number'}}, 'additionalProperties': True}, 'description': 'Raw USC/ISI archive months (AWS legacy types only), unadjusted.'}, 'instance': {'type': 'string'}, 'provider': {'type': 'string'}, 'archive_note': {'type': 'string', 'description': 'Standing of the archive rows.'}}, 'additionalProperties': True}
spot_snapshot
Region spot snapshot
Paid (0.10 USDC per call). Current price of every instance type, zone and product in a whole region, in one call. 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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['provider', 'region'], 'properties': {'region': {'type': 'string', '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`. Example: us-east-1'}, 'provider': {'enum': ['aws', 'gcp', 'azure'], 'type': 'string', 'description': 'Cloud provider. One of `aws`, `gcp`, `azure`.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'as_of': {'type': 'string', 'description': 'Newest event in the region; the snapshot is current to this time.'}, 'count': {'type': 'number'}, 'prices': {'type': 'array', 'items': {'type': 'object', 'properties': {'az': {'type': 'string'}, 'price': {'type': 'number', 'description': 'USD per hour.'}, 'since': {'type': 'string', 'description': 'When this price took effect.'}, 'product': {'type': 'string'}, 'instance': {'type': 'string'}, 'age_seconds': {'type': 'number', 'description': 'Seconds since `since`, at response time.'}}, 'additionalProperties': True}}, 'region': {'type': 'string'}, 'provider': {'type': 'string'}}, 'additionalProperties': True}
status
Data freshness
Free. Freshness of every data source. 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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ok': {'type': 'boolean'}, 'ready': {'type': 'boolean'}, 'sources': {'type': 'object', 'properties': {}, 'additionalProperties': True}, 'methodology': {'type': 'string'}}, 'additionalProperties': True}
term
GPU term structure
Paid (0.05 USDC per call). Term structure per hyperscaler for one GPU model, USD per GPU-hour: spot, on-demand, 1y, 3y. 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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['gpu'], 'properties': {'gpu': {'type': 'string', 'description': 'Normalized GPU model with a hyperscaler mapping, e.g. `H100 SXM`, `A100 SXM 80GB`, `L4`, `T4`. Example: H100 SXM'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'gpu': {'type': 'string'}, 'note': {'type': 'string'}, 'unit': {'type': 'string'}, 'providers': {'type': 'object', 'properties': {}, 'additionalProperties': True}, 'methodology': {'type': 'string'}}, 'additionalProperties': True}
term_instance
Instance price ladder
Paid (0.01 USDC per call). Price ladder for one instance type: spot, on-demand, 1-year and 3-year commitments, with discounts. 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 amortized. `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).
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['provider', 'region', 'instance'], 'properties': {'region': {'type': 'string', '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`. Example: us-east-1'}, 'instance': {'type': 'string', 'description': 'Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large'}, 'provider': {'enum': ['aws', 'gcp', 'azure'], 'type': 'string', 'description': 'Cloud provider. One of `aws`, `gcp`, `azure`.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'note': {'type': 'string'}, 'unit': {'type': 'string'}, 'terms': {'type': 'array', 'items': {'type': 'object', 'required': ['term', 'price'], 'properties': {'term': {'type': 'string', 'description': 'One of: 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'}, 'zones': {'type': 'number', 'description': 'spot only: zones behind the median.'}, 'discount_pct': {'type': 'number', 'description': 'Percent below on-demand.'}}, 'additionalProperties': True}}, 'region': {'type': 'string'}, 'instance': {'type': 'string'}, 'provider': {'type': 'string'}}, 'additionalProperties': True}
tokens_board
LLM token board
Paid (0.10 USDC per call). Every model's input, output and blended fixing for one day, plus the frontier basket.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'day': {'type': 'string', 'description': 'YYYY-MM-DD; default latest.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'day': {'type': 'string'}, 'unit': {'type': 'string'}, 'count': {'type': 'number'}, 'models': {'type': 'array', 'items': {'type': 'object', 'properties': {'n': {'type': 'number'}, 'code': {'type': 'string'}, 'blend': {'type': ['number', 'null']}, 'input': {'type': ['number', 'null']}, 'model': {'type': 'string'}, 'output': {'type': ['number', 'null']}, 'sources': {'type': 'number'}, 'providers': {'type': 'number'}}, 'additionalProperties': True}}, 'frontier': {'type': 'object', 'properties': {}, 'additionalProperties': True}, 'methodology': {'type': 'string'}}, 'additionalProperties': True}
tokens_fixing
LLM token fixing
Paid (0.01 USDC per call). One day's token price fixing for a ticker such as CX.TOK.CLAUDESONNET5.IN. 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.<side>` is the median across the frontier basket listed by /tokens/models.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker'], 'properties': {'day': {'type': 'string', 'description': 'YYYY-MM-DD; default latest.'}, 'ticker': {'type': 'string', 'description': 'CX.TOK.<MODELCODE>.IN | OUT | BLEND, or CX.TOK.FRONTIER.<side>. Example: CX.TOK.FRONTIER.BLEND'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker', 'day', 'methodology', 'value', 'n'], 'properties': {'n': {'type': 'number'}, 'hi': {'type': 'number'}, 'lo': {'type': 'number'}, 'day': {'type': 'string'}, 'side': {'type': 'string', 'description': 'One of: IN, OUT, BLEND'}, 'unit': {'type': 'string'}, 'input': {'type': ['number', 'null']}, 'model': {'type': 'string'}, 'value': {'type': 'number'}, 'basket': {'type': 'array', 'items': {'type': 'string'}}, 'output': {'type': ['number', 'null']}, 'ticker': {'type': 'string'}, 'members': {'type': 'object', 'properties': {}, 'additionalProperties': True}, 'methodology': {'type': 'string'}}, 'additionalProperties': True}
tokens_history
LLM token history
Paid (0.05 USDC per call). Daily fixings for a token ticker, from the first snapshot (2026-09-14).
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker'], 'properties': {'to': {'type': 'string', 'description': 'YYYY-MM-DD.'}, 'from': {'type': 'string', 'description': 'YYYY-MM-DD.'}, 'ticker': {'type': 'string', 'description': 'Token ticker. Example: CX.TOK.FRONTIER.BLEND'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'side': {'type': 'string'}, 'unit': {'type': 'string'}, 'count': {'type': 'number'}, 'model': {'type': ['string', 'null']}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'n': {'type': 'number'}, 'hi': {'type': 'number'}, 'lo': {'type': 'number'}, 'day': {'type': 'string'}, 'value': {'type': 'number'}}, 'additionalProperties': True}}, 'ticker': {'type': 'string'}, 'methodology': {'type': 'string'}}, 'additionalProperties': True}
tokens_models
LLM models with token prices
Free. Every LLM with a token price fixing, its ticker codes and today's price range. 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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'day': {'type': 'string'}, 'unit': {'type': 'string'}, 'count': {'type': 'number'}, 'fixing': {'type': 'string'}, 'models': {'type': 'array', 'items': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'rows': {'type': 'number'}, 'model': {'type': 'string'}, 'sources': {'type': 'number'}, 'tickers': {'type': 'array', 'items': {'type': 'string'}}, 'input_hi': {'type': ['number', 'null']}, 'input_lo': {'type': ['number', 'null']}, 'output_hi': {'type': ['number', 'null']}, 'output_lo': {'type': ['number', 'null']}, 'providers': {'type': 'number'}}, 'additionalProperties': True}}, 'methodology': {'type': 'string'}, 'frontier_basket': {'type': 'array', 'items': {'type': 'string'}}, 'frontier_tickers': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': True}
tokens_quotes
LLM token quotes
Paid (0.01 USDC per call). Every listed price for one model on one day: each source and hosting provider, USD per million tokens. 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`.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['model'], 'properties': {'day': {'type': 'string', 'description': 'YYYY-MM-DD; default latest.'}, 'model': {'type': 'string', 'description': 'Canonical model slug from /tokens/models. Example: deepseek-v3'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'day': {'type': 'string'}, 'code': {'type': 'string'}, 'unit': {'type': 'string'}, 'count': {'type': 'number'}, 'model': {'type': 'string'}, 'quotes': {'type': 'array', 'items': {'type': 'object', 'properties': {'sku': {'type': 'string'}, 'as_of': {'type': 'string'}, 'extra': {'anyOf': [{'type': 'object', 'properties': {}, 'additionalProperties': True}, {'type': 'null'}]}, 'source': {'type': 'string'}, 'context': {'type': ['number', 'null']}, 'provider': {'type': 'string'}, 'input_per_m': {'type': ['number', 'null']}, 'output_per_m': {'type': ['number', 'null']}, 'cache_read_per_m': {'type': ['number', 'null']}}, 'additionalProperties': True}}}, 'additionalProperties': True}
已移除
spot_snapshot_all
2026年9月29日 02:48
已更改
azure_eviction
2026年9月29日 02:48
已更改
term
2026年9月29日 02:48
已更改
term_instance
2026年9月29日 02:48
已更改
tokens_board
2026年9月29日 02:48
已更改
tokens_history
2026年9月29日 02:48
已更改
tokens_fixing
2026年9月29日 02:48
已更改
tokens_quotes
2026年9月29日 02:48
已更改
tokens_models
2026年9月29日 02:48
已更改
capacity_board
2026年9月29日 02:48
已更改
capacity_history
2026年9月29日 02:48
已更改
capacity_stress
2026年9月29日 02:48
已更改
capacity_headline
2026年9月29日 02:48
已添加
attestations
2026年9月29日 02:48
已更改
index_board
2026年9月29日 02:48
已更改
index_history
2026年9月29日 02:48
已更改
index_fixing
2026年9月29日 02:48
已更改
index_tickers
2026年9月29日 02:48
已更改
status
2026年9月29日 02:48
已更改
gpu_snapshot
2026年9月29日 02:48
已更改
gpu_index
2026年9月29日 02:48
已更改
gpu_quotes
2026年9月29日 02:48
已更改
gpu_models
2026年9月29日 02:48
已更改
reserved_snapshot
2026年9月29日 02:48
已更改
reserved
2026年9月29日 02:48
已更改
ondemand_snapshot
2026年9月29日 02:48
已更改
ondemand
2026年9月29日 02:48
已更改
spot_snapshot
2026年9月29日 02:48
已更改
spot_latest
2026年9月29日 02:48
已更改
spot_monthly
2026年9月29日 02:48