# Macro series history (/api-reference/macro/macro-series-history)

## Macro series history

`GET https://data.tryopengrid.com/v1/macro/series/{series}/history`

One market-context series over time.

### Parameters

- `series` (path, required, string): Series id, as returned by `GET /v1/macro/series`.
- `since` (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`

Field-level schema not published for this route yet; send a request to see one.

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

### Example

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