---
title: "Economic Surprise Index history"
method: GET
path: "/macro/surprise/history"
tags: ["macro"]
---

# Economic Surprise Index history

`GET /macro/surprise/history`

## Request

- Base URL: `https://kresmion.com/v1`
- URL: `https://kresmion.com/v1/macro/surprise/history`
- Auth: HTTP bearer

The daily Economic Surprise Index series over a look-back window, oldest first. One point is one calendar day: the index over the trailing 90-day window ending that day (`value`) and the number of scored headline releases inside that window (`n`). A day with no release carries the trailing-window value forward, so consecutive points share most of their releases; `value` is null when the window holds fewer than 3 scored releases.

Read `n` alongside `value`: a window with a handful of releases is a small sample, so a swing on a thin window is not a macro turn.

As with the latest reading, only the derived aggregate is served. The per-event calendar rows behind it are not exposed through this API.

## Query parameters

- `days` integer: Look-back window in days.
- `country` string: Country code the index is computed for.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kresmion/apis/kresmion-api.md) · [All operations](https://skmtc.dev/kresmion/apis/kresmion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kresmion/apis/kresmion-api/revisions/a94962dddccb?raw)