# OFR Financial Stress API
> Live financial-stability data from the U.S. Office of Financial Research, the federal body created after 2008 to measure systemic risk, via its public Financial Stress Index (FSI). The OFR FSI is a daily, market-based index of stress in the global financial system: a positive value means above-average stress, zero is the historical norm and negative means calm. Get the latest headline index with its day-over-day change. Decompose it into the five kinds of stress it tracks — credit, equity valuation, funding, safe-assets/flight-to-safety and volatility — to see which channel is driving stress. Split it by where the stress sits, the United States versus other advanced economies. Pull the daily time series of the headline or any component back two decades. Live, no key, nothing stored. Distinct from rate, FX, central-bank and stock-index APIs — this is a single, official, daily measure of how stressed the financial system is and why. Perfect for macro, risk, trading and analytics apps.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/ofr-api/..."
```

## Pricing
- **Free** (Free) — 7,500 calls/Mo, 2 req/s
- **Starter** ($11/Mo) — 145,000 calls/Mo, 5 req/s
- **Pro** ($29/Mo) — 810,000 calls/Mo, 12 req/s
- **Business** ($71/Mo) — 4,400,000 calls/Mo, 30 req/s

## Endpoints

### Index

#### `GET /v1/categories` — Five stress categories

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/ofr-api/v1/categories"
```

**Response:**
```json
{
    "data": {
        "date": "2026-06-05",
        "source": "U.S. Office of Financial Research",
        "headline": -2.472,
        "categories": [
            {
                "label": "Credit",
                "category": "Credit",
                "contribution": -1.214
            },
            {
                "label": "Equity valuation",
                "category": "Equity_Valuation",
                "contribution": -0.572
            },
            {
                "label": "Funding",
                "category": "Funding",
                "contribution": -0.083
            },
            {
                "label": "Safe assets / flight to safety",
                "category": "Flight_to_Safety",
                "contribution": -0.332
            },
            {
                "label": "Volatility",
                "category": "Volatility",
                "contribution": -0.271
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-09T20:24:24.836Z",
        "request_id": "9eaaa782-52e7-45d6-9a72-0c7314ee8967"
    },
    "status": "ok",
    "message": "Categories retrieved successfully",
    "success": true
}
```

#### `GET /v1/fsi` — Latest headline stress index

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/ofr-api/v1/fsi"
```

**Response:**
```json
{
    "data": {
        "date": "2026-06-05",
        "index": "OFR Financial Stress Index",
        "value": -2.472,
        "change": 0.21,
        "source": "U.S. Office of Financial Research",
        "previous_date": "2026-06-04",
        "interpretation": "below-average stress (calm)",
        "previous_value": -2.682
    },
    "meta": {
        "timestamp": "2026-06-09T20:24:25.251Z",
        "request_id": "7f6e1a2d-3514-4d3c-8b04-f7d88b89939f"
    },
    "status": "ok",
    "message": "FSI retrieved successfully",
    "success": true
}
```

#### `GET /v1/history` — Daily FSI time series

**Parameters:**
- `component` (query, optional, string) — OFRFSI, Credit, Equity_Valuation, Funding, Flight_to_Safety, Volatility, US, AE Example: `OFRFSI`
- `days` (query, optional, string) — Days, max 2000 Example: `30`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/ofr-api/v1/history?component=OFRFSI&days=30"
```

**Response:**
```json
{
    "data": {
        "count": 30,
        "label": "OFR Financial Stress Index",
        "source": "U.S. Office of Financial Research",
        "history": [
            {
                "date": "2026-04-27",
                "value": -2.077
            },
            {
                "date": "2026-04-28",
                "value": -1.974
            },
            {
                "date": "2026-04-29",
                "value": -1.972
            },
            {
                "date": "2026-04-30",
                "value": -2.108
            },
            {
                "date": "2026-05-01",
                "value": -1.818
            },
            {
                "date": "2026-05-04",
                "value": -1.735
            },
            {
                "date": "2026-05-05",
                "value": -1.825
            },
            {
                "date": "2026-05-06",
                "value": -2.031
            },
            {
                "date": "2026-05-07",
                "value": -2.179
            },
            {
                "date": "2026-05-08",
                "value": -2.271
            },
            {
                "date": "2026-05-11",
                "value": -2.346
            },
            {
                "date": "2026-05-12",
                "value": -2.294
            },
            {
                "date": "2026-05-13",
                "value": -2.355
            },
            {
                "date": "2026-05-14",
 
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/regions` — US vs advanced-economy stress

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/ofr-api/v1/regions"
```

**Response:**
```json
{
    "data": {
        "date": "2026-06-05",
        "source": "U.S. Office of Financial Research",
        "regions": [
            {
                "label": "United States",
                "region": "US",
                "contribution": -1.085
            },
            {
                "label": "Other advanced economies",
                "region": "AE",
                "contribution": -0.8
            }
        ],
        "headline": -2.472
    },
    "meta": {
        "timestamp": "2026-06-09T20:24:25.593Z",
        "request_id": "36b47947-2dfa-4b67-81ad-56b16b4c2f3e"
    },
    "status": "ok",
    "message": "Regions retrieved successfully",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/ofr-api
OpenAPI spec: https://www.oanor.com/api/ofr-api/openapi.json