> ## Documentation Index
> Fetch the complete documentation index at: https://lava.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# FRED

> Federal Reserve Economic Data API providing 800,000+ time series on GDP, inflation, unemployment, interest rates, and more.

Federal Reserve Economic Data API providing 800,000+ time series on GDP, inflation, unemployment, interest rates, and more. Best for macroeconomic research, trend analysis, and building data-driven financial context. Unlike BLS or BEA which cover narrow domains, FRED aggregates data from dozens of sources into a single searchable interface.

2 example endpoints available through Lava's AI Gateway. See the [FRED API docs](https://fred.stlouisfed.org/docs/api/fred/) for full documentation.

<Info>This provider is **managed** — no additional setup required.</Info>

<Info>This is a **catch-all provider** — any valid URL under `https://api.stlouisfed.org/fred` is supported. FRED economic data API. Construct URL as [https://api.stlouisfed.org/fred/\&#123;endpoint\&#125](https://api.stlouisfed.org/fred/\&#123;endpoint\&#125);. Common endpoints: /series/observations?series\_id=GDP, /series/search?search\_text=inflation, /releases, /category. Auth params (api\_key, file\_type) are added automatically. The endpoints below are curated examples.</Info>

## Endpoints

### Get time series observations

**GET** `https://api.stlouisfed.org/fred/series/observations?series_id=GDP&file_type=json` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.stlouisfed.org/fred/series/observations?series_id=GDP&file_type=json', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.stlouisfed.org%2Ffred%2Fseries%2Fobservations%3Fseries_id%3DGDP%26file_type%3Djson" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

### Search for time series

**GET** `https://api.stlouisfed.org/fred/series/search?search_text=inflation&file_type=json` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.stlouisfed.org/fred/series/search?search_text=inflation&file_type=json', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.stlouisfed.org%2Ffred%2Fseries%2Fsearch%3Fsearch_text%3Dinflation%26file_type%3Djson" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

## Next Steps

<CardGroup cols={2}>
  <Card title="All Providers" icon="grid" href="/gateway/supported-providers">
    Browse all supported AI providers
  </Card>

  <Card title="Forward Proxy" icon="route" href="/gateway/forward-proxy">
    Learn how to construct proxy URLs and authenticate requests
  </Card>
</CardGroup>