{ "openapi": "3.1.0", "info": { "title": "AI Compute Tracker open data", "version": "1.1.0", "summary": "The price of compute, tracked.", "description": "Independent tracker of AI compute economics: GPU rental prices, accelerator specs and cost-efficiency, token prices, and the datacenter buildout. The contract follows semantic versioning. Additive, backwards-compatible changes — a new field, a new endpoint — bump the minor version and never rename, remove, or re-type an existing field. Breaking changes — a renamed or removed field, changed units or semantics — bump the major version and are announced with a deprecation window during which the previous shape keeps being served. Documentation-only corrections bump the patch version.", "license": { "name": "CC BY 4.0", "url": "https://creativecommons.org/licenses/by/4.0/" } }, "externalDocs": { "description": "Human-readable endpoint documentation", "url": "https://aicomputetracker.com/data/" }, "servers": [ { "url": "https://aicomputetracker.com" } ], "paths": { "/forward-curves.json": { "get": { "operationId": "getForwardCurvesJson", "summary": "Forward curves", "description": "Full forward-curve snapshot: instrument-specific anchors, monthly tenors, methodology identity, and per-point ladder evidence. Values are reconstructed market-implied levels, never current spot or executable quotes. Check per-point quality: thin or interpolated points render hollow on the site and carry estimated: true here.", "x-freshness-clock": { "clock": "market-snapshot", "label": "Market snapshot", "asOf": "2026-08-22T02:03:10.544Z" }, "responses": { "200": { "description": "Forward curves payload", "content": { "application/json": { "schema": { "type": "object", "properties": { "contractVersion": { "description": "Semver of the open-data contract this payload was published under; see the stability policy.", "type": "string" }, "license": { "description": "Open-data license the payload is published under.", "type": "object", "properties": { "name": { "description": "Human-readable license name.", "type": "string" }, "url": { "description": "Canonical license text URL.", "type": "string" }, "attribution": { "description": "The exact attribution line reusers should carry.", "type": "string" } }, "required": [ "name", "url", "attribution" ] }, "asOf": { "description": "Market-snapshot timestamp (ISO 8601) the curves were reconstructed at.", "type": "string" }, "unit": { "description": "Price unit shared by every curve value (USD per GPU-hour).", "type": "string" }, "note": { "description": "Payload-level methodology caveat: anchor instruments, smoothing, and non-executability.", "type": "string" }, "tenors": { "description": "Display labels for each curve position; the first entry is the instrument-specific anchor.", "type": "array", "items": { "type": "string" } }, "estimatedFromIndex": { "description": "First curve index at which at least one chip failed a ladder-quality gate; per-point quality stays authoritative.", "type": "integer" }, "estimatorVersion": { "description": "Version of the ladder-to-implied-median estimator.", "type": "string" }, "transformVersion": { "description": "Version of the smoothing transform applied to monthly tenors.", "type": "string" }, "methodologyVersion": { "description": "Combined estimator + transform key; historical comparisons require an exact match.", "type": "string" }, "anchors": { "description": "First-point instrument identity, keyed by curve id.", "type": "object", "additionalProperties": { "type": "object", "properties": { "instrument": { "description": "Anchor instrument: a future exact-time weekly contract, or the front-month monthly average (RTX 5090).", "type": "string", "enum": [ "weekly-exact-time", "monthly-average" ] }, "seriesTicker": { "description": "Kalshi series ticker backing the anchor.", "type": "string" }, "eventTicker": { "description": "Exact Kalshi event ticker; null on legacy imports.", "type": [ "string", "null" ] }, "methodologyVersion": { "description": "Methodology key the anchor was published under.", "type": "string" } }, "required": [ "instrument", "seriesTicker", "eventTicker", "methodologyVersion" ] } }, "chips": { "description": "One entry per published curve.", "type": "array", "items": { "type": "object", "properties": { "id": { "description": "Curve id (also the key into anchors).", "type": "string" }, "label": { "description": "Display label of the chip.", "type": "string" }, "memory": { "description": "Memory configuration descriptor.", "type": "string" }, "priorSnapshotChangePct": { "description": "Anchor move (%) vs the prior snapshot of the same contract and methodology; null when no comparable prior exists.", "type": [ "number", "null" ] }, "priorSnapshotAt": { "description": "ISO timestamp of that comparable prior snapshot.", "type": [ "string", "null" ] }, "priorSnapshotElapsedMinutes": { "description": "Actual elapsed minutes since the prior snapshot (never assumed to be 1d).", "type": [ "integer", "null" ] }, "period": { "description": "Label of the compatible-history movement window.", "type": "string" }, "periodChangePct": { "description": "Compatible-instrument move (%) over that window, when enough history exists.", "type": [ "number", "null" ] }, "curve": { "description": "Curve values aligned index-for-index with tenors, in USD per GPU-hour.", "type": "array", "items": { "type": "number" } }, "provenance": { "description": "Series-level ingestion evidence for the whole curve.", "type": "object", "properties": { "ingestionStatus": { "description": "Live pipeline fetch, or a legacy import.", "type": "string", "enum": [ "live-fetch", "legacy-import" ] }, "monthlySeriesTicker": { "description": "Kalshi monthly-average series ticker.", "type": "string" }, "spotSeriesTicker": { "description": "Weekly exact-time series ticker; null when the chip has none.", "type": [ "string", "null" ] }, "sourceUrl": { "description": "Kalshi API URL for the series.", "type": "string" }, "fetchedAt": { "description": "ISO timestamp of the fetch.", "type": "string" }, "latestMarketAt": { "description": "Most recent exchange timestamp seen across the series.", "type": [ "string", "null" ] }, "monthlyEventCount": { "description": "Monthly events discovered.", "type": "integer" }, "usableTenorCount": { "description": "Tenors with a usable ladder.", "type": "integer" }, "interpolatedTenorCount": { "description": "Tenors filled by interpolation.", "type": "integer" }, "marketCount": { "description": "Markets inspected.", "type": "integer" }, "twoSidedMarketCount": { "description": "Markets quoting both sides.", "type": "integer" }, "totalVolume": { "description": "Summed contract volume.", "type": "number" }, "totalOpenInterest": { "description": "Summed open interest.", "type": "number" }, "totalLiquidityUsd": { "description": "Summed resting liquidity in USD.", "type": "number" }, "estimatorVersion": { "description": "Estimator version the series was built with.", "type": "string" }, "transformVersion": { "description": "Transform version the series was built with.", "type": "string" }, "points": { "description": "Per-point ladder evidence aligned with tenors.", "type": "array", "items": { "type": "object", "properties": { "kind": { "description": "Serialized point kind; \"spot\" is the historical name for the first curve anchor.", "type": "string", "enum": [ "spot", "monthly" ] }, "tenorKey": { "description": "Stable YYYY-MM identity for monthly points; the instrument-specific anchor has no key.", "type": [ "string", "null" ] }, "seriesTicker": { "description": "Kalshi series ticker the ladder belongs to.", "type": "string" }, "eventTicker": { "description": "Exact Kalshi event ticker; null on legacy imports.", "type": [ "string", "null" ] }, "sourceUrl": { "description": "Kalshi API URL the ladder was fetched from.", "type": "string" }, "latestMarketAt": { "description": "Most recent exchange timestamp exposed by the event, when present.", "type": [ "string", "null" ] }, "strikeCount": { "description": "Number of strikes listed in the ladder.", "type": "integer" }, "twoSidedCount": { "description": "Strikes quoting both a bid and an ask.", "type": "integer" }, "medianSpreadPoints": { "description": "Median bid/ask spread across the ladder, in probability points.", "type": [ "number", "null" ] }, "totalVolume": { "description": "Summed contract volume.", "type": "number" }, "totalOpenInterest": { "description": "Summed open interest.", "type": "number" }, "totalLiquidityUsd": { "description": "Summed resting liquidity in USD.", "type": "number" }, "interpolated": { "description": "True when the value was filled from neighboring tenors.", "type": "boolean" }, "clampedToListedRange": { "description": "True when the implied median sat on the listed strike boundary; absent on older snapshots.", "type": "boolean" }, "estimated": { "description": "Backward-compatible flag: true whenever the point's quality is not quality-passed.", "type": "boolean" } }, "required": [ "kind", "tenorKey", "seriesTicker", "eventTicker", "sourceUrl", "latestMarketAt", "strikeCount", "twoSidedCount", "medianSpreadPoints", "totalVolume", "totalOpenInterest", "totalLiquidityUsd", "interpolated", "estimated" ] } } }, "required": [ "ingestionStatus", "monthlySeriesTicker", "spotSeriesTicker", "sourceUrl", "fetchedAt", "latestMarketAt", "monthlyEventCount", "usableTenorCount", "interpolatedTenorCount", "marketCount", "twoSidedMarketCount", "totalVolume", "totalOpenInterest", "totalLiquidityUsd", "estimatorVersion", "transformVersion", "points" ] }, "points": { "description": "Self-describing per-tenor records (same values as curve, with evidence).", "type": "array", "items": { "type": "object", "properties": { "tenor": { "description": "Display label of the tenor.", "type": "string" }, "priceUsdPerGpuHour": { "description": "Implied price level in USD per GPU-hour.", "type": "number" }, "instrument": { "description": "Instrument behind the point: the chip's anchor instrument at index 0, monthly-average after.", "type": "string", "enum": [ "weekly-exact-time", "monthly-average" ] }, "quality": { "description": "Ladder-quality classification; anything but quality-passed renders as an estimate.", "type": "string", "enum": [ "quality-passed", "thin", "interpolated" ] }, "evidence": { "description": "The point's ladder evidence record.", "type": "object", "properties": { "kind": { "description": "Serialized point kind; \"spot\" is the historical name for the first curve anchor.", "type": "string", "enum": [ "spot", "monthly" ] }, "tenorKey": { "description": "Stable YYYY-MM identity for monthly points; the instrument-specific anchor has no key.", "type": [ "string", "null" ] }, "seriesTicker": { "description": "Kalshi series ticker the ladder belongs to.", "type": "string" }, "eventTicker": { "description": "Exact Kalshi event ticker; null on legacy imports.", "type": [ "string", "null" ] }, "sourceUrl": { "description": "Kalshi API URL the ladder was fetched from.", "type": "string" }, "latestMarketAt": { "description": "Most recent exchange timestamp exposed by the event, when present.", "type": [ "string", "null" ] }, "strikeCount": { "description": "Number of strikes listed in the ladder.", "type": "integer" }, "twoSidedCount": { "description": "Strikes quoting both a bid and an ask.", "type": "integer" }, "medianSpreadPoints": { "description": "Median bid/ask spread across the ladder, in probability points.", "type": [ "number", "null" ] }, "totalVolume": { "description": "Summed contract volume.", "type": "number" }, "totalOpenInterest": { "description": "Summed open interest.", "type": "number" }, "totalLiquidityUsd": { "description": "Summed resting liquidity in USD.", "type": "number" }, "interpolated": { "description": "True when the value was filled from neighboring tenors.", "type": "boolean" }, "clampedToListedRange": { "description": "True when the implied median sat on the listed strike boundary; absent on older snapshots.", "type": "boolean" }, "estimated": { "description": "Backward-compatible flag: true whenever the point's quality is not quality-passed.", "type": "boolean" } }, "required": [ "kind", "tenorKey", "seriesTicker", "eventTicker", "sourceUrl", "latestMarketAt", "strikeCount", "twoSidedCount", "medianSpreadPoints", "totalVolume", "totalOpenInterest", "totalLiquidityUsd", "interpolated", "estimated" ] } }, "required": [ "tenor", "priceUsdPerGpuHour", "instrument", "quality", "evidence" ] } } }, "required": [ "id", "label", "memory", "priorSnapshotChangePct", "priorSnapshotAt", "priorSnapshotElapsedMinutes", "period", "periodChangePct", "curve", "provenance", "points" ] } } }, "required": [ "contractVersion", "license", "asOf", "unit", "note", "tenors", "estimatedFromIndex", "estimatorVersion", "transformVersion", "methodologyVersion", "anchors", "chips" ] } } } } } } }, "/curves.csv": { "get": { "operationId": "getCurvesCsv", "summary": "Forward curves (CSV)", "description": "Spreadsheet twin of /forward-curves.json: one row per tenor with unit-encoded per-chip columns, quality, and ladder evidence. UTF-8 BOM and formula-neutralized cells via the site-wide CSV policy. The first row is a `# as_of` stamp; the header row follows it.", "x-freshness-clock": { "clock": "market-snapshot", "label": "Market snapshot", "asOf": "2026-08-22T02:03:10.544Z" }, "responses": { "200": { "description": "Forward curves (CSV) payload", "content": { "text/csv": { "schema": { "type": "string" } } } } } } }, "/price-history.json": { "get": { "operationId": "getPriceHistoryJson", "summary": "GPU price history", "description": "The complete GPU price-history ledger: every series and dated observation, with billing, comparison, quality, and raw-evidence fields. Incomparable series (units, billing models, methodologies) are never joined; missing capture dates are real gaps.", "x-freshness-clock": { "clock": "live-quotes", "label": "Live quotes", "asOf": "2026-07-23T05:00:07.996Z" }, "responses": { "200": { "description": "GPU price history payload", "content": { "application/json": { "schema": { "type": "object", "properties": { "contractVersion": { "description": "Semver of the open-data contract this payload was published under; see the stability policy.", "type": "string" }, "license": { "description": "Open-data license the payload is published under.", "type": "object", "properties": { "name": { "description": "Human-readable license name.", "type": "string" }, "url": { "description": "Canonical license text URL.", "type": "string" }, "attribution": { "description": "The exact attribution line reusers should carry.", "type": "string" } }, "required": [ "name", "url", "attribution" ] }, "schemaVersion": { "description": "Artifact-level schema integer, bumped only when the ledger shape itself changes; versioned independently of contractVersion.", "type": "integer" }, "generatedAt": { "description": "ISO timestamp the artifact was exported.", "type": "string" }, "asOf": { "description": "Latest observation date in the ledger (YYYY-MM-DD).", "type": "string" }, "citableIdQualifier": { "description": "Mandatory qualifier for every citable series id: posted list/ask prices, not transactions.", "type": "string" }, "series": { "description": "Every price series in the ledger.", "type": "array", "items": { "type": "object", "properties": { "id": { "description": "Ledger-internal series key; points reference it via seriesId.", "type": "string" }, "gpu": { "description": "Quote-table GPU id.", "type": "string" }, "provider": { "description": "Provider name; null means a class aggregate, never an unnamed provider.", "type": [ "string", "null" ] }, "sku": { "description": "Exact provider SKU when retained; null when the source did not expose one.", "type": [ "string", "null" ] }, "providerClass": { "description": "Provider class the series belongs to.", "type": "string", "enum": [ "hyperscaler", "specialist", "marketplace" ] }, "billingModel": { "description": "Billing model retained per row; unlike models are never joined.", "type": "string", "enum": [ "on-demand", "capacity-block", "serverless", "marketplace-variable", "secondary-snapshot" ] }, "rateUnit": { "description": "USD per GPU-hour, or per chip-hour for TPUs/Trainium.", "type": "string", "enum": [ "GPU", "chip" ] }, "configuration": { "description": "Instance/configuration descriptor the price applies to.", "type": "string" }, "region": { "description": "Region the quote was published for.", "type": "string" }, "aggregation": { "description": "none on provider quotes; floor or median on class aggregates.", "type": "string", "enum": [ "none", "floor", "median" ] }, "scope": { "description": "Exact provider quote, or a provider-class aggregate.", "type": "string", "enum": [ "provider-quote", "class-aggregate" ] }, "comparableKey": { "description": "Series sharing a key share chip, unit, and billing semantics.", "type": "string" }, "citableId": { "description": "Named citable series id (ACT..@); present only on the three canonical class aggregates and always qualified: posted list/ask prices, not transactions.", "type": "string" } }, "required": [ "id", "gpu", "provider", "sku", "providerClass", "billingModel", "rateUnit", "configuration", "region", "aggregation", "scope", "comparableKey" ] } }, "points": { "description": "Every dated observation, keyed to its series.", "type": "array", "items": { "type": "object", "properties": { "seriesId": { "description": "Key of the owning series in the payload's series array.", "type": "string" }, "date": { "description": "Exact source/snapshot date, YYYY-MM-DD.", "type": "string" }, "period": { "description": "Quarter bucket (YYYYQn) used for display and gap detection.", "type": "string" }, "usdPerUnitHour": { "description": "Price in USD per rate-unit hour (see the series' rateUnit).", "type": "number" }, "evidenceStatus": { "description": "Observed from a source, or a labeled estimate.", "type": "string", "enum": [ "observed", "estimated" ] }, "evidenceKind": { "description": "Lineage of the value's source.", "type": "string", "enum": [ "provider-primary", "secondary-aggregator", "compiled-estimate", "published-snapshot" ] }, "sourceLabel": { "description": "Human-readable source name.", "type": "string" }, "sourceUrl": { "description": "HTTPS source URL when one exists.", "type": [ "string", "null" ] }, "observedAt": { "description": "Exact observation timestamp; required on observed rows.", "type": [ "string", "null" ] }, "estimateReason": { "description": "Present exactly when evidenceStatus is estimated.", "type": [ "string", "null" ] }, "qualityStatus": { "description": "verified additionally requires durable raw evidence (digest + ref).", "type": "string", "enum": [ "verified", "provisional", "secondary", "estimated" ] }, "methodologyVersion": { "description": "Exporter/aggregation contract version; null only on old imports.", "type": [ "string", "null" ] }, "rawEvidenceSha256": { "description": "SHA-256 digest of the retained raw payload, when archived.", "type": [ "string", "null" ] }, "rawEvidenceRef": { "description": "Durable reference pinning the raw evidence (raw-snapshots Git object or Neon observation set).", "type": [ "string", "null" ] } }, "required": [ "seriesId", "date", "period", "usdPerUnitHour", "evidenceStatus", "evidenceKind", "sourceLabel", "sourceUrl", "observedAt", "estimateReason", "qualityStatus", "methodologyVersion", "rawEvidenceSha256", "rawEvidenceRef" ] } } }, "required": [ "contractVersion", "license", "schemaVersion", "generatedAt", "asOf", "citableIdQualifier", "series", "points" ] } } } } } } }, "/price-history.csv": { "get": { "operationId": "getPriceHistoryCsv", "summary": "GPU price history (CSV)", "description": "Long-form spreadsheet twin of /price-history.json: one row per observation with its series context denormalized in. UTF-8 BOM and formula-neutralized cells via the site-wide CSV policy. Columns are append-only: citable_id and citable_id_qualifier were appended so existing positions stay stable.", "x-freshness-clock": { "clock": "live-quotes", "label": "Live quotes", "asOf": "2026-07-23T05:00:07.996Z" }, "responses": { "200": { "description": "GPU price history (CSV) payload", "content": { "text/csv": { "schema": { "type": "string" } } } } } } }, "/price-history/{chip}.json": { "get": { "operationId": "getPriceHistoryChipJson", "summary": "Per-chip price history", "description": "Per-accelerator shard of the price-history ledger — the same series and point shapes filtered to one chip. Shard series do not carry citableId; resolve citable ids from /price-history.json.", "x-freshness-clock": { "clock": "live-quotes", "label": "Live quotes", "asOf": "2026-07-23T05:00:07.996Z" }, "parameters": [ { "name": "chip", "in": "path", "required": true, "description": "Chip permalink slug (the same slug as /gpu-cloud//).", "schema": { "type": "string", "enum": [ "b300", "b200", "gb200-nvl72", "h200", "h100", "a100-80gb", "mi355x", "mi300x", "l40s", "rtx-5090", "rtx-4090", "v100", "tpu-v6e", "tpu-v5e", "tpu-v5p", "trainium2" ] } } ], "responses": { "200": { "description": "Per-chip price history payload", "content": { "application/json": { "schema": { "type": "object", "properties": { "contractVersion": { "description": "Semver of the open-data contract this payload was published under; see the stability policy.", "type": "string" }, "license": { "description": "Open-data license the payload is published under.", "type": "object", "properties": { "name": { "description": "Human-readable license name.", "type": "string" }, "url": { "description": "Canonical license text URL.", "type": "string" }, "attribution": { "description": "The exact attribution line reusers should carry.", "type": "string" } }, "required": [ "name", "url", "attribution" ] }, "generatedAt": { "description": "ISO timestamp the underlying artifact was exported.", "type": "string" }, "asOf": { "description": "Latest observation date for this chip (YYYY-MM-DD).", "type": "string" }, "gpu": { "description": "Quote-table GPU id the shard covers.", "type": "string" }, "series": { "description": "The chip's price series.", "type": "array", "items": { "type": "object", "properties": { "id": { "description": "Ledger-internal series key; points reference it via seriesId.", "type": "string" }, "gpu": { "description": "Quote-table GPU id.", "type": "string" }, "provider": { "description": "Provider name; null means a class aggregate, never an unnamed provider.", "type": [ "string", "null" ] }, "sku": { "description": "Exact provider SKU when retained; null when the source did not expose one.", "type": [ "string", "null" ] }, "providerClass": { "description": "Provider class the series belongs to.", "type": "string", "enum": [ "hyperscaler", "specialist", "marketplace" ] }, "billingModel": { "description": "Billing model retained per row; unlike models are never joined.", "type": "string", "enum": [ "on-demand", "capacity-block", "serverless", "marketplace-variable", "secondary-snapshot" ] }, "rateUnit": { "description": "USD per GPU-hour, or per chip-hour for TPUs/Trainium.", "type": "string", "enum": [ "GPU", "chip" ] }, "configuration": { "description": "Instance/configuration descriptor the price applies to.", "type": "string" }, "region": { "description": "Region the quote was published for.", "type": "string" }, "aggregation": { "description": "none on provider quotes; floor or median on class aggregates.", "type": "string", "enum": [ "none", "floor", "median" ] }, "scope": { "description": "Exact provider quote, or a provider-class aggregate.", "type": "string", "enum": [ "provider-quote", "class-aggregate" ] }, "comparableKey": { "description": "Series sharing a key share chip, unit, and billing semantics.", "type": "string" } }, "required": [ "id", "gpu", "provider", "sku", "providerClass", "billingModel", "rateUnit", "configuration", "region", "aggregation", "scope", "comparableKey" ] } }, "points": { "description": "The chip's dated observations.", "type": "array", "items": { "type": "object", "properties": { "seriesId": { "description": "Key of the owning series in the payload's series array.", "type": "string" }, "date": { "description": "Exact source/snapshot date, YYYY-MM-DD.", "type": "string" }, "period": { "description": "Quarter bucket (YYYYQn) used for display and gap detection.", "type": "string" }, "usdPerUnitHour": { "description": "Price in USD per rate-unit hour (see the series' rateUnit).", "type": "number" }, "evidenceStatus": { "description": "Observed from a source, or a labeled estimate.", "type": "string", "enum": [ "observed", "estimated" ] }, "evidenceKind": { "description": "Lineage of the value's source.", "type": "string", "enum": [ "provider-primary", "secondary-aggregator", "compiled-estimate", "published-snapshot" ] }, "sourceLabel": { "description": "Human-readable source name.", "type": "string" }, "sourceUrl": { "description": "HTTPS source URL when one exists.", "type": [ "string", "null" ] }, "observedAt": { "description": "Exact observation timestamp; required on observed rows.", "type": [ "string", "null" ] }, "estimateReason": { "description": "Present exactly when evidenceStatus is estimated.", "type": [ "string", "null" ] }, "qualityStatus": { "description": "verified additionally requires durable raw evidence (digest + ref).", "type": "string", "enum": [ "verified", "provisional", "secondary", "estimated" ] }, "methodologyVersion": { "description": "Exporter/aggregation contract version; null only on old imports.", "type": [ "string", "null" ] }, "rawEvidenceSha256": { "description": "SHA-256 digest of the retained raw payload, when archived.", "type": [ "string", "null" ] }, "rawEvidenceRef": { "description": "Durable reference pinning the raw evidence (raw-snapshots Git object or Neon observation set).", "type": [ "string", "null" ] } }, "required": [ "seriesId", "date", "period", "usdPerUnitHour", "evidenceStatus", "evidenceKind", "sourceLabel", "sourceUrl", "observedAt", "estimateReason", "qualityStatus", "methodologyVersion", "rawEvidenceSha256", "rawEvidenceRef" ] } } }, "required": [ "contractVersion", "license", "generatedAt", "asOf", "gpu", "series", "points" ] } } } } } } }, "/archive/curves/{date}.json": { "get": { "operationId": "getArchiveCurvesDateJson", "summary": "Archived forward-curve session", "description": "Immutable dated permalink for one archived forward-curve session: monthly values keyed to the archive's union tenor window, anchor identity, spots, and series-level ingestion evidence, exactly as archived. Immutable permalink: an archived session's values never change; new sessions land as new dated URLs. Values are reconstructed market-implied levels under the stated methodology, never current spot or executable quotes.", "x-freshness-clock": { "clock": "market-snapshot", "label": "Market snapshot", "asOf": "2026-08-22T02:03:10.544Z" }, "parameters": [ { "name": "date", "in": "path", "required": true, "description": "Archived UTC session date (YYYY-MM-DD); /archive/ lists every date.", "schema": { "type": "string", "enum": [ "2026-07-02", "2026-07-03", "2026-07-04", "2026-07-05", "2026-07-08", "2026-07-09", "2026-07-10", "2026-07-11", "2026-07-12", "2026-07-13", "2026-07-14", "2026-07-15", "2026-07-17", "2026-07-18", "2026-07-19", "2026-07-20", "2026-07-21", "2026-07-22", "2026-07-23", "2026-07-24", "2026-07-25", "2026-07-26", "2026-07-27", "2026-07-28", "2026-07-31", "2026-08-21", "2026-08-22" ] } } ], "responses": { "200": { "description": "Archived forward-curve session payload", "content": { "application/json": { "schema": { "type": "object", "properties": { "contractVersion": { "description": "Semver of the open-data contract this payload was published under; see the stability policy.", "type": "string" }, "license": { "description": "Open-data license the payload is published under.", "type": "object", "properties": { "name": { "description": "Human-readable license name.", "type": "string" }, "url": { "description": "Canonical license text URL.", "type": "string" }, "attribution": { "description": "The exact attribution line reusers should carry.", "type": "string" } }, "required": [ "name", "url", "attribution" ] }, "date": { "description": "Archived UTC session date (YYYY-MM-DD) — the permalink identity.", "type": "string" }, "capturedAt": { "description": "Exact fetch time; null when the legacy source retained only a session date.", "type": [ "string", "null" ] }, "methodologyVersion": { "description": "Exact methodology key the session was captured under; historical comparisons require an exact match.", "type": "string" }, "estimatorVersion": { "description": "Ladder-to-implied-median estimator version of the archive.", "type": "string" }, "transformVersion": { "description": "Smoothing-transform version of the archive.", "type": "string" }, "unit": { "description": "Price unit shared by every archived curve value (USD per GPU-hour).", "type": "string" }, "tenorKeys": { "description": "The archive's union monthly window: stable YYYY-MM identities every values array aligns to index-for-index.", "type": "array", "items": { "type": "string" } }, "curves": { "description": "One entry per archived curve, values exactly as archived.", "type": "array", "items": { "type": "object", "properties": { "id": { "description": "Curve id (matches /forward-curves.json chip ids).", "type": "string" }, "anchor": { "description": "First-point instrument identity the session was captured with.", "type": "object", "properties": { "instrument": { "description": "Anchor instrument: a future exact-time weekly contract, or the front-month monthly average (RTX 5090).", "type": "string", "enum": [ "weekly-exact-time", "monthly-average" ] }, "seriesTicker": { "description": "Kalshi series ticker backing the anchor.", "type": "string" }, "eventTicker": { "description": "Exact Kalshi event ticker; null on legacy imports.", "type": [ "string", "null" ] }, "methodologyVersion": { "description": "Methodology key the anchor was published under.", "type": "string" } }, "required": [ "instrument", "seriesTicker", "eventTicker", "methodologyVersion" ] }, "spot": { "description": "The session's archived first-point (anchor) value in USD per GPU-hour.", "type": "number" }, "values": { "description": "Monthly values aligned to tenorKeys; null marks a tenor the session never observed — an explicit gap, never an interpolation.", "type": "array", "items": { "type": "number" } }, "series": { "description": "Series-level ingestion evidence retained by live refreshes; null on legacy imports.", "type": "object", "properties": { "ingestionStatus": { "description": "Live pipeline fetch, or a legacy import.", "type": "string", "enum": [ "live-fetch", "legacy-import" ] }, "monthlySeriesTicker": { "description": "Kalshi monthly-average series ticker.", "type": "string" }, "spotSeriesTicker": { "description": "Weekly exact-time series ticker; null when the chip has none.", "type": [ "string", "null" ] }, "sourceUrl": { "description": "Kalshi API URL for the series.", "type": "string" }, "fetchedAt": { "description": "ISO timestamp of the fetch.", "type": "string" }, "latestMarketAt": { "description": "Most recent exchange timestamp seen across the series.", "type": [ "string", "null" ] }, "monthlyEventCount": { "description": "Monthly events discovered.", "type": "integer" }, "usableTenorCount": { "description": "Tenors with a usable ladder.", "type": "integer" }, "interpolatedTenorCount": { "description": "Tenors filled by interpolation.", "type": "integer" }, "marketCount": { "description": "Markets inspected.", "type": "integer" }, "twoSidedMarketCount": { "description": "Markets quoting both sides.", "type": "integer" }, "totalVolume": { "description": "Summed contract volume.", "type": "number" }, "totalOpenInterest": { "description": "Summed open interest.", "type": "number" }, "totalLiquidityUsd": { "description": "Summed resting liquidity in USD.", "type": "number" }, "estimatorVersion": { "description": "Estimator version the series was built with.", "type": "string" }, "transformVersion": { "description": "Transform version the series was built with.", "type": "string" }, "points": { "description": "Per-point ladder evidence aligned with tenors.", "type": "array", "items": { "type": "object", "properties": { "kind": { "description": "Serialized point kind; \"spot\" is the historical name for the first curve anchor.", "type": "string", "enum": [ "spot", "monthly" ] }, "tenorKey": { "description": "Stable YYYY-MM identity for monthly points; the instrument-specific anchor has no key.", "type": [ "string", "null" ] }, "seriesTicker": { "description": "Kalshi series ticker the ladder belongs to.", "type": "string" }, "eventTicker": { "description": "Exact Kalshi event ticker; null on legacy imports.", "type": [ "string", "null" ] }, "sourceUrl": { "description": "Kalshi API URL the ladder was fetched from.", "type": "string" }, "latestMarketAt": { "description": "Most recent exchange timestamp exposed by the event, when present.", "type": [ "string", "null" ] }, "strikeCount": { "description": "Number of strikes listed in the ladder.", "type": "integer" }, "twoSidedCount": { "description": "Strikes quoting both a bid and an ask.", "type": "integer" }, "medianSpreadPoints": { "description": "Median bid/ask spread across the ladder, in probability points.", "type": [ "number", "null" ] }, "totalVolume": { "description": "Summed contract volume.", "type": "number" }, "totalOpenInterest": { "description": "Summed open interest.", "type": "number" }, "totalLiquidityUsd": { "description": "Summed resting liquidity in USD.", "type": "number" }, "interpolated": { "description": "True when the value was filled from neighboring tenors.", "type": "boolean" }, "clampedToListedRange": { "description": "True when the implied median sat on the listed strike boundary; absent on older snapshots.", "type": "boolean" }, "estimated": { "description": "Backward-compatible flag: true whenever the point's quality is not quality-passed.", "type": "boolean" } }, "required": [ "kind", "tenorKey", "seriesTicker", "eventTicker", "sourceUrl", "latestMarketAt", "strikeCount", "twoSidedCount", "medianSpreadPoints", "totalVolume", "totalOpenInterest", "totalLiquidityUsd", "interpolated", "estimated" ] } } }, "required": [ "ingestionStatus", "monthlySeriesTicker", "spotSeriesTicker", "sourceUrl", "fetchedAt", "latestMarketAt", "monthlyEventCount", "usableTenorCount", "interpolatedTenorCount", "marketCount", "twoSidedMarketCount", "totalVolume", "totalOpenInterest", "totalLiquidityUsd", "estimatorVersion", "transformVersion", "points" ] } }, "required": [ "id", "anchor", "spot", "values", "series" ] } } }, "required": [ "contractVersion", "license", "date", "capturedAt", "methodologyVersion", "estimatorVersion", "transformVersion", "unit", "tenorKeys", "curves" ] } } } } } } }, "/archive/quotes/{date}.json": { "get": { "operationId": "getArchiveQuotesDateJson", "summary": "Archived quote aggregates", "description": "Immutable dated permalink for one day of quote-table class aggregates: primary on-demand hyperscaler floor and specialist median plus the separately labeled marketplace-access floor, per GPU, exactly as archived. Immutable permalink: an archived day's aggregates never change; new days land as new dated URLs. A null is a real gap — aggregates are never carried forward between observation dates.", "x-freshness-clock": { "clock": "live-quotes", "label": "Live quotes", "asOf": "2026-07-23T05:00:07.996Z" }, "parameters": [ { "name": "date", "in": "path", "required": true, "description": "Archived UTC capture date (YYYY-MM-DD); /archive/ lists every date.", "schema": { "type": "string", "enum": [ "2026-07-23" ] } } ], "responses": { "200": { "description": "Archived quote aggregates payload", "content": { "application/json": { "schema": { "type": "object", "properties": { "contractVersion": { "description": "Semver of the open-data contract this payload was published under; see the stability policy.", "type": "string" }, "license": { "description": "Open-data license the payload is published under.", "type": "object", "properties": { "name": { "description": "Human-readable license name.", "type": "string" }, "url": { "description": "Canonical license text URL.", "type": "string" }, "attribution": { "description": "The exact attribution line reusers should carry.", "type": "string" } }, "required": [ "name", "url", "attribution" ] }, "date": { "description": "Archived UTC capture date (YYYY-MM-DD) — the permalink identity.", "type": "string" }, "capturedAt": { "description": "Exact capture timestamp of the day's aggregates.", "type": "string" }, "comparisonPolicies": { "description": "Versioned comparison policies the aggregates were computed under.", "type": "object", "properties": { "primaryOnDemand": { "description": "Policy version behind the hyperscaler floor and specialist median.", "type": "string" }, "marketplaceAccess": { "description": "Policy version behind the marketplace-access floor.", "type": "string" } }, "required": [ "primaryOnDemand", "marketplaceAccess" ] }, "aggregates": { "description": "Human-readable aggregate semantics persisted by the archive.", "type": "string" }, "unit": { "description": "USD per GPU-hour; per chip-hour for TPUs and Trainium.", "type": "string" }, "gpus": { "description": "Class aggregates keyed by quote-table GPU id.", "type": "object", "additionalProperties": { "type": "object", "properties": { "hyperscaler": { "description": "Primary on-demand hyperscaler floor; null when no eligible quote existed that day.", "type": [ "number", "null" ] }, "specialist": { "description": "Primary on-demand specialist median; null when no eligible quote existed that day.", "type": [ "number", "null" ] }, "marketplace": { "description": "Separately labeled marketplace-access floor; null when no eligible quote existed that day.", "type": [ "number", "null" ] } }, "required": [ "hyperscaler", "specialist", "marketplace" ] } } }, "required": [ "contractVersion", "license", "date", "capturedAt", "comparisonPolicies", "aggregates", "unit", "gpus" ] } } } } } } }, "/marketplace-tape.json": { "get": { "operationId": "getMarketplaceTapeJson", "summary": "Marketplace ask tape", "description": "Hourly intraday marketplace ask tape: per-chip Vast.ai ask floor and ask median over verified on-demand offers, rolled into a bounded archive of daily point lists. Ask floor and median describe listed offers, not clearing prices. Absent chips and missed hours are explicit gaps — never interpolated or carried forward.", "x-freshness-clock": { "clock": "live-quotes", "label": "Live quotes", "asOf": "2026-07-23T05:00:07.996Z" }, "responses": { "200": { "description": "Marketplace ask tape payload", "content": { "application/json": { "schema": { "type": "object", "properties": { "contractVersion": { "description": "Semver of the open-data contract this payload was published under; see the stability policy.", "type": "string" }, "license": { "description": "Open-data license the payload is published under.", "type": "object", "properties": { "name": { "description": "Human-readable license name.", "type": "string" }, "url": { "description": "Canonical license text URL.", "type": "string" }, "attribution": { "description": "The exact attribution line reusers should carry.", "type": "string" } }, "required": [ "name", "url", "attribution" ] }, "schemaVersion": { "description": "Artifact-level schema integer of the tape archive, versioned independently of contractVersion.", "type": "integer" }, "unit": { "description": "Price unit shared by every tape value (USD per GPU-hour).", "type": "string" }, "note": { "description": "Payload-level honesty caveat: these are listed asks, not clearing prices, and absent chips are explicit gaps.", "type": "string" }, "cadence": { "description": "Intended capture cadence; scheduled runs can drift or skip, so missed hours are real gaps.", "type": "string" }, "retainedDays": { "description": "Daily roll depth: the archive keeps the newest N days of points.", "type": "integer" }, "collectedThrough": { "description": "ISO timestamp of the newest capture; null while the tape has no points yet.", "type": [ "string", "null" ] }, "days": { "description": "One entry per retained UTC day, oldest first.", "type": "array", "items": { "type": "object", "properties": { "date": { "description": "UTC date (YYYY-MM-DD) every point in the day belongs to.", "type": "string" }, "points": { "description": "The day's captures in chronological order, appended and never edited.", "type": "array", "items": { "type": "object", "properties": { "capturedAt": { "description": "Exact ISO capture timestamp — the point's identity.", "type": "string" }, "chips": { "description": "Per-chip observations keyed by quote-table GPU id; a chip that failed its capture or offer-count guard is absent for the hour.", "type": "object", "additionalProperties": { "type": "object", "properties": { "askFloorUsdHr": { "description": "Cheapest verified on-demand ask, USD per GPU-hour.", "type": "number" }, "askMedianUsdHr": { "description": "Median verified on-demand ask, USD per GPU-hour.", "type": "number" }, "usableOffers": { "description": "Verified rentable offers behind the observation (always at or above the shared minimum-offers guard).", "type": "integer" } }, "required": [ "askFloorUsdHr", "askMedianUsdHr", "usableOffers" ] } } }, "required": [ "capturedAt", "chips" ] } } }, "required": [ "date", "points" ] } } }, "required": [ "contractVersion", "license", "schemaVersion", "unit", "note", "cadence", "retainedDays", "collectedThrough", "days" ] } } } } } } }, "/buildout.json": { "get": { "operationId": "getBuildoutJson", "summary": "Frontier buildout ledger", "description": "Provenanced ledger of frontier-scale AI datacenter sites: operator, location, accelerators, current and planned capacity, status, key dates — every figure traceable to a dated public source via per-site claims. Best public estimates, not an audited census: capacity figures mix IT-load and campus-power conventions per underlying source — each claim names its basis. A null capacity is a real gap (no public figure), never zero.", "x-freshness-clock": { "clock": "core-data", "label": "Core data", "asOf": "2026-07-23" }, "responses": { "200": { "description": "Frontier buildout ledger payload", "content": { "application/json": { "schema": { "type": "object", "properties": { "contractVersion": { "description": "Semver of the open-data contract this payload was published under; see the stability policy.", "type": "string" }, "license": { "description": "Open-data license the payload is published under.", "type": "object", "properties": { "name": { "description": "Human-readable license name.", "type": "string" }, "url": { "description": "Canonical license text URL.", "type": "string" }, "attribution": { "description": "The exact attribution line reusers should carry.", "type": "string" } }, "required": [ "name", "url", "attribution" ] }, "asOf": { "description": "Survey date of the ledger (YYYY-MM-DD) — the dataset's own inline stamp.", "type": "string" }, "unit": { "description": "Capacity unit for currentItMw/plannedItMw (megawatts).", "type": "string" }, "note": { "description": "Payload-level honesty caveat: best public estimates mixing IT-load and campus-power conventions per source; nulls are real gaps.", "type": "string" }, "summary": { "description": "Derived ledger totals (never hand-typed).", "type": "object", "properties": { "sites": { "description": "Tracked sites.", "type": "integer" }, "operating": { "description": "Sites with operating status.", "type": "integer" }, "plannedGw": { "description": "Rounded sum of each site's planned (or current, if larger) capacity, GW.", "type": "integer" } }, "required": [ "sites", "operating", "plannedGw" ] }, "sites": { "description": "One entry per tracked frontier-scale site.", "type": "array", "items": { "type": "object", "properties": { "id": { "description": "Stable site slug.", "type": "string" }, "operator": { "description": "Operator(s) of the site.", "type": "string" }, "site": { "description": "Campus / site name.", "type": "string" }, "location": { "description": "Structured site location.", "type": "object", "properties": { "city": { "description": "City, when public.", "type": "string" }, "region": { "description": "US state name, or region descriptor for non-US / multi-site rows.", "type": "string" }, "country": { "description": "Country (US, UAE, ...).", "type": "string" } }, "required": [ "region", "country" ] }, "accelerators": { "description": "Accelerator types and counts where published (claim-backed free text).", "type": "string" }, "currentItMw": { "description": "Energized capacity in MW; null until energized or where no public figure exists.", "type": [ "number", "null" ] }, "plannedItMw": { "description": "Planned end-state capacity in MW (estimate); null when no figure is public.", "type": [ "number", "null" ] }, "status": { "description": "Site status; building = under construction.", "type": "string", "enum": [ "operating", "building", "announced" ] }, "keyDates": { "description": "Key public dates (YYYY-MM or YYYY-MM-DD), claim-backed.", "type": "object", "properties": { "announced": { "description": "Announcement date.", "type": "string" }, "firstPower": { "description": "First energization date.", "type": "string" } }, "required": [] }, "multiSite": { "description": "True for capacity programs contracted across unnamed sites.", "type": "boolean" }, "note": { "description": "Site context note.", "type": [ "string", "null" ] }, "claims": { "description": "Dated public sources — every figure above traces to at least one claim.", "type": "array", "items": { "type": "object", "properties": { "field": { "description": "Which figure the claim evidences.", "type": "string", "enum": [ "currentItMw", "plannedItMw", "accelerators", "status", "announced", "firstPower" ] }, "value": { "description": "The claimed value, human-readable.", "type": "string" }, "sourceLabel": { "description": "Publisher of the source.", "type": "string" }, "sourceUrl": { "description": "HTTPS source URL.", "type": "string" }, "sourceDate": { "description": "Source publication date (YYYY-MM-DD, or YYYY-MM when the page carries no exact day).", "type": "string" }, "est": { "description": "True unless the figure comes from the operator's own announcement.", "type": "boolean" } }, "required": [ "field", "value", "sourceLabel", "sourceUrl", "sourceDate", "est" ] } } }, "required": [ "id", "operator", "site", "location", "accelerators", "currentItMw", "plannedItMw", "status", "keyDates", "multiSite", "note", "claims" ] } } }, "required": [ "contractVersion", "license", "asOf", "unit", "note", "summary", "sites" ] } } } } } } }, "/feed.xml": { "get": { "operationId": "getFeedXml", "summary": "Market tape (RSS)", "description": "RSS 2.0 market tape: a data-written desk note for the current forward snapshot, the latest desk-log events derived from the immutable archives (quote moves, anchor moves, tenor rolls, methodology and venue milestones), plus recent archived sessions.", "x-freshness-clock": { "clock": "market-snapshot", "label": "Market snapshot", "asOf": "2026-08-22T02:03:10.544Z" }, "responses": { "200": { "description": "Market tape (RSS) payload", "content": { "application/rss+xml": { "schema": { "type": "string" } } } } } } }, "/llms.txt": { "get": { "operationId": "getLlmsTxt", "summary": "llms.txt", "description": "Curated plain-text site map with dataset conventions for agents and LLM crawlers (llmstxt.org).", "x-freshness-clock": { "clock": "core-data", "label": "Core data", "asOf": "2026-07-23" }, "responses": { "200": { "description": "llms.txt payload", "content": { "text/plain": { "schema": { "type": "string" } } } } } } }, "/llms-full.txt": { "get": { "operationId": "getLlmsFullTxt", "summary": "llms-full.txt", "description": "Full plain-text dataset for answer engines: current GPU quotes, the forward board, token prices, accelerator specs, and citable class aggregates inlined as tables, each section stamped by its owning clock (market snapshot, live quotes, or core data).", "x-freshness-clock": { "clock": "core-data", "label": "Core data", "asOf": "2026-07-23" }, "responses": { "200": { "description": "llms-full.txt payload", "content": { "text/plain": { "schema": { "type": "string" } } } } } } } } }