# List markets (/api-reference/markets/list-markets)

## List markets

`GET https://data.tryopengrid.com/v1/markets`

Current market per GPU: price, spread, efficiency score.

### Parameters

- `min_providers` (query, integer)
- `vendor` (query, any)
- `limit` (query, integer)
- `cursor` (query, any)
- `trend` (query, boolean): add change (lowest price over `hours`) and trend (a small series)
- `hours` (query, number): trend window; 0 = everything recorded
- `points` (query, integer): trend points
- `OpenGrid-Version` (header, string): The API version to shape the response for. Default: the version pinned to your key.

### Response `data`

- `gpu` (string)
- `gpu_name` (string)
- `high_provider` (string)
- `listings` (object)
  - `availability_unknown` (number)
  - `available` (number)
  - `live` (number)
  - `priced` (number)
  - `sold_out` (number)
- `low_provider` (string)
- `price` (object)
  - `currency` (string)
  - `high` (number)
  - `low` (number)
  - `median` (number)
  - `unit` (string)
- `providers` (number)
- `score` (object)
  - `confidence` (null | string)
  - `efficiency` (null | number)
  - `fragmentation` (null | number)
  - `label` (null | string)
  - `reason` (null | string)
- `spread` (object)
  - `abs` (number)
  - `pct_of_low` (number)
  - `pct_of_median` (number)

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

### Example

```bash
curl "https://data.tryopengrid.com/v1/markets" \
  -H "Authorization: Bearer $OPENGRID_API_KEY"
```