FRED economic series API

Fetch a FRED (St. Louis Fed) economic time series by id, with observations, units, frequency, and source metadata.

Price$0.01per request

MethodGET

Route/v1/finance/fred-series

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

financemacrofredeconomic-data

API URLhttps://x402.hexl.dev/v1/finance/fred-series

Integration docs

Example request

{
  "series": "UNRATE",
  "start": "2024-01-01"
}

Example response

{
  "feed": "FRED",
  "series": "UNRATE",
  "title": "Unemployment Rate",
  "units": "Percent",
  "freq": "Monthly",
  "rangeStart": "2024-01-01",
  "rangeEnd": "2024-12-01",
  "obs": 12,
  "missing": 0,
  "data": [
    {
      "date": "2024-01-01",
      "value": 3.7
    }
  ],
  "sourceUrl": "https://fred.stlouisfed.org/series/UNRATE"
}

Input schema

{
  "type": "object",
  "required": [
    "series"
  ],
  "properties": {
    "series": {
      "type": "string",
      "minLength": 1,
      "examples": [
        "GDP",
        "UNRATE"
      ]
    },
    "start": {
      "type": "string",
      "description": "YYYY-MM-DD",
      "examples": [
        "2020-01-01"
      ]
    },
    "end": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 100000
    }
  }
}

Output schema

{
  "type": "object",
  "required": [
    "feed",
    "series",
    "data",
    "obs"
  ],
  "properties": {
    "feed": {
      "type": "string"
    },
    "series": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "units": {
      "type": "string"
    },
    "freq": {
      "type": "string"
    },
    "rangeStart": {
      "type": "string"
    },
    "rangeEnd": {
      "type": "string"
    },
    "obs": {
      "type": "number"
    },
    "missing": {
      "type": "number"
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "sourceUrl": {
      "type": "string"
    }
  }
}