# Docs

- Documentation: Concepts, guides and conventions

  - **Get started**
  - [Introduction](/): Real-time market data for GPU compute, over one REST API.
  - [Quickstart](/quickstart): From API key to your first GPU prices in two minutes.
  - [Authentication](/authentication): Every request carries an API key as a Bearer token.

  - **Using the API**
  - [Versioning](/versioning): Dated versions keep your integration stable while the API grows.
  - [Responses](/responses): One envelope for every success, one shape for every error.
  - [Errors](/errors): Every error code the Data API returns, and what to do about it.
  - [Pagination](/pagination): Every list pages by cursor.
  - [Rate limits](/rate-limits): Per-key and per-account budgets, and the headers that report them.
  - [Caching](/caching): ETags and conditional requests.

  - **Data**
  - [IDs](/ids): Stable identifiers for GPUs, providers and indices.
  - [Data rules](/data-rules): How prices, numbers, timestamps and missing values are represented.
  - [Point in time](/point-in-time): Ask what the market looked like at any past moment.
  - [Bulk exports](/bulk-exports): One completed UTC day of a dataset as one gzipped JSON-lines file.

  - **Guides**
  - [Track GPU prices](/guides/track-gpu-prices): Current price, 24-hour change, history and the cheapest offer for a GPU.
  - [Estimate a job's full cost](/guides/estimate-job-cost): Compute, egress and storage per provider, with unknown components named.
  - [Use and verify fixings](/guides/verify-fixings): Official reference prices you can recompute and check.

  - **More**
  - [For AI agents](/for-agents): Machine-readable docs for coding assistants and agents.
  - [Changelog](/changelog): Every change to the Data API, newest first.
  - [Terms and support](/terms): Licence, service commitments and how to reach us.
- API reference: Every Data API endpoint, with a playground
  - [API reference](/api-reference): Every Data API endpoint, generated from the API's own code.

  - **Endpoints**
  - Reference
    - [List GPU families](/api-reference/reference/list-gpu-families): GPU families and their canonical variants.
    - [Get a GPU family](/api-reference/reference/get-a-gpu-family): One GPU family: every variant side by side.
    - [List GPUs](/api-reference/reference/list-gpus): Every canonical GPU: reference data and vendor specs.
    - [Get a GPU](/api-reference/reference/get-a-gpu): One GPU: reference data and vendor specs.
    - [List providers](/api-reference/reference/list-providers): Every provider: meta, coverage, relative value, feed health.
    - [Get a provider](/api-reference/reference/get-a-provider): One provider: catalog, pricing vs market, rank history, health.
    - [Provider price in context](/api-reference/reference/provider-price-in-context): One provider's price for a GPU against its own recorded history.
    - [Listing price in context](/api-reference/reference/listing-price-in-context): One listing's price against its own recorded history (90 days).
    - [List region groups](/api-reference/reference/list-region-groups): Region groups and what is listed in each now.
  - Markets
    - [List markets](/api-reference/markets/list-markets): Current market per GPU: price, spread, efficiency score.
    - [Get a market](/api-reference/markets/get-a-market): One GPU's market: price, stats, providers, capability, alternatives.
    - [Market history](/api-reference/markets/market-history): One GPU over time: low / median / high / provider count + index.
    - [Archived price history](/api-reference/markets/archived-price-history): One GPU's ARCHIVED price history: public archive captures of provider price pages.
    - [Daily market history](/api-reference/markets/daily-market-history): One GPU, daily, as far back as archives reach: archived before recording, observed after.
    - [Price dispersion history](/api-reference/markets/price-dispersion-history): Dispersion of one GPU over time.
    - [Price history by provider](/api-reference/markets/price-history-by-provider): Each provider's price over time for one GPU, with the market low / median / high.
    - [Market by region](/api-reference/markets/market-by-region): One GPU by region group: cheapest, median, providers, premium.
  - Listings
    - [List listings](/api-reference/listings/list-listings): Current price listings: every offer, cheapest first, with provenance.
    - [Listing changes](/api-reference/listings/listing-changes): Recorded listing changes (price, availability, capacity), newest first.
  - Reserved
    - [List reserved prices](/api-reference/reserved/list-reserved-prices): Reserved and committed GPU prices, with the on-demand saving.
    - [Reserved price summary](/api-reference/reserved/reserved-price-summary): Per GPU: the cheapest reserved price in each term.
  - Indices
    - [List indices](/api-reference/indices/list-indices): OpenGrid indices: current level and changes.
    - [Get an index](/api-reference/indices/get-an-index): One index: definition, level, constituents, statistics.
    - [Index fixings](/api-reference/indices/index-fixings): Official fixing history of one index.
    - [Index history](/api-reference/indices/index-history): Stored index levels over a window.
  - Fixings
    - [List latest fixings](/api-reference/fixings/list-latest-fixings): Latest official fixings of every settlement index.
    - [Verify the fixing chain](/api-reference/fixings/verify-the-fixing-chain): Check the hash chain over the whole fixings ledger (paged).
    - [Fixing methodology](/api-reference/fixings/fixing-methodology): Fixing schedule, thresholds, correction windows, change notices.
    - [List restatements](/api-reference/fixings/list-restatements): Every restatement: what was corrected, by whom, why.
    - [Get a fixing](/api-reference/fixings/get-a-fixing): One fixing: value, flags, full inputs and raw evidence.
    - [Verify a fixing](/api-reference/fixings/verify-a-fixing): Recompute a fixing from its stored inputs; check hashes and links.
  - Capacity
    - [List capacity](/api-reference/capacity/list-capacity): Provider-reported capacity, by SKU and region.
    - [Capacity changes](/api-reference/capacity/capacity-changes): Capacity state changes, newest first.
  - Costs
    - [Billing increments](/api-reference/costs/billing-increments): Billing increment and minimum per provider.
    - [Cost components](/api-reference/costs/cost-components): Egress, storage and other cost components per provider.
    - [Estimate a job's cost](/api-reference/costs/estimate-a-job-s-cost): Full cost of a job per provider: compute + egress + storage, unknown components named.
    - [Reference jobs](/api-reference/costs/reference-jobs): The published reference jobs.
    - [Cost sources](/api-reference/costs/cost-sources): Machine-readable cost sources and their last fetch.
  - FX
    - [Current FX rates](/api-reference/fx/current-fx-rates): Reference rates in force now: EUR->USD and every X->USD cross.
    - [FX rate history](/api-reference/fx/fx-rate-history): Stored ECB EUR->X reference rates (default USD), newest first.
  - Reliability
    - [Probe vantage points](/api-reference/reliability/probe-vantage-points): Vantage points that have reported.
    - [Provider incidents](/api-reference/reliability/provider-incidents): Incidents providers reported on their own status pages.
    - [Raw probe results](/api-reference/reliability/raw-probe-results): Raw probe results of one target, newest first.
    - [Provider reliability](/api-reference/reliability/provider-reliability): Per provider: probe status, availability, latency; data freshness; feed health.
    - [One provider's reliability](/api-reference/reliability/one-provider-s-reliability): One provider: probes with each target's series, data freshness, feed health.
    - [Reliability dips](/api-reference/reliability/reliability-dips): Hours with a failed check, with measured scope and reason.
    - [Probe targets](/api-reference/reliability/probe-targets): What OpenGrid probes.
  - Events
    - [List events](/api-reference/events/list-events): Market events, newest first.
    - [List shifts](/api-reference/events/list-shifts): Major market shifts with related items (not necessarily causal).
    - [Shift definition](/api-reference/events/shift-definition): How a major shift is defined and its items ranked.
    - [Get a shift](/api-reference/events/get-a-shift): One shift with every related item (not necessarily causal).
    - [Event types](/api-reference/events/event-types): Event catalogue: triggers, severity rules, data kind.
  - News
    - [List news](/api-reference/news/list-news): GPU market news clustered into stories, newest activity first. Filter by GPU, provider, region, topic, source or free text (`q`).
    - [News GPU families](/api-reference/news/news-gpu-families): Every GPU family the news classifier recognises; `tracked: false` means OpenGrid has no prices for it.
    - [News sources](/api-reference/news/news-sources): Every news source OpenGrid reads, with its health.
    - [News topics](/api-reference/news/news-topics): The topic catalogue, with how many items each had in the last 30 days.
    - [Get a news story](/api-reference/news/get-a-news-story): One news item with its classification (topics, GPUs, providers it concerns).
    - [Timeline](/api-reference/news/timeline): Price moves, events and news for a GPU and/or provider over a window, on one timeline. Give `gpu`, `provider` or both.
    - [Timeline around a moment](/api-reference/news/timeline-around-a-moment): What happened around one moment (`at`) for a GPU: the price move, events and news within `window_hours`. Shown together, not claimed as cause and effect.
  - Macro
    - [Listings beside power prices](/api-reference/macro/listings-beside-power-prices): US listings by state, beside the state's electricity price.
    - [List macro series](/api-reference/macro/list-macro-series): Market-context series: the catalogue.
    - [Get a macro series](/api-reference/macro/get-a-macro-series): One market-context series: source, unit, latest.
    - [Macro series history](/api-reference/macro/macro-series-history): One market-context series over time.
  - Methodology
    - [List methodology documents](/api-reference/methodology/list-methodology-documents): Methodology documents: name, title, links.
    - [Get a methodology document](/api-reference/methodology/get-a-methodology-document): One methodology document as raw markdown.
  - Bulk exports
    - [List export datasets](/api-reference/bulk-exports/list-export-datasets): Bulk export datasets and the first day each has data.
    - [Download a day's export](/api-reference/bulk-exports/download-a-day-s-export): One completed UTC day of a dataset (gzipped JSON lines).