Skip to Content
Macro

List macro series

GET
/v1/macro/series

Market-context series: the catalogue.

Authorization

bearer
headerAuthorizationBearer <token>

Your API key: Authorization: Bearer opg_live_...

Query Parameters

source?string|null
entity?string|null
geo?string|null
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/macro/series'
Example Response
{  "data": [    {      "attribution": "string",      "enabled": true,      "entity": null,      "frequency": "string",      "geo": "string",      "latest": null,      "market_area": null,      "name": "string",      "points": 0,      "series_id": "string",      "source": "string",      "unit": "string"    }  ],  "meta": {    "as_of": "2019-08-24T14:15:22Z",    "api_version": "string",    "request_id": "string",    "next_cursor": "string",    "limit": 0,    "total": 0  }}