# x402stock Economic Calendar

> x402stock Economic Calendar is a paid API for AI agents from x402stock.vercel.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns upcoming (and optionally past) high-importance US economic data release dates — CPI, PPI, PCE, jobs, GDP, and more — plus the next FOMC meeting date, sourced from FRED

## Facts

- Endpoint: GET https://x402stock.vercel.app/api/v1/calendar
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-economic-calendar-fda4252c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__fsK-J0liLRgznCNu2VPG

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-fda4252c
```

Example prompt: What major US economic releases — like CPI, jobs, or GDP — are coming out in the next 45 days, and when is the next FOMC meeting?

## When to prefer this

Use this endpoint when you need the precise dates of upcoming US macro data releases (CPI, PPI, PCE, NFP, GDP, JOLTS, retail sales, housing starts, industrial production) and the next FOMC meeting, rather than the actual latest values of those indicators. Ideal for pre-trade risk planning, macro calendars, or scheduling automated checks around market-moving events. Prefer this over general economic data endpoints when timing — not magnitude — is the primary need.

## Known failure modes

- days parameter exceeds 90 — validation error
- days parameter is 0 or negative — validation error
- No releases found in window — returns empty releases array with count 0
- FRED upstream unavailable — potential 5xx or stale data
- past parameter must be string 'true' or 'false', not boolean — may cause parse 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

A JSON object containing: the data source (FRED), as-of timestamp, window parameters (from/to dates, window_days, count), an array of upcoming high-importance releases each with release_id, name, category, and date, a fomc object with next_meeting date and days_until, and an attribution string.

## 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)
```

## More

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