# Price history by provider (/api-reference/markets/price-history-by-provider)

## Price history by provider

`GET https://data.tryopengrid.com/v1/markets/{gpu}/history/providers`

Each provider's price over time for one GPU, with the market low / median / high.

### Parameters

- `gpu` (path, required, string): GPU id, e.g. `nvidia-h100-80gb-sxm5`. Older short names (`h100-80gb-sxm5`) are accepted as aliases; responses always return the id.
- `hours` (query, number): 0 = everything recorded
- `OpenGrid-Version` (header, string): The API version to shape the response for. Default: the version pinned to your key.

### Response `data`

- `change_pct` (number)
- `change_since` (string)
- `gpu` (string)
- `gpu_name` (string)
- `high` (array of number)
- `hours` (number)
- `low` (array of number)
- `market_from` (string)
- `median` (array of number)
- `providers` (array of object)
  - `available` (boolean | null)
  - `change_pct` (null | number)
  - `first_seen` (string)
  - `gpu_count` (null | number)
  - `now` (null | number)
  - `provider` (string)
  - `provider_name` (string)
  - `region` (null | string)
  - `series` (array of null | number)
  - `sku` (null | string)
- `t0` (string)
- `t1` (string)
- `times` (array of string)

Every success is `{"data": ..., "meta": {as_of, api_version, request_id, next_cursor?}}`.

### Example

```bash
curl "https://data.tryopengrid.com/v1/markets/nvidia-h100-80gb-sxm5/history/providers" \
  -H "Authorization: Bearer $OPENGRID_API_KEY"
```