GET /v1/econ/gdp-growth

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

Latest Real GDP growth print from the BEA 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 quarterly release date, and a 12-observation mini-series. Same shape as /v1/econ/:series bound to gdp-growth.

Parameters

None.

Example

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

Example response

{
  "data": {
    "series": "gdp-growth",
    "fred_id": "A191RL1Q225SBEA",
    "title": "Real GDP Growth (SAAR)",
    "source_agency": "U.S. Bureau of Economic Analysis",
    "release_name": "Gross Domestic Product",
    "units": "Percent Change at Annual Rate",
    "frequency": "Quarterly",
    "latest_print": {
      "obs_date": "2026-04-01",
      "headline": 1.5,
      "headline_units": "%",
      "headline_basis": "first release level",
      "first_release_value": 1.5,
      "latest_value": 1.5,
      "revised": false,
      "first_released_on": "2026-07-30"
    },
    "surprise": {
      "actual": 1.5,
      "expected": 2.1,
      "surprise": -0.6,
      "expectation_source": "trend-model",
      "expectation_detail": "trend-model: naive (prior level)"
    },
    "next_release_date": "2026-08-26",
    "recent": [
      {
        "obs_date": "2025-04-01",
        "value": 3.8
      },
      {
        "obs_date": "2025-07-01",
        "value": 4.4
      },
      {
        "obs_date": "2025-10-01",
        "value": 0.5
      },
      {
        "obs_date": "2026-01-01",
        "value": 2.1
      },
      {
        "obs_date": "2026-04-01",
        "value": 1.5
      }
    ],
    "revisions": [
      {
        "obs_date": "2026-01-01",
        "first_value": 2,
        "latest_value": 2.1
      },
      {
        "obs_date": "2025-10-01",
        "first_value": 1.4,
        "latest_value": 0.5
      },
      {
        "obs_date": "2025-07-01",
        "first_value": 4.3,
        "latest_value": 4.4
      }
    ]
  },
  "meta": {
    "endpoint": "/v1/econ/gdp-growth",
    "version": "1.0.0",
    "generated_at": "2026-08-18T22:54:16.047Z",
    "freshness": "daily",
    "sources": [
      "fred"
    ],
    "request_id": "req_00000000",
    "docs": "https://x402-factory.com/docs/econ.series.gdp-growth",
    "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