# Market history (/api-reference/markets/market-history)

## Market history

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

One GPU over time: low / median / high / provider count + index.

### 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.
- `window` (query, string)
- `interval` (query, any)
- `segment` (query, string)
- `OpenGrid-Version` (header, string): The API version to shape the response for. Default: the version pinned to your key.

### Response `data`

- `coherent_from` (string)
- `currency` (string)
- `gpu` (string)
- `gpu_name` (string)
- `index` (object)
  - `index` (string)
  - `points` (array of object)
- `interval` (string)
- `latest_hour` (string)
- `providers_joined` (array of object)
  - `first_hour` (string)
  - `provider` (string)
  - `provider_name` (string)
- `segment` (string)
- `series` (array of object)
  - `high` (number)
  - `low` (number)
  - `median` (number)
  - `providers` (number)
  - `t` (string)
- `unit` (string)
- `window` (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" \
  -H "Authorization: Bearer $OPENGRID_API_KEY"
```