GET /v1/econ/calendar

$0.01dailytier: datacache 3600sEngine E — US Economic Data (FRED)

Every tracked US economic series (CPI, payrolls, GDP, PCE, claims, housing, and more) with its next scheduled release date from the agencies' published calendars, sorted soonest first. The cheap planning read before paying for a full series view.

Parameters

None.

Example

curl "https://x402-factory.com/v1/econ/calendar"

Example response

{
  "data": {
    "releases": [
      {
        "series": "retail-sales",
        "title": "Advance Retail Sales (SA)",
        "release_name": "Advance Monthly Sales for Retail and Food Services",
        "source_agency": "U.S. Census Bureau",
        "next_release_date": "2026-08-14"
      },
      {
        "series": "housing-starts",
        "title": "Housing Starts (SAAR)",
        "release_name": "New Residential Construction",
        "source_agency": "U.S. Census Bureau",
        "next_release_date": "2026-08-18"
      },
      {
        "series": "building-permits",
        "title": "Building Permits (SAAR)",
        "release_name": "New Residential Construction",
        "source_agency": "U.S. Census Bureau",
        "next_release_date": "2026-08-18"
      },
      {
        "series": "industrial-production",
        "title": "Industrial Production Index (SA)",
        "release_name": "G.17 Industrial Production and Capacity Utilization",
        "source_agency": "Board of Governors of the Federal Reserve System (US)",
        "next_release_date": "2026-08-18"
      },
      {
        "series": "initial-claims",
        "title": "Initial Jobless Claims (SA)",
        "release_name": "Unemployment Insurance Weekly Claims Report",
        "source_agency": "U.S. Employment and Training Administration",
        "next_release_date": "2026-08-20"
      },
      {
        "series": "gdp-growth",
        "title": "Real GDP Growth (SAAR)",
        "release_name": "Gross Domestic Product",
        "source_agency": "U.S. Bureau of Economic Analysis",
        "next_release_date": "2026-08-26"
      },
      {
        "series": "pce-inflation",
        "title": "PCE Price Index (SA)",
        "release_name": "Personal Income and Outlays",
        "source_agency": "U.S. Bureau of Economic Analysis",
        "next_release_date": "2026-08-26"
      },
      {
        "series": "core-pce",
        "title": "Core PCE Price Index (SA)",
        "release_name": "Personal Income and Outlays",
        "source_agency": "U.S. Bureau of Economic Analysis",
        "next_release_date": "2026-08-26"
      },
      {
        "series": "payrolls",
        "title": "Total Nonfarm Payrolls (SA)",
        "release_name": "Employment Situation",
        "source_agency": "U.S. Bureau of Labor Statistics",
        "next_release_date": "2026-09-04"
      },
      {
        "series": "unemployment",
        "title": "Unemployment Rate",
        "release_name": "Employment Situation",
        "source_agency": "U.S. Bureau of Labor Statistics",
        "next_release_date": "2026-09-04"
      },
      {
        "series": "cpi",
        "title": "CPI (All Urban Consumers, SA)",
        "release_name": "Consumer Price Index",
        "source_agency": "U.S. Bureau of Labor Statistics",
        "next_release_date": "2026-09-11"
      },
      {
        "series": "core-cpi",
        "title": "Core CPI (ex food & energy, SA)",
        "release_name": "Consumer Price Index",
        "source_agency": "U.S. Bureau of Labor Statistics",
        "next_release_date": "2026-09-11"
      },
      {
        "series": "fed-funds",
        "title": "Effective Federal Funds Rate",
        "release_name": "H.15 Selected Interest Rates",
        "source_agency": "Board of Governors of the Federal Reserve System (US)",
        "next_release_date": "2026-11-27"
      },
      {
        "series": "treasury-10y",
        "title": "10-Year Treasury Yield (CM)",
        "release_name": "H.15 Selected Interest Rates",
        "source_agency": "Board of Governors of the Federal Reserve System (US)",
        "next_release_date": "2026-11-27"
      },
      {
        "series": "treasury-2y",
        "title": "2-Year Treasury Yield (CM)",
        "release_name": "H.15 Selected Interest Rates",
        "source_agency": "Board of Governors of the Federal Reserve System (US)",
        "next_release_date": "2026-11-27"
      }
    ]
  },
  "meta": {
    "endpoint": "/v1/econ/calendar",
    "version": "1.0.0",
    "generated_at": "2026-08-18T22:54:15.968Z",
    "freshness": "daily",
    "sources": [
      "fred"
    ],
    "request_id": "req_00000000",
    "docs": "https://x402-factory.com/docs/econ.calendar",
    "data_mode": "live"
  }
}

Response schema (data payload)

{
  "type": "object",
  "properties": {
    "releases": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "series": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "release_name": {
            "type": "string"
          },
          "source_agency": {
            "type": "string"
          },
          "next_release_date": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "series",
          "title",
          "release_name",
          "source_agency",
          "next_release_date"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "releases"
  ],
  "additionalProperties": false
}

The platform wraps every payload in an envelope: { "data": …, "meta": { endpoint, version, generated_at, freshness, sources, request_id, docs, data_mode } }.

Payment (x402)

Unpaid requests receive 402 with payment requirements (accepts). Pay $0.01 in USDC on Base per call via an X-PAYMENT header — see docs.x402.org. With PAYMENT_MODE=disabled (local dev) the endpoint is open.

Errors