Skip to content

foryourhealth111-pixel/Vibe-Skills / bundled/skills/hedgefundmonitor

hedgefundmonitor

Verified

Query the OFR (Office of Financial Research) Hedge Fund Monitor API for hedge fund data including SEC Form PF aggregated statistics, CFTC Traders in Financial Futures, FICC Sponsored Repo volumes, and FRB SCOOS dealer financing terms. Access time series data on hedge fund size, leverage, counterparties, liquidity, complexity, and risk management. 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.

references/api-overview.md

View on GitHub
# API Overview

## Base URL & Versioning

```
https://data.financialresearch.gov/hf/v1
```

The API version (`v1`) is required in the URL path. Currently only v1 is available.

## Protocol & Format

- All requests use **HTTPS**
- All responses are **JSON** (except `/categories` which returns CSV)
- No authentication, API keys, or registration required
- No documented rate limits — data updates at most once per day; avoid hammering the API

## Response Patterns

Most endpoints return one of:
- An **array of `[date, value]` pairs** for time series data
- A **JSON object keyed by mnemonic** for full series (timeseries + metadata)
- A **JSON array of objects** for search/metadata listings

### Timeseries array

```json
[
  ["2013-03-31", -3.0],
  ["2013-06-30", -2.0],
  ["2013-09-30", -2.05]
]
```

Null values appear as `null` in the value position.

### Full series object

```json
{
  "FPF-ALLQHF_NAV_SUM": {
    "timeseries": {
      "aggregation": [["2013-03-31", 1143832916], ...]
    },
    "metadata": {
      "mnemonic": "FPF-ALLQHF_NAV_SUM",
      "description": {
        "name": "All funds: net assets (sum dollar value)",
        "description": "...",
        "notes": "...",
        "vintage_approach": "Current vintage, as of last update",
        "vintage": "",
        "subsetting": "None",
        "subtype": "None"
      },
      "schedule": {
        "observation_period": "Quarterly",
        "observation_frequency": "Quarterly",
        "seasonal_adjustment": "None",
        "start_date": "2013-03-31",
        "last_update": ""
      }
    }
  }
}
```

## Mnemonic Format

Mnemonics are unique identifiers for each time series. Format varies by dataset:

| Dataset | Pattern | Example |
|---------|---------|---------|
| fpf | `FPF-{SCOPE}_{METRIC}_{STAT}` | `FPF-ALLQHF_NAV_SUM` |
| ficc | `FICC-{SERIES}` | `FICC-SPONSORED_REPO_VOL` |
| tff | `TFF-{SERIES}` | `TFF-DLRINDEX_NET_SPEC` |
| scoos | `SCOOS-{SERIES}` | varies |

Mnemonics are **case-insensitive** in query parameters (the API normalizes to uppercase in responses).

## Subseries (label)

Each mnemonic can have multiple subseries labeled:
- `aggregation` — the main data series (always present, default returned)
- `disclosure_edits` — version of the data with certain values masked for disclosure protection

## Installation

```bash
uv add requests pandas
```

No dedicated Python client exists — use `requests` directly.
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall