API referenceGet price history

GET

Get price history

GEThttps://api.gpus.io/v1/gpus/{key}/price-history

Returns a historical price series for a single GPU type — the global median over time, a per-provider summary, and the cheapest provider at each point. History is per-GPU only; there is no global history dump.

Request

curl -G https://api.gpus.io/v1/gpus/h100-sxm/price-history \
  -H "Authorization: Bearer $GPUS_API_KEY" \
  --data-urlencode range=6M

Parameters

Path parameters

keystringRequired

GPU type key (an alias is also accepted and resolved to the canonical key), e.g. h100-sxm.

Query parameters

rangeenumOptionaldefault: 6M

Look-back window for the series.

1M3M6M12MALL

providerstringOptional

Narrow the series to a single provider id from List providers.

rentalTypeenumOptionaldefault: on_demand

Pricing model the series describes.

on_demandspotreserved

Response

A successful call returns 200 OK with this shape:

Example response

{
  "gpu": {
    "key": "h100-sxm"
  },
  "range": "6M",
  "rentalType": "on_demand",
  "granularity": "weekly",
  "provider": null,
  "providerSummaries": [
    {
      "providerId": "lambda",
      "providerName": "Lambda",
      "latestMedianPriceUsd": 1.99,
      "startPriceUsd": 2.49
    },
    {
      "providerId": "runpod",
      "providerName": "RunPod",
      "latestMedianPriceUsd": 2.29,
      "startPriceUsd": 2.79
    }
  ],
  "globalMedian": [
    {
      "date": "2026-01-05",
      "medianPriceUsd": 2.65
    },
    {
      "date": "2026-03-02",
      "medianPriceUsd": 2.35
    },
    {
      "date": "2026-06-01",
      "medianPriceUsd": 2.1
    }
  ],
  "cheapest": [
    {
      "date": "2026-01-05",
      "priceUsd": 2.19,
      "providerId": "vastai",
      "providerName": "Vast.ai"
    },
    {
      "date": "2026-03-02",
      "priceUsd": 1.89,
      "providerId": "vastai",
      "providerName": "Vast.ai"
    },
    {
      "date": "2026-06-01",
      "priceUsd": 1.79,
      "providerId": "vastai",
      "providerName": "Vast.ai"
    }
  ]
}

Response fields

gpu.keystring

Canonical GPU type key the series describes.

rangestring

Echo of the requested range (1M, 3M, 6M, 12M, ALL).

rentalTypestring

Pricing model the series describes.

granularityenum

Bucket size of the series: daily, weekly, or monthly (chosen from the range).

providerstring | null

Applied provider filter, or null when across all providers.

providerSummariesarray

Per-provider start/latest median, one entry per provider.

providerSummaries[].providerIdstring

Provider id.

providerSummaries[].providerNamestring

Provider display name.

providerSummaries[].latestMedianPriceUsdnumber

Most recent median price for this provider, in USD.

providerSummaries[].startPriceUsdnumber

Median price at the start of the window, in USD.

globalMedianarray

Median price across all providers at each bucket (oldest → newest).

globalMedian[].datestring

Bucket date (YYYY-MM-DD).

globalMedian[].medianPriceUsdnumber

Median price across providers in the bucket, in USD.

cheapestarray

Cheapest provider and price at each bucket.

cheapest[].datestring

Bucket date (YYYY-MM-DD).

cheapest[].priceUsdnumber

Cheapest observed price in the bucket, in USD.

cheapest[].providerIdstring

Provider id offering the cheapest price.

cheapest[].providerNamestring

Provider display name.

Main site Access Support