foryourhealth111-pixel/Vibe-Skills / bundled/skills/hedgefundmonitor
hedgefundmonitor
VerifiedQuery 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.9 KB |
| references/api-overview.md | markdown | 2.4 KB |
| references/datasets.md | markdown | 5.7 KB |
| references/endpoints-combined.md | markdown | 5.7 KB |
| references/endpoints-metadata.md | markdown | 4.3 KB |
| references/endpoints-series-data.md | markdown | 3.6 KB |
| references/examples.md | markdown | 7.7 KB |
| references/parameters.md | markdown | 3.3 KB |
references/endpoints-metadata.md
View on GitHub# Metadata Endpoints
## 1. List Mnemonics — `/metadata/mnemonics`
**URL:** `GET https://data.financialresearch.gov/hf/v1/metadata/mnemonics`
Returns all series identifiers available through the API.
### Parameters
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `dataset` | string | No | Filter by dataset key: `fpf`, `tff`, `scoos`, `ficc` |
| `output` | string | No | `by_dataset` — returns a hash grouped by dataset |
### Examples
```python
import requests
BASE = "https://data.financialresearch.gov/hf/v1"
# All mnemonics (flat list)
resp = requests.get(f"{BASE}/metadata/mnemonics")
mnemonics = resp.json()
# Returns: ["FPF-ALLQHF_CDSDOWN250BPS_P5", "FPF-ALLQHF_CDSDOWN250BPS_P50", ...]
# Mnemonics for a single dataset with names
resp = requests.get(f"{BASE}/metadata/mnemonics", params={"dataset": "fpf"})
# Returns: [{"mnemonic": "FPF-ALLQHF_CDSDOWN250BPS_P5", "series_name": "Stress test: CDS spreads decrease 250 basis points net impact on NAV (5th percentile fund)"}, ...]
# All mnemonics grouped by dataset
resp = requests.get(f"{BASE}/metadata/mnemonics", params={"output": "by_dataset"})
grouped = resp.json()
# Returns: {"ficc": [{mnemonic, series_name}, ...], "fpf": [...], ...}
```
---
## 2. Single Series Query — `/metadata/query`
**URL:** `GET https://data.financialresearch.gov/hf/v1/metadata/query`
Returns full metadata for a single mnemonic.
### Parameters
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mnemonic` | string | **Yes** | The series mnemonic |
| `fields` | string | No | Comma-separated list of fields to retrieve. Use `/` to access subfields (e.g., `release/long_name`) |
### Metadata Fields
The metadata object includes these top-level fields (with subfields):
| Field | Subfields |
|-------|-----------|
| `mnemonic` | — |
| `description` | `name`, `description`, `notes`, `vintage_approach`, `vintage`, `subsetting`, `subtype` |
| `schedule` | `observation_period`, `observation_frequency`, `seasonal_adjustment`, `start_date`, `last_update` |
| `release` | `long_name`, `short_name`, and other release-level metadata |
### Examples
```python
# Full metadata
resp = requests.get(f"{BASE}/metadata/query", params={
"mnemonic": "fpf-allqhf_cdsup250bps_p5"
})
meta = resp.json()
print(meta["description"]["name"])
print(meta["schedule"]["start_date"])
print(meta["schedule"]["observation_frequency"])
# Specific subfield only
resp = requests.get(f"{BASE}/metadata/query", params={
"mnemonic": "fpf-allqhf_cdsup250bps_p5",
"fields": "release/long_name"
})
# Returns: {"release": {"long_name": "Hedge Fund Aggregated Statistics from SEC Form PF Filings"}}
# Multiple fields
resp = requests.get(f"{BASE}/metadata/query", params={
"mnemonic": "fpf-allqhf_cdsup250bps_p5",
"fields": "description/name,schedule/start_date,schedule/observation_frequency"
})
```
---
## 3. Series Search — `/metadata/search`
**URL:** `GET https://data.financialresearch.gov/hf/v1/metadata/search`
Full-text search across all metadata fields. Supports wildcards.
### Parameters
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | **Yes** | Search string. Supports `*` (multi-char wildcard) and `?` (single-char wildcard) |
### Response Fields
Each result object contains:
| Field | Description |
|-------|-------------|
| `mnemonic` | Series identifier (or `"none"` for dataset-level metadata) |
| `dataset` | Dataset key (`fpf`, `tff`, `scoos`, `ficc`) |
| `field` | Which metadata field matched (e.g., `description/name`) |
| `value` | The matched field value |
| `type` | Data type (`str`, etc.) |
### Examples
```python
# Find series containing "leverage" anywhere
resp = requests.get(f"{BASE}/metadata/search", params={"query": "*leverage*"})
results = resp.json()
for r in results:
print(r["mnemonic"], r["field"], r["value"])
# Find series starting with "Fund"
resp = requests.get(f"{BASE}/metadata/search", params={"query": "Fund*"})
# Find by exact dataset name
resp = requests.get(f"{BASE}/metadata/search", params={"query": "FICC*"})
# Search for stress test series
resp = requests.get(f"{BASE}/metadata/search", params={"query": "*stress*"})
# Get unique mnemonics from search results
results = resp.json()
mnemonics = list({r["mnemonic"] for r in results if r["mnemonic"] != "none"})
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |