# Financial Data x402 – Macro Calendar

> Financial Data x402 – Macro Calendar is a paid API for AI agents from x402financialdata.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-10).

Returns a calendar of upcoming FOMC meetings and major economic data releases (GDP, CPI, NFP, PCE, etc.) for a specified date range.

## Facts

- Endpoint: GET https://x402financialdata.com/macro-calendar?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/financial-data-x402-macro-calendar-04ec0016
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FkbrtozlMiCeaZHJgt_51

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability financial-data-x402-macro-calendar-04ec0016
```

Example prompt: Can you pull up the macro economic calendar from July 21 to September 1, 2026 — I want to see all scheduled FOMC meetings and major data releases like CPI, GDP, and Non-Farm Payrolls?

## When to prefer this

Use this endpoint when you need a structured, machine-readable forward-looking calendar of macroeconomic events — specifically FOMC meeting dates and key U.S. economic data releases — for a custom date range. Ideal for agents building trading decision support, risk management workflows, or financial planning pipelines. Preferred over manual scraping or generic news APIs because it provides structured release IDs, dates, and countdown data with a simple pay-per-call model requiring no API keys or subscriptions.

## Known failure modes

- Missing required 'from' or 'to' query parameters returns a validation error
- Invalid date format (non-ISO 8601) causes a parse error
- Date range too wide may return empty or partial results
- Payment failure via x402 protocol blocks access if USDC balance is insufficient
- 'to' date earlier than 'from' date may return empty results or error

## How this service works

Pay-per-call stock, macro, on-chain, and crypto data over the x402 protocol. USDC on Base or Solana, no API keys, no subscriptions.

## Output

Returns a JSON object containing: the queried date range, a list of FOMC meeting windows (start date, end date, days until, whether a Summary of Economic Projections is included), and a list of scheduled economic data releases (release name, date, release ID, days until). Also includes a failed_releases array for any data that could not be retrieved.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "from",
      "to"
     ],
     "properties": {
      "to": {
       "type": "string",
       "format": "date",
       "description": "End date, e.g. 2026-09-01"
      },
      "from": {
       "type": "string",
       "format": "date",
       "description": "Start date, e.g. 2026-07-21"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": "2026-09-01",
  "from": "2026-07-21",
  "fomc_meetings": [
   {
    "end_date": "2026-07-29",
    "days_until": 7,
    "start_date": "2026-07-28",
    "has_summary_of_projections": false
   }
  ],
  "failed_releases": [],
  "economic_releases": [
   {
    "date": "2026-07-30",
    "release": "GDP",
    "days_until": 9,
    "release_id": 53
   },
   {
    "date": "2026-07-30",
    "release": "PCE",
    "days_until": 9,
    "release_id": 54
   },
   {
    "date": "2026-08-07",
    "release": "Non-Farm Payrolls",
    "days_until": 17,
    "release_id": 50
   },
   {
    "date": "2026-08-12",
    "release": "CPI",
    "days_until": 22,
    "release_id": 10
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/financial-data-x402-macro-calendar-04ec0016/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402financialdata.com](https://www.zero.xyz/host/x402financialdata.com/llms.txt)