GET /v1/econ/initial-claims

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

Latest Initial jobless claims print from the DOL via FRED/ALFRED: first-release vs latest value with a revised flag (revisions never pose as print-day numbers), surprise vs a labeled expectation (market-implied when a matching prediction market exists, else trend-model), next weekly release date, and a 12-observation mini-series. Same shape as /v1/econ/:series bound to initial-claims.

Parameters

None.

Example

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

Example response

{
  "data": {
    "series": "initial-claims",
    "fred_id": "ICSA",
    "title": "Initial Jobless Claims (SA)",
    "source_agency": "U.S. Employment and Training Administration",
    "release_name": "Unemployment Insurance Weekly Claims Report",
    "units": "Number",
    "frequency": "Weekly",
    "latest_print": {
      "obs_date": "2026-08-08",
      "headline": 209,
      "headline_units": "thousands",
      "headline_basis": "first release level",
      "first_release_value": 209000,
      "latest_value": 209000,
      "revised": false,
      "first_released_on": "2026-08-13"
    },
    "surprise": {
      "actual": 209,
      "expected": 199,
      "surprise": 10,
      "expectation_source": "trend-model",
      "expectation_detail": "trend-model: mean of prior 4 levels"
    },
    "next_release_date": "2026-08-20",
    "recent": [
      {
        "obs_date": "2026-05-23",
        "value": 212000
      },
      {
        "obs_date": "2026-05-30",
        "value": 225000
      },
      {
        "obs_date": "2026-06-06",
        "value": 230000
      },
      {
        "obs_date": "2026-06-13",
        "value": 227000
      },
      {
        "obs_date": "2026-06-20",
        "value": 216000
      },
      {
        "obs_date": "2026-06-27",
        "value": 217000
      },
      {
        "obs_date": "2026-07-04",
        "value": 217000
      },
      {
        "obs_date": "2026-07-11",
        "value": 209000
      },
      {
        "obs_date": "2026-07-18",
        "value": 189000
      },
      {
        "obs_date": "2026-07-25",
        "value": 198000
      },
      {
        "obs_date": "2026-08-01",
        "value": 200000
      },
      {
        "obs_date": "2026-08-08",
        "value": 209000
      }
    ],
    "revisions": [
      {
        "obs_date": "2026-08-01",
        "first_value": 199000,
        "latest_value": 200000
      },
      {
        "obs_date": "2026-07-25",
        "first_value": 197000,
        "latest_value": 198000
      },
      {
        "obs_date": "2026-07-18",
        "first_value": 187000,
        "latest_value": 189000
      }
    ]
  },
  "meta": {
    "endpoint": "/v1/econ/initial-claims",
    "version": "1.0.0",
    "generated_at": "2026-08-18T22:54:16.049Z",
    "freshness": "daily",
    "sources": [
      "fred"
    ],
    "request_id": "req_00000000",
    "docs": "https://x402-factory.com/docs/econ.series.initial-claims",
    "data_mode": "live"
  }
}

Response schema (data payload)

{
  "type": "object",
  "properties": {
    "series": {
      "type": "string"
    },
    "fred_id": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "source_agency": {
      "type": "string"
    },
    "release_name": {
      "type": "string"
    },
    "units": {
      "type": "string"
    },
    "frequency": {
      "type": "string"
    },
    "latest_print": {
      "type": "object",
      "properties": {
        "obs_date": {
          "type": "string"
        },
        "headline": {
          "type": "number"
        },
        "headline_units": {
          "type": "string"
        },
        "headline_basis": {
          "type": "string"
        },
        "first_release_value": {
          "type": "number"
        },
        "latest_value": {
          "type": "number"
        },
        "revised": {
          "type": "boolean"
        },
        "first_released_on": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "obs_date",
        "headline",
        "headline_units",
        "headline_basis",
        "first_release_value",
        "latest_value",
        "revised",
        "first_released_on"
      ],
      "additionalProperties": false
    },
    "surprise": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "actual": {
              "type": "number"
            },
            "expected": {
              "type": "number"
            },
            "surprise": {
              "type": "number"
            },
            "expectation_source": {
              "type": "string",
              "enum": [
                "market-implied",
                "trend-model"
              ]
            },
            "expectation_detail": {
              "type": "string"
            },
            "comparable_market": {
              "type": "object",
              "properties": {
                "slug": {
                  "type": "string"
                },
                "market_p": {
                  "type": "number"
                },
                "question": {
                  "type": "string"
                }
              },
              "required": [
                "slug",
                "market_p",
                "question"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "actual",
            "expected",
            "surprise",
            "expectation_source",
            "expectation_detail"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "surprise_note": {
      "type": "string"
    },
    "next_release_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "next_release_expectation": {
      "type": "object",
      "properties": {
        "expected": {
          "type": "number"
        },
        "slug": {
          "type": "string"
        },
        "market_p": {
          "type": "number"
        },
        "question": {
          "type": "string"
        }
      },
      "required": [
        "expected",
        "slug",
        "market_p",
        "question"
      ],
      "additionalProperties": false
    },
    "recent": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "obs_date": {
            "type": "string"
          },
          "value": {
            "type": "number"
          }
        },
        "required": [
          "obs_date",
          "value"
        ],
        "additionalProperties": false
      }
    },
    "revisions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "obs_date": {
            "type": "string"
          },
          "first_value": {
            "type": "number"
          },
          "latest_value": {
            "type": "number"
          }
        },
        "required": [
          "obs_date",
          "first_value",
          "latest_value"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "series",
    "fred_id",
    "title",
    "source_agency",
    "release_name",
    "units",
    "frequency",
    "latest_print",
    "surprise",
    "next_release_date",
    "recent",
    "revisions"
  ],
  "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.02 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