GET /v1/econ/core-cpi

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

Latest Core CPI inflation print from the BLS 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 monthly release date, and a 12-observation mini-series. Same shape as /v1/econ/:series bound to core-cpi.

Parameters

None.

Example

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

Example response

{
  "data": {
    "series": "core-cpi",
    "fred_id": "CPILFESL",
    "title": "Core CPI (ex food & energy, SA)",
    "source_agency": "U.S. Bureau of Labor Statistics",
    "release_name": "Consumer Price Index",
    "units": "Index 1982-1984=100",
    "frequency": "Monthly",
    "latest_print": {
      "obs_date": "2026-07-01",
      "headline": 0.22,
      "headline_units": "% m/m",
      "headline_basis": "first release vs prior period (latest vintage)",
      "first_release_value": 336.789,
      "latest_value": 336.789,
      "revised": false,
      "first_released_on": "2026-08-12"
    },
    "surprise": {
      "actual": 0.22,
      "expected": 0.19,
      "surprise": 0.03,
      "expectation_source": "trend-model",
      "expectation_detail": "trend-model: mean of prior 3 % m/m prints"
    },
    "next_release_date": "2026-09-11",
    "recent": [
      {
        "obs_date": "2025-07-01",
        "value": 328.682
      },
      {
        "obs_date": "2025-08-01",
        "value": 329.7
      },
      {
        "obs_date": "2025-09-01",
        "value": 330.418
      },
      {
        "obs_date": "2025-11-01",
        "value": 331.043
      },
      {
        "obs_date": "2025-12-01",
        "value": 331.814
      },
      {
        "obs_date": "2026-01-01",
        "value": 332.793
      },
      {
        "obs_date": "2026-02-01",
        "value": 333.512
      },
      {
        "obs_date": "2026-03-01",
        "value": 334.165
      },
      {
        "obs_date": "2026-04-01",
        "value": 335.423
      },
      {
        "obs_date": "2026-05-01",
        "value": 336.121
      },
      {
        "obs_date": "2026-06-01",
        "value": 336.065
      },
      {
        "obs_date": "2026-07-01",
        "value": 336.789
      }
    ],
    "revisions": [
      {
        "obs_date": "2025-12-01",
        "first_value": 331.86,
        "latest_value": 331.814
      },
      {
        "obs_date": "2025-11-01",
        "first_value": 331.068,
        "latest_value": 331.043
      },
      {
        "obs_date": "2025-09-01",
        "first_value": 330.542,
        "latest_value": 330.418
      }
    ]
  },
  "meta": {
    "endpoint": "/v1/econ/core-cpi",
    "version": "1.0.0",
    "generated_at": "2026-08-18T22:54:16.037Z",
    "freshness": "daily",
    "sources": [
      "fred"
    ],
    "request_id": "req_00000000",
    "docs": "https://x402-factory.com/docs/econ.series.core-cpi",
    "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