---
title: "The macro calendar"
method: GET
path: "/api/macro/calendar"
tags: ["Short URLs"]
---

# The macro calendar

`GET /api/macro/calendar`

## Request

- Base URL: `https://api.prereason.com`
- URL: `https://api.prereason.com/api/macro/calendar`
- Auth: HTTP bearer

The macro calendar. The dates ahead of the main US releases (PPI, retail sales, GDP, personal income and outlays), the FOMC and ECB decisions, the FOMC minutes and the Treasury coupon auctions ahead (the week's, or the next one), each from its publisher's own calendar; and the latest US jobs report, CPI and weekly jobless claims as published, with their revisions. Release calendar data for macro research agents. Alias for `GET /api/context?briefing=macro.calendar`. Paid per request over x402 or MPP with no API key, or read with a key on the Basic plan or above.

## Query parameters

- `format` 'json' | 'markdown'
- `date` string

## Response `200`

macro.calendar data

## Other responses

- `401`: Authentication required
- `402`: Payment required. The body is an x402 v2 payment quote naming this resource, its price in USDC, and the accepted networks. Pay and retry with the payment header, or authenticate with an API key instead.

## Changes

- **2026-10-11** `6754bd53d584`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/prereason/apis/prereason-api/changes/api/macro/calendar/get.md)

---

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