---
title: "Get GPU price history"
method: GET
path: "/v1/gpu-prices/history"
tags: ["GPU Market Prices"]
---

# Get GPU price history

`GET /v1/gpu-prices/history`

## Request

- Base URL: `https://api.liquidcompute.co`
- URL: `https://api.liquidcompute.co/v1/gpu-prices/history`
- Auth: API key in header `X-API-Key`

Returns each vendor offer's daily price for one GPU model over an
inclusive UTC date window, as step series built from every completed
price scrape. A day's point is the offer's last price observed that
day. Days with no change are still emitted, so a series can be drawn
as steps: a day on which no scrape read the vendor carries its last
price forward. A day is omitted while the offer is not listed (before
the vendor first listed it, or after a scrape found it withdrawn), and
days after the current UTC date are never emitted.

An offer is identified by its vendor-published fields, the same
vocabulary as `/v1/gpu-prices/current`; no two offers in one response
share all of them. The window spans at most 92 days (`400`
otherwise), and an empty window is an empty `offers` array.

Requires the `gpu-prices` entitlement family; requests without it
return `404` `not_found`.

## Query parameters

- `gpu_model` 'a100' | 'h100' | 'h200' | 'b200' | 'b300', required
- `start` string, date, required
- `end` string, date, required

## Response `200`

Daily step series per offer.

- GPUPriceHistoryResponse
  - `gpu_model` 'a100' | 'h100' | 'h200' | 'b200' | 'b300', required
  - `start` string, date, required
  - `end` string, date, required
  - `offers` GPUPriceHistoryOffer[], required
    - `provider` string, required
    - `provider_name` string, required: The vendor's display name.
    - `price_kind` 'on_demand' | 'reserved' | 'spot', required
    - `commitment_term` string, nullable, required
    - `region` string, nullable, required
    - `supply_model` 'direct' | 'marketplace' | 'aggregator', required
    - `provider_sku` string, required
    - `vram_gb` integer, nullable, required
    - `accelerator_count` integer, nullable, required
    - `minimum_quantity` integer, nullable, required
    - `configuration` string, nullable, required
    - `points` GPUPriceHistoryPoint[], required: One point per listed day, in date order.
      - `date` string, date, required
      - `usd_per_gpu_hour` number, required

## Other responses

- `400`: Invalid or unsupported query parameter.
- `401`: Missing or invalid API key.
- `404`: Unknown endpoint, unavailable resource, or an index or index family outside your authorization.
- `429`: Rate limit exceeded.
- `502`: Upstream service or gateway configuration failure.
- `503`: API-key validation is temporarily unavailable.

---

[API](https://skmtc.dev/liquidcompute/apis/liquidcompute-api.md) - [All operations](https://skmtc.dev/liquidcompute/apis/liquidcompute-api/llms.txt) - [OpenAPI document](https://skmtc.dev/liquidcompute/apis/liquidcompute-api/revisions/f58bc0aabb07?raw)