GET /v1/econ/dashboard

$0.03dailytier: datacache 900sEngine E — US Economic Data (FRED)

All tracked US economic series in one response: the latest headline print (with its date and a revised flag) plus each series' next scheduled release date. The one-call state of the US economy for agents that would otherwise fan out fifteen reads.

Parameters

None.

Example

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

Example response

{
  "data": {
    "series": [
      {
        "series": "cpi",
        "title": "CPI (All Urban Consumers, SA)",
        "headline": 0.07,
        "headline_units": "% m/m",
        "obs_date": "2026-07-01",
        "revised": false,
        "next_release_date": "2026-09-11"
      },
      {
        "series": "core-cpi",
        "title": "Core CPI (ex food & energy, SA)",
        "headline": 0.22,
        "headline_units": "% m/m",
        "obs_date": "2026-07-01",
        "revised": false,
        "next_release_date": "2026-09-11"
      },
      {
        "series": "payrolls",
        "title": "Total Nonfarm Payrolls (SA)",
        "headline": -23,
        "headline_units": "thousands (m/m change)",
        "obs_date": "2026-07-01",
        "revised": false,
        "next_release_date": "2026-09-04"
      },
      {
        "series": "unemployment",
        "title": "Unemployment Rate",
        "headline": 4.1,
        "headline_units": "%",
        "obs_date": "2026-07-01",
        "revised": false,
        "next_release_date": "2026-09-04"
      },
      {
        "series": "initial-claims",
        "title": "Initial Jobless Claims (SA)",
        "headline": 209,
        "headline_units": "thousands",
        "obs_date": "2026-08-08",
        "revised": false,
        "next_release_date": "2026-08-20"
      },
      {
        "series": "gdp-growth",
        "title": "Real GDP Growth (SAAR)",
        "headline": 1.5,
        "headline_units": "%",
        "obs_date": "2026-04-01",
        "revised": false,
        "next_release_date": "2026-08-26"
      },
      {
        "series": "pce-inflation",
        "title": "PCE Price Index (SA)",
        "headline": -0.11,
        "headline_units": "% m/m",
        "obs_date": "2026-06-01",
        "revised": false,
        "next_release_date": "2026-08-26"
      },
      {
        "series": "core-pce",
        "title": "Core PCE Price Index (SA)",
        "headline": 0.13,
        "headline_units": "% m/m",
        "obs_date": "2026-06-01",
        "revised": false,
        "next_release_date": "2026-08-26"
      },
      {
        "series": "fed-funds",
        "title": "Effective Federal Funds Rate",
        "headline": 3.63,
        "headline_units": "%",
        "obs_date": "2026-07-01",
        "revised": false,
        "next_release_date": "2026-11-27"
      },
      {
        "series": "treasury-10y",
        "title": "10-Year Treasury Yield (CM)",
        "headline": 4.68,
        "headline_units": "%",
        "obs_date": "2026-08-12",
        "revised": false,
        "next_release_date": "2026-11-27"
      },
      {
        "series": "treasury-2y",
        "title": "2-Year Treasury Yield (CM)",
        "headline": 4.2,
        "headline_units": "%",
        "obs_date": "2026-08-12",
        "revised": false,
        "next_release_date": "2026-11-27"
      },
      {
        "series": "retail-sales",
        "title": "Advance Retail Sales (SA)",
        "headline": 0.22,
        "headline_units": "% m/m",
        "obs_date": "2026-06-01",
        "revised": false,
        "next_release_date": "2026-08-14"
      },
      {
        "series": "housing-starts",
        "title": "Housing Starts (SAAR)",
        "headline": 1427,
        "headline_units": "thousands",
        "obs_date": "2026-06-01",
        "revised": false,
        "next_release_date": "2026-08-18"
      },
      {
        "series": "building-permits",
        "title": "Building Permits (SAAR)",
        "headline": 1367,
        "headline_units": "thousands",
        "obs_date": "2026-06-01",
        "revised": true,
        "next_release_date": "2026-08-18"
      },
      {
        "series": "industrial-production",
        "title": "Industrial Production Index (SA)",
        "headline": 0.08,
        "headline_units": "% m/m",
        "obs_date": "2026-06-01",
        "revised": false,
        "next_release_date": "2026-08-18"
      }
    ]
  },
  "meta": {
    "endpoint": "/v1/econ/dashboard",
    "version": "1.0.0",
    "generated_at": "2026-08-18T22:54:15.969Z",
    "freshness": "daily",
    "sources": [
      "fred"
    ],
    "request_id": "req_00000000",
    "docs": "https://x402-factory.com/docs/econ.dashboard",
    "data_mode": "live"
  }
}

Response schema (data payload)

{
  "type": "object",
  "properties": {
    "series": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "series": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "headline": {
            "type": "number"
          },
          "headline_units": {
            "type": "string"
          },
          "obs_date": {
            "type": "string"
          },
          "revised": {
            "type": "boolean"
          },
          "next_release_date": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "series",
          "title",
          "headline",
          "headline_units",
          "obs_date",
          "revised",
          "next_release_date"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "series"
  ],
  "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.03 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

StatusCodeMeaning
400INVALID_PARAMSInput failed validation; message lists the offending fields.
404NOT_FOUNDNo matching resource; suggestion may point to a sibling endpoint.
410RESOLVEDMarket/event settled; body includes a resolution summary.
503STALE_DATAUpstream feed down; stale data is never silently served beyond 2× cache TTL.
500INTERNALOur bug. The request_id helps us find it.