Skip to Content
Listings

List listings

GET
/v1/listings

Current price listings: every offer, cheapest first, with provenance.

Authorization

bearer
headerAuthorizationBearer <token>

Your API key: Authorization: Bearer opg_live_...

Query Parameters

gpu?string|null
provider?string|null
region_group?string|null
market_type?string|null
available?boolean|null
as_of?|

the listings as published at this time (UTC)

previous?Previous

add price_change: the price before the newest recorded change

Defaultfalse
limit?Limit
Range1 <= value <= 1000
Default100
cursor?string|null

Header Parameters

OpenGrid-Version?"2026-11-03"

The API version to shape the response for. Default: the version pinned to your key.

Value in"2026-11-03"

Response Body

Success

application/json
  1. response
data*array<>
meta*

Present on every success. List routes add limit, next_cursor (null on the last page) and total.

Example Request
curl -X GET 'https://data.tryopengrid.com/v1/listings'
Example Response
{  "data": [    {      "available": true,      "capacity": null,      "capacity_unit": null,      "country": null,      "currency": "string",      "first_seen_at": "string",      "gpu": "string",      "gpu_count": 0,      "gpu_name": "string",      "interruptible": true,      "listing_id": "string",      "market_type": "string",      "observed_at": "string",      "original": null,      "price_change": null,      "price_per_gpu_hour": 0,      "price_per_instance_hour": 0,      "provider": "string",      "provider_name": "string",      "provider_tier": null,      "ram_gb": null,      "raw_gpu_name": "string",      "region": null,      "region_group": "string",      "sku": "string",      "storage_gb": null,      "trust": {        "age_seconds": 0,        "availability_basis": "string",        "confidence": "string",        "confidence_reasons": [          "string"        ],        "flags": [          null        ],        "freshness": "string",        "held": [          null        ],        "last_changed": "string",        "last_fetched": "string",        "last_seen": "string",        "polling_interval_seconds": 0,        "provider_status": "string",        "source": null,        "source_detail": "string",        "source_type": "string"      },      "vcpu": null    }  ],  "meta": {    "as_of": "2019-08-24T14:15:22Z",    "api_version": "string",    "request_id": "string",    "next_cursor": "string",    "limit": 0,    "total": 0  }}