FRED¶

Economic indicators from the Federal Reserve Economic Data (FRED) API.

Source ID¶

"source": "fred"

Credentials¶

"credentials": {
    "api_key": "your-fred-api-key"
}

Get your API key at FRED (free).

Ticker Format¶

FRED uses series IDs as tickers. Aurastream also provides built-in mappings for common indicators by country:

CPI (Consumer Price Index)¶

Use 2-letter country codes for CPI data:

Ticker	Country
`US`	United States
`GB`	United Kingdom
`DE`	Germany
`JP`	Japan
`CN`	China
`BR`	Brazil
`IN`	India

Or use raw FRED series IDs directly (e.g., CPIAUCSL for US CPI).

GDP¶

FRED series IDs for real GDP (e.g., GDPC1 for US real GDP).

Interest Rates¶

3-month and 10-year rates available for 20+ countries.

Supported Intervals¶

FRED data comes at its native frequency (typically monthly, quarterly, or annual). The interval parameter is accepted but the data frequency depends on the series.

Parameters¶

Parameter	Values	Default	Description
`frequency`	`"quarterly"`, `"annual"`	`"quarterly"`	Reporting frequency

Examples¶

US CPI (monthly)¶

response = requests.post(URL, headers=HEADERS, json={
    "tickerlist": ["US"],
    "start": "2020-01-01",
    "end": "2025-06-01",
    "interval": "1M",
    "source": "fred",
    "credentials": {
        "api_key": "YOUR_FRED_KEY"
    }
})

Multiple countries¶

response = requests.post(URL, headers=HEADERS, json={
    "tickerlist": ["US", "GB", "DE", "JP"],
    "start": "2020-01-01",
    "end": "2025-06-01",
    "interval": "1M",
    "source": "fred",
    "credentials": {
        "api_key": "YOUR_FRED_KEY"
    }
})