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

# Get GPU price changes

`GET /v1/gpu-prices/changes`

## Request

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

Returns the change log for one GPU model: every price move, new
listing and withdrawal revealed by a completed price scrape started on
or after `since`, newest first. Each vendor's offers are compared
with that vendor's previous successful scrape, so a vendor a scrape
could not reach is never reported as having withdrawn its offers.
`observed_at` is the start of the scrape that revealed the change.

`previous_usd_per_gpu_hour` is null for `listed`, and
`usd_per_gpu_hour` is null for `delisted`. `since` may be at most 91
days before the current UTC date (`400` otherwise).

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

## Query parameters

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

## Response `200`

Price changes, newest first.

- GPUPriceChangesResponse
  - `gpu_model` 'a100' | 'h100' | 'h200' | 'b200' | 'b300', required
  - `since` string, date, required
  - `changes` GPUPriceChange[], 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
    - `observed_at` string, date-time, required: Start of the scrape that revealed the change.
    - `change` 'price_changed' | 'listed' | 'delisted', required
    - `previous_usd_per_gpu_hour` number, nullable, required: Price before the change; null for `listed`.
    - `usd_per_gpu_hour` number, nullable, required: Price after the change; null for `delisted`.

## 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)