# Get a market (/api-reference/markets/get-a-market)

## Get a market

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

One GPU's market: price, stats, providers, capability, alternatives.

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

### Response `data`

- `alternatives` (object)
  - `alternatives` (array of object)
  - `gpu` (string)
  - `gpu_name` (string)
  - `note` (string)
  - `target` (object)
- `by_provider` (array of object)
  - `available` (boolean)
  - `change_24h` (object)
  - `listing_id` (string)
  - `listings` (number)
  - `premium_vs_others_median` (number)
  - `price` (number)
  - `provider` (string)
  - `provider_name` (string)
  - `rank` (number)
  - `region` (null | string)
  - `sku` (string)
- `capability` (object)
  - `gpu` (string)
  - `gpu_name` (string)
  - `label` (string)
  - `metrics` (object)
- `context` (object)
  - `current` (object)
  - `gpu` (string)
  - `gpu_name` (string)
  - `hour` (string)
  - `interruptible` (boolean)
  - `label` (null)
  - `label_reason` (string)
  - `label_window` (null)
  - `metrics` (object)
  - `price_concept` (string)
  - `reason` (null)
  - `segment` (string)
  - `summaries` (array of string)
- `gpu` (string)
- `gpu_name` (string)
- `listings` (object)
  - `availability_unknown` (number)
  - `available` (number)
  - `live` (number)
  - `priced` (number)
  - `sold_out` (number)
  - `stats` (object)
- `price` (object)
  - `currency` (string)
  - `high` (number)
  - `low` (number)
  - `median` (number)
  - `unit` (string)
- `providers` (number)
- `score` (object)
  - `components` (object)
  - `confidence` (string)
  - `efficiency` (number)
  - `fragmentation` (number)
  - `label` (string)
  - `reason` (null)
  - `saturation` (object)
  - `weights` (object)
- `stats` (object)
  - `cv` (number)
  - `high` (number)
  - `iqr` (number)
  - `iqr_rel` (number)
  - `low` (number)
  - `mean` (number)
  - `median` (number)
  - `n` (number)
  - `q1` (number)
  - `q3` (number)
  - `reasons` (object)
  - `spread_abs` (number)
  - `spread_pct_of_low` (number)
  - `spread_pct_of_median` (number)
  - `stdev` (number)

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" \
  -H "Authorization: Bearer $OPENGRID_API_KEY"
```