Changelog

Release notes and API changes for Macro by Mark.

All notable API changes are documented here. Macro by Mark follows Semantic Versioning for breaking changes.

Subscribe to the changelog RSS feed or watch this page to be notified of new releases.

v1.0.0 - 2025-05-01

Public Beta release 🎉

Macro by Mark opens to the public on May 1, 2025 as a public beta. Everything in this release is shipping as part of the beta program — expect rapid iteration on coverage, accuracy, and surfaces through the beta period, and treat the API contract as stable but evolving.

Endpoints

  • GET /indicators/search - Full-text search across all available indicators.
  • GET /indicators/series - Retrieve series records by indicator ID.
  • GET /indicators/observations - Time-series observations with date-range filtering, unit transformations, and vintage selection.
  • GET /indicators/metadata - Detailed indicator metadata including source attribution and methodology notes.
  • GET /indicators/releases - Upcoming and historical data release schedules.
  • GET /indicators/vintages - Available vintage dates for point-in-time backtesting.

Providers at launch

FRED, BLS, BEA, WORLDBANK, OECD, IMF, EUROSTAT, ECB

Coverage

  • OECD: ~96 reference areas across PISA, ENV-STAT, AID, and REV-STATS, covering members, accession candidates, and the wider surface OECD reports on.
  • IMF: ~196 reference areas — all member states plus non-member economies IMF tracks (Hong Kong, Macao, Taiwan, Kosovo, Palestine, etc.).
  • ECB: 79 reference areas including EU candidates, EEA/EFTA non-OECD, the broader G20, key trading partners, and the W0 World aggregate.

Indicator detail pages also surface a subnational panel where the catalog has subdivision-level data (US states, NUTS-1 regions, Canadian provinces, Australian states, Japanese prefectures, Mexican states, Korean provinces, etc.) with deep links into Explore filtered by country=<X>&subdivision=<XX-YY>&topic=<concept>. The subdivision query parameter on GET /api/indicators/discover (alias: state for backward compatibility) accepts ISO 3166-2 codes (e.g. US-CA) and NUTS region codes (e.g. FR1).

Authentication

API key authentication via X-API-Key header. Three plans available: Free, Starter, and Pro.

Older entries will appear here as the API evolves.