# x402stock Economic Calendar & FOMC Schedule

> x402stock Economic Calendar & FOMC Schedule is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Returns upcoming (or past) US macroeconomic data release dates from FRED and FOMC meeting schedule within a configurable day window

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/calendar
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-economic-calendar-fomc-schedule-213b4a11
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_twk31y9zThLdM5P7H_9Qr

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 x402stock-economic-calendar-fomc-schedule-213b4a11
```

Example prompt: What major US economic data releases and Fed meetings are scheduled over the next 30 days? Show me upcoming events, not past ones.

## When to prefer this

Use this endpoint when an AI agent needs to know when upcoming (or recent past) US macroeconomic data releases or FOMC meetings are scheduled — ideal for planning trades, briefing users on market-moving events, or building economic calendars. Prefer this over general web search when you need structured, FRED-sourced release dates with categories and IDs in a single pay-per-call call with no API key required.

## Known failure modes

- Invalid 'days' parameter (must be integer 1-90): returns 400 error
- Invalid 'past' value (must be 'true' or 'false' string): returns 400 error
- FRED upstream unavailable: may return 503 or stale data
- Payment not fulfilled (x402): returns 402 Payment Required before data is served
- days exceeds maximum of 90: returns validation error

## How this service works

Upcoming US economic data releases — WHEN the market-moving prints land, not just their latest values. Returns curated high-importance releases (CPI, PPI, PCE, jobs, JOLTS, GDP, retail sales, housing starts, industrial production) within `?days=` (default 30, max 90), each with date and category, plus the next FOMC meeting. `?past=true` includes the last week. Release dates from FRED.

## Output

Returns a JSON object with: date range (from/to), count of releases, an array of upcoming economic releases each with date, name, category (e.g. inflation, employment, growth), and release_id from FRED, plus a FOMC object showing the next meeting date and how many days away it is, along with FRED/Fed attribution.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "days": 30,
   "past": "false"
  }
 }
}
```

## 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",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "days",
      "past"
     ],
     "properties": {
      "days": {
       "type": "integer",
       "default": 30,
       "maximum": 90,
       "exclusiveMinimum": 0
      },
      "past": {
       "enum": [
        "true",
        "false"
       ],
       "type": "string",
       "default": "false"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "source",
      "as_of",
      "window_days",
      "from",
      "to",
      "count",
      "releases",
      "fomc",
      "attribution"
     ],
     "properties": {
      "to": {
       "type": "string"
      },
      "fomc": {
       "type": "object",
       "required": [
        "next_meeting",
        "days_until"
       ],
       "properties": {
        "days_until": {
         "anyOf": [
          {
           "type": "number"
          },
          {
           "type": "null"
          }
         ]
        },
        "next_meeting": {
         "anyOf": [
          {
           "type": "string"
          },
          {
           "type": "null"
          }
         ]
        }
       },
       "additionalProperties": false
      },
      "from": {
       "type": "string"
      },
      "as_of": {
       "type": "string"
      },
      "count": {
       "type": "number"
      },
      "source": {
       "type": "string",
       "const": "fred"
      },
      "releases": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "release_id",
         "name",
         "category",
         "date"
        ],
        "properties": {
         "date": {
          "type": "string"
         },
         "name": {
          "type": "string"
   
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": "2026-07-05",
  "fomc": {
   "days_until": 12,
   "next_meeting": "2026-06-17"
  },
  "from": "2026-06-05",
  "as_of": "2026-06-05T12:00:00.000Z",
  "count": 3,
  "source": "fred",
  "releases": [
   {
    "date": "2026-06-10",
    "name": "Consumer Price Index",
    "category": "inflation",
    "release_id": 10
   },
   {
    "date": "2026-07-02",
    "name": "Employment Situation",
    "category": "employment",
    "release_id": 50
   },
   {
    "date": "2026-06-25",
    "name": "Gross Domestic Product",
    "category": "growth",
    "release_id": 53
   }
  ],
  "attribution": "Economic release dates: Federal Reserve Bank of St. Louis (FRED). FOMC meeting dates: U.S. Federal Reserve.",
  "window_days": 30
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-economic-calendar-fomc-schedule-213b4a11/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)