# Market by region (/api-reference/markets/market-by-region)

## Market by region

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

One GPU by region group: cheapest, median, providers, premium.

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

- `global` (object)
  - `price` (object)
  - `providers` (number)
- `gpu` (string)
- `gpu_name` (string)
- `regions` (array of object)
  - `listings` (object)
  - `low_provider` (null | string)
  - `premium_vs_global_median` (null | number)
  - `price` (object)
  - `provider_ids` (array of string)
  - `providers` (number)
  - `reason` (null | string)
  - `region_group` (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/regions" \
  -H "Authorization: Bearer $OPENGRID_API_KEY"
```