# Listing changes (/api-reference/listings/listing-changes)

## Listing changes

`GET https://data.tryopengrid.com/v1/listings/history`

Recorded listing changes (price, availability, capacity), newest first.

### Parameters

- `gpu` (query, any)
- `provider` (query, any)
- `listing_id` (query, any)
- `from` (query, any)
- `to` (query, any)
- `limit` (query, integer)
- `cursor` (query, any)
- `OpenGrid-Version` (header, string): The API version to shape the response for. Default: the version pinned to your key.

### Response `data`

- `available` (boolean)
- `capacity` (null)
- `capacity_unit` (null)
- `gpu` (string)
- `gpu_count` (number)
- `gpu_name` (string)
- `listing_id` (string)
- `market_type` (string)
- `observed_at` (string)
- `price_per_gpu_hour` (number)
- `price_per_instance_hour` (number)
- `provider` (string)
- `provider_name` (string)
- `region` (null | string)

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

### Example

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