OFR Hedge Fund Monitor API
Free, open REST API from the U.S. Office of Financial Research (OFR) providing aggregated hedge fund time series data. No API key or registration required.
Base URL: https://data.financialresearch.gov/hf/v1
When to Use This Skill
- Aggregate hedge-fund size, leverage, liquidity, counterparty, or stress-test statistics (SEC Form PF via OFR)
- CFTC Traders in Financial Futures positioning, FICC sponsored-repo volumes, or FRB SCOOS dealer-financing terms
- Systemic-risk or financial-stability research that needs these series as clean time series
Does NOT Trigger
| Scenario |
Use Instead |
| A single filer's raw Form PF/13F/13D documents or holdings line by line |
alterlab-edgartools |
| Treasury yields, Fed policy rates, or financial-conditions indices |
alterlab-fred |
| Treasury debt, auctions, or Daily Treasury Statement cash balances |
alterlab-usfiscaldata |
| Security prices or fund NAV/price histories |
alterlab-alpha-vantage |
Hand-off rule. When the request matches a row above, open your answer by naming that skill by its exact id (for example alterlab-edgartools) and saying in one line why it fits better, then stop applying this skill's procedure. Name it even when you also need to ask for missing input. If only part of the request is out of scope, name the skill for that part and do only the in-scope part. A brief general pointer is fine; the named skill does the work.
Quick Start
import requests
import pandas as pd
BASE = "https://data.financialresearch.gov/hf/v1"
# List all available datasets
resp = requests.get(f"{BASE}/series/dataset")
datasets = resp.json()
# Returns: {"ficc": {...}, "fpf": {...}, "scoos": {...}, "tff": {...}}
# Search for series by keyword
resp = requests.get(f"{BASE}/metadata/search", params={"query": "*leverage*"})
results = resp.json()
# Each result: {mnemonic, dataset, field, value, type}
# Fetch a single time series
resp = requests.get(f"{BASE}/series/timeseries", params={
"mnemonic": "FPF-STRATEGY_EQUITY_LEVERAGERATIO_GAVWMEAN",
"start_date": "2015-01-01"
})
series = resp.json() # [[date, value], ...]
df = pd.DataFrame(series, columns=["date", "value"])
df["date"] = pd.to_datetime(df["date"])
Mnemonics are exact — guessing fails. The API rejects unknown identifiers with a plain
Invalid mnemonic string (HTTP 200, not JSON). Always discover real mnemonics via
/metadata/search or /metadata/mnemonics before requesting data. Note in particular that
there is no FPF-ALLQHF_LEVERAGERATIO_* series: aggregate leverage is published per
gross-asset cohort (see below), while the GAVWMEAN/NAVWMEAN asset-weighted leverage means
exist only at the strategy level.
Authentication
None required. The API is fully open and free.
Say how it was retrieved. End every answer with a short "How this was retrieved" line: the
endpoint URL with its parameters (e.g. /series/multifull?mnemonics=…&start_date=2015-01-01),
the dataset and its cadence (e.g. SEC Form PF, quarterly), that no API key or registration is
needed, and the retrieval date. In a paper, cite the OFR Hedge Fund Monitor, the dataset, the
mnemonic and the retrieval date of every series used.
Datasets
| Key |
Dataset |
Update Frequency |
fpf |
SEC Form PF — aggregated stats from qualifying hedge fund filings |
Quarterly |
tff |
CFTC Traders in Financial Futures — futures market positioning |
Monthly |
scoos |
FRB Senior Credit Officer Opinion Survey on Dealer Financing Terms |
Quarterly |
ficc |
FICC Sponsored Repo Service Volumes |
Daily |
The /series/dataset index returns long_name: "FormPF" for every dataset (an upstream API
label quirk); the real source names are above. Confirm a series' true cadence via
schedule/observation_frequency in its metadata.
Data Categories
The HFM organizes data into six categories (each downloadable as CSV):
- size — Hedge fund industry size (AUM, count of funds, net/gross assets)
- leverage — Leverage ratios, borrowing, gross notional exposure
- counterparties — Counterparty concentration, prime broker lending
- liquidity — Financing maturity, investor redemption terms, portfolio liquidity
- complexity — Open positions, strategy distribution, asset class exposure
- risk_management — Stress test results (CDS, equity, rates, FX scenarios)
Core Endpoints
Metadata
| Endpoint |
Path |
Description |
| List mnemonics |
GET /metadata/mnemonics |
All series identifiers |
| Query series info |
GET /metadata/query?mnemonic= |
Full metadata for one series |
| Search series |
GET /metadata/search?query= |
Text search with wildcards (*, ?) |
Series Data
| Endpoint |
Path |
Description |
| Single timeseries |
GET /series/timeseries?mnemonic= |
Date/value pairs for one series |
| Full single |
GET /series/full?mnemonic= |
Data + metadata for one series |
| Multi full |
GET /series/multifull?mnemonics=A,B |
Data + metadata for multiple series |
| Dataset |
GET /series/dataset?dataset=fpf |
All series in a dataset |
| Category CSV |
GET /categories?category=leverage |
CSV download for a category (returned HTTP 502 when checked on 2026-09-23; fall back to /series/multifull) |
| Spread |
GET /calc/spread?x=MNE1&y=MNE2 |
Difference between two series |
Common Parameters
| Parameter |
Description |
Example |
start_date |
Start date YYYY-MM-DD |
2020-01-01 |
end_date |
End date YYYY-MM-DD |
2024-12-31 |
periodicity |
Resample frequency |
Q, M, A, D, W |
how |
Aggregation method |
last (default), first, mean, median, sum |
remove_nulls |
Drop null values |
true |
time_format |
Date format |
date (YYYY-MM-DD) or ms (epoch ms) |
Key FPF Mnemonic Patterns
Mnemonics follow the pattern FPF-{SCOPE}_{METRIC}_{STAT}:
- Scope:
ALLQHF (all qualifying hedge funds), or a strategy such as STRATEGY_CREDIT,
STRATEGY_EQUITY, STRATEGY_MACRO, STRATEGY_RV (relative value), STRATEGY_FUTURES, etc.
ALLQHF leverage/cash metrics carry a gross-asset cohort segment: GAVN10 (10 largest funds),
GAVN11TO50, GAVN51 (rest).
- Metrics:
GAV (gross assets), NAV (net assets), GNE (gross notional exposure),
LEVERAGERATIO, CASHRATIO, COUNT, plus stress-test scenarios (CDSUP250BPS, etc.)
- Stats:
SUM, AVERAGE (equal-weighted, used for ALLQHF cohorts), GAVWMEAN/NAVWMEAN
(asset-weighted, strategy-level only), P5, P50, P95, PCTCHANGE
# Verified series examples (all return data as of 2026)
mnemonics = [
"FPF-ALLQHF_GAVN10_LEVERAGERATIO_AVERAGE", # 10 largest funds: leverage (equal-weighted)
"FPF-STRATEGY_EQUITY_LEVERAGERATIO_GAVWMEAN", # Equity strategy: leverage (GAV-weighted)
"FPF-ALLQHF_GAV_SUM", # All funds: gross assets (total $)
"FPF-ALLQHF_NAV_SUM", # All funds: net assets (total $)
"FPF-ALLQHF_GNE_SUM", # All funds: gross notional exposure
"FICC-SPONSORED_REPO_VOL", # FICC: sponsored repo volume (daily)
]
Reference Files
- references/api-overview.md — Base URL, versioning, protocols, response format
- references/endpoints-metadata.md — Mnemonics, query, and search endpoints with full parameter details
- references/endpoints-series-data.md — Timeseries, spread, and full data endpoints
- references/endpoints-combined.md — Full, multifull, dataset, and category endpoints
- references/datasets.md — Dataset descriptions (fpf, tff, scoos, ficc) and dataset-specific notes
- references/parameters.md — Complete parameter reference with periodicity codes, how values
- references/examples.md — Python examples: discovery, bulk download, spread analysis, DataFrame workflows
Part of the AlterLab Academic Skills suite.
1---2name: alterlab-hedgefund-monitor3description: Queries the OFR (Office of Financial Research) Hedge Fund Monitor API for time series on hedge fund size, leverage, counterparties, liquidity, complexity, and risk management, including SEC Form PF aggregated statistics, CFTC Traders in Financial Futures, FICC Sponsored Repo volumes, and FRB SCOOS dealer financing terms (no API key or registration required). Use when working with hedge fund data, systemic risk monitoring, financial stability research, hedge fund leverage or leverage ratios, counterparty concentration, Form PF statistics, repo market data, or OFR financial research data. Part of the AlterLab Academic Skills suite.4license: MIT5allowed-tools: Read Write WebFetch Bash(curl:*) Bash(python:*) Bash(uv run:*)6compatibility: No API key or registration required. Queries the open OFR Hedge Fund Monitor REST API; needs network access.7metadata:8 source: https://skillmd.com/skills/alterlab-ieu/alterlab-hedgefund-monitor9 skill-author: AlterLab10 version: "1.1.2"11 last_updated: "2026-11-04"12---1314# OFR Hedge Fund Monitor API1516Free, open REST API from the U.S. Office of Financial Research (OFR) providing aggregated hedge fund time series data. No API key or registration required.1718**Base URL:** `https://data.financialresearch.gov/hf/v1`1920## When to Use This Skill2122- Aggregate hedge-fund size, leverage, liquidity, counterparty, or stress-test statistics (SEC Form PF via OFR)23- CFTC Traders in Financial Futures positioning, FICC sponsored-repo volumes, or FRB SCOOS dealer-financing terms24- Systemic-risk or financial-stability research that needs these series as clean time series2526### Does NOT Trigger2728| Scenario | Use Instead |29|----------|-------------|30| A single filer's raw Form PF/13F/13D documents or holdings line by line | `alterlab-edgartools` |31| Treasury yields, Fed policy rates, or financial-conditions indices | `alterlab-fred` |32| Treasury debt, auctions, or Daily Treasury Statement cash balances | `alterlab-usfiscaldata` |33| Security prices or fund NAV/price histories | `alterlab-alpha-vantage` |3435**Hand-off rule.** When the request matches a row above, open your answer by naming that skill by its exact id (for example `alterlab-edgartools`) and saying in one line why it fits better, then stop applying this skill's procedure. Name it even when you also need to ask for missing input. If only part of the request is out of scope, name the skill for that part and do only the in-scope part. A brief general pointer is fine; the named skill does the work.3637## Quick Start3839```python40import requests41import pandas as pd4243BASE = "https://data.financialresearch.gov/hf/v1"4445# List all available datasets46resp = requests.get(f"{BASE}/series/dataset")47datasets = resp.json()48# Returns: {"ficc": {...}, "fpf": {...}, "scoos": {...}, "tff": {...}}4950# Search for series by keyword51resp = requests.get(f"{BASE}/metadata/search", params={"query": "*leverage*"})52results = resp.json()53# Each result: {mnemonic, dataset, field, value, type}5455# Fetch a single time series56resp = requests.get(f"{BASE}/series/timeseries", params={57 "mnemonic": "FPF-STRATEGY_EQUITY_LEVERAGERATIO_GAVWMEAN",58 "start_date": "2015-01-01"59})60series = resp.json() # [[date, value], ...]61df = pd.DataFrame(series, columns=["date", "value"])62df["date"] = pd.to_datetime(df["date"])63```6465**Mnemonics are exact — guessing fails.** The API rejects unknown identifiers with a plain66`Invalid mnemonic` string (HTTP 200, not JSON). Always discover real mnemonics via67`/metadata/search` or `/metadata/mnemonics` before requesting data. Note in particular that68there is **no** `FPF-ALLQHF_LEVERAGERATIO_*` series: aggregate leverage is published per69gross-asset cohort (see below), while the `GAVWMEAN`/`NAVWMEAN` asset-weighted leverage means70exist only at the strategy level.7172## Authentication7374None required. The API is fully open and free.7576**Say how it was retrieved.** End every answer with a short "How this was retrieved" line: the77endpoint URL with its parameters (e.g. `/series/multifull?mnemonics=…&start_date=2015-01-01`),78the dataset and its cadence (e.g. SEC Form PF, quarterly), that no API key or registration is79needed, and the retrieval date. In a paper, cite the OFR Hedge Fund Monitor, the dataset, the80mnemonic and the retrieval date of every series used.8182## Datasets8384| Key | Dataset | Update Frequency |85|-----|---------|-----------------|86| `fpf` | SEC Form PF — aggregated stats from qualifying hedge fund filings | Quarterly |87| `tff` | CFTC Traders in Financial Futures — futures market positioning | Monthly |88| `scoos` | FRB Senior Credit Officer Opinion Survey on Dealer Financing Terms | Quarterly |89| `ficc` | FICC Sponsored Repo Service Volumes | Daily |9091> The `/series/dataset` index returns `long_name: "FormPF"` for every dataset (an upstream API92> label quirk); the real source names are above. Confirm a series' true cadence via93> `schedule/observation_frequency` in its metadata.9495## Data Categories9697The HFM organizes data into six categories (each downloadable as CSV):98- **size** — Hedge fund industry size (AUM, count of funds, net/gross assets)99- **leverage** — Leverage ratios, borrowing, gross notional exposure100- **counterparties** — Counterparty concentration, prime broker lending101- **liquidity** — Financing maturity, investor redemption terms, portfolio liquidity102- **complexity** — Open positions, strategy distribution, asset class exposure103- **risk_management** — Stress test results (CDS, equity, rates, FX scenarios)104105## Core Endpoints106107### Metadata108109| Endpoint | Path | Description |110|----------|------|-------------|111| List mnemonics | `GET /metadata/mnemonics` | All series identifiers |112| Query series info | `GET /metadata/query?mnemonic=` | Full metadata for one series |113| Search series | `GET /metadata/search?query=` | Text search with wildcards (`*`, `?`) |114115### Series Data116117| Endpoint | Path | Description |118|----------|------|-------------|119| Single timeseries | `GET /series/timeseries?mnemonic=` | Date/value pairs for one series |120| Full single | `GET /series/full?mnemonic=` | Data + metadata for one series |121| Multi full | `GET /series/multifull?mnemonics=A,B` | Data + metadata for multiple series |122| Dataset | `GET /series/dataset?dataset=fpf` | All series in a dataset |123| Category CSV | `GET /categories?category=leverage` | CSV download for a category (returned HTTP 502 when checked on 2026-09-23; fall back to `/series/multifull`) |124| Spread | `GET /calc/spread?x=MNE1&y=MNE2` | Difference between two series |125126## Common Parameters127128| Parameter | Description | Example |129|-----------|-------------|---------|130| `start_date` | Start date YYYY-MM-DD | `2020-01-01` |131| `end_date` | End date YYYY-MM-DD | `2024-12-31` |132| `periodicity` | Resample frequency | `Q`, `M`, `A`, `D`, `W` |133| `how` | Aggregation method | `last` (default), `first`, `mean`, `median`, `sum` |134| `remove_nulls` | Drop null values | `true` |135| `time_format` | Date format | `date` (YYYY-MM-DD) or `ms` (epoch ms) |136137## Key FPF Mnemonic Patterns138139Mnemonics follow the pattern `FPF-{SCOPE}_{METRIC}_{STAT}`:140- Scope: `ALLQHF` (all qualifying hedge funds), or a strategy such as `STRATEGY_CREDIT`,141 `STRATEGY_EQUITY`, `STRATEGY_MACRO`, `STRATEGY_RV` (relative value), `STRATEGY_FUTURES`, etc.142 ALLQHF leverage/cash metrics carry a gross-asset cohort segment: `GAVN10` (10 largest funds),143 `GAVN11TO50`, `GAVN51` (rest).144- Metrics: `GAV` (gross assets), `NAV` (net assets), `GNE` (gross notional exposure),145 `LEVERAGERATIO`, `CASHRATIO`, `COUNT`, plus stress-test scenarios (`CDSUP250BPS`, etc.)146- Stats: `SUM`, `AVERAGE` (equal-weighted, used for ALLQHF cohorts), `GAVWMEAN`/`NAVWMEAN`147 (asset-weighted, strategy-level only), `P5`, `P50`, `P95`, `PCTCHANGE`148149```python150# Verified series examples (all return data as of 2026)151mnemonics = [152 "FPF-ALLQHF_GAVN10_LEVERAGERATIO_AVERAGE", # 10 largest funds: leverage (equal-weighted)153 "FPF-STRATEGY_EQUITY_LEVERAGERATIO_GAVWMEAN", # Equity strategy: leverage (GAV-weighted)154 "FPF-ALLQHF_GAV_SUM", # All funds: gross assets (total $)155 "FPF-ALLQHF_NAV_SUM", # All funds: net assets (total $)156 "FPF-ALLQHF_GNE_SUM", # All funds: gross notional exposure157 "FICC-SPONSORED_REPO_VOL", # FICC: sponsored repo volume (daily)158]159```160161## Reference Files162163- **[references/api-overview.md](references/api-overview.md)** — Base URL, versioning, protocols, response format164- **[references/endpoints-metadata.md](references/endpoints-metadata.md)** — Mnemonics, query, and search endpoints with full parameter details165- **[references/endpoints-series-data.md](references/endpoints-series-data.md)** — Timeseries, spread, and full data endpoints166- **[references/endpoints-combined.md](references/endpoints-combined.md)** — Full, multifull, dataset, and category endpoints167- **[references/datasets.md](references/datasets.md)** — Dataset descriptions (fpf, tff, scoos, ficc) and dataset-specific notes168- **[references/parameters.md](references/parameters.md)** — Complete parameter reference with periodicity codes, how values169- **[references/examples.md](references/examples.md)** — Python examples: discovery, bulk download, spread analysis, DataFrame workflows170171Part of the AlterLab Academic Skills suite.