# NY Fed Reference Rates Scraper (`parseforge/nyfed-reference-rates-scraper`) Actor

Track the U.S. dollar benchmarks straight from the Federal Reserve Bank of New York. Pull SOFR, EFFR, OBFR, TGCR, and BGCR with effective date, percent rate, volume in billions, and percentile spread. Handy for treasury teams, rates traders, and funding market research.

- **URL**: https://apify.com/parseforge/nyfed-reference-rates-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Developer tools, Automation, Other
- **Stats:** 2 total users, 1 monthly users, 89.7% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $9.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true)

## 🏦 NY Fed Reference Rates Scraper

> 🚀 **Pull the benchmark rates that price trillions in dollar funding.** Get SOFR, EFFR, OBFR, TGCR, and BGCR straight from the Federal Reserve Bank of New York, with rate, volume, and the full percentile distribution for each day.

The Federal Reserve Bank of New York publishes the U.S. dollar reference rates that anchor floating rate loans, derivatives, and money market instruments. This Actor reads those rates directly from the NY Fed Markets API and returns one clean record per rate. You get the latest published value for every benchmark, or the recent daily history of a single rate, with no API key and no account required at the source.

Coverage spans the secured rates (SOFR, the Tri-Party General Collateral Rate, and the Broad General Collateral Rate), the unsecured rates (the Effective Federal Funds Rate and the Overnight Bank Funding Rate), and the SOFR Averages and Index used in many loan contracts. Each record carries the effective date, the published rate, the trading volume in billions of dollars, and the 1st, 25th, 75th, and 99th percentiles of the underlying transactions.

| 🎯 Target Audience | 💡 Primary Use Cases |
|---|---|
| Quant analysts and rates traders | Track SOFR and fed funds daily |
| Treasury and corporate finance teams | Reset floating rate loans and swaps |
| Fintech and lending platforms | Feed benchmark rates into pricing engines |
| Economists and researchers | Study funding markets and rate spreads |
| Risk and compliance teams | Document the rates used in valuations |

### 📋 What the NY Fed Reference Rates Scraper does

This Actor connects to the Federal Reserve Bank of New York Markets API and collects published reference rate observations. It runs in two modes, both auto-detected from your input:

- **Latest rates** returns the most recent published value for a group of benchmarks. Choose all rates, secured rates only, or unsecured rates only.
- **Single rate history** returns the recent daily observations for one rate type, for example the last 30 days of SOFR.

Every observation is normalized into a flat record with a human readable rate name, the effective date, the rate, the volume, and the percentile distribution. Rates that carry extra context, such as the federal funds target range on EFFR or the 30, 90, and 180 day averages on the SOFR Averages and Index, include those values too.

### 📊 Data fields

Each record includes: `effectiveDate`, `percentPercentile1`, `percentPercentile25`, `percentPercentile75`, `percentPercentile99`, `percentRate`, `rateName`, `results`, `scrapedAt`, `type`, `volumeInBillions`. These field names come straight from the actor's dataset schema, so what you see here is what lands in your dataset.

### 🚀 How to use

1. **Sign up.** Create a free Apify account using [this link](https://console.apify.com/sign-up?fpr=vmoqkp).
2. **Open the Actor.** Go to the NY Fed Reference Rates Scraper in the Apify Console.
3. **Set your input.** Choose a rate group for the latest snapshot, or pick a single rate type and a number of history days.
4. **Run it.** Click Start and watch the records arrive in the run log.
5. **Collect the data.** Open the dataset tab to view or pull the results through the API.

### 🔗 Recommended Actors

- [FRED Scraper](https://apify.com/parseforge/fred-scraper). Federal Reserve Economic Data series for thousands of economic indicators.
- [Federal Reserve H.15 Rates Scraper](https://apify.com/parseforge/federalreserve-h15-rates-scraper). The Fed H.15 selected interest rates release.
- [ECB FX Rates Scraper](https://apify.com/parseforge/ecb-fx-rates-scraper). European Central Bank euro foreign exchange reference rates.
- [SNB Swiss Rates Scraper](https://apify.com/parseforge/snb-swiss-rates-scraper). Swiss National Bank policy and money market rates.
- [US Treasury Fiscal Data Scraper](https://apify.com/parseforge/us-treasury-fiscal-data-scraper). Treasury fiscal datasets including rates and balances.

> 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge).

> **⚠️ Disclaimer:** independent tool, not affiliated with the Federal Reserve Bank of New York. Only publicly available data is collected.

### 🆘 Need Help?

If you hit a bug, have questions about setup, or need a scraper we haven't built yet, open our [contact form](https://tally.so/r/BzdKgA) or write to parseforge@protonmail.com. We also take on paid custom data projects.

For faster answers, join our [Discord](https://parseforge.co/discord). It's the best place to get support and suggest new actors.

# Actor input Schema

## `rateGroup` (type: `string`):

Which group of latest reference rates to pull. All returns SOFR, TGCR, BGCR, EFFR, OBFR and the SOFR Averages and Index. Secured returns SOFR, TGCR, BGCR. Unsecured returns EFFR, OBFR. Ignored when a specific rate type is selected below.

## `rateType` (type: `string`):

Select one rate type to pull its recent daily history instead of the latest snapshot. Leave empty to use the latest rates mode above.

## `historyDays` (type: `integer`):

How many of the most recent daily observations to pull when a single rate type is selected above. Ignored in latest rates mode.

## `maxItems` (type: `integer`):

How many rates to collect per run.

## Actor input object example

```json
{
  "rateGroup": "all",
  "rateType": "",
  "historyDays": 30,
  "maxItems": 10
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "historyDays": 30,
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/nyfed-reference-rates-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "historyDays": 30,
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/nyfed-reference-rates-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "historyDays": 30,
  "maxItems": 10
}' |
apify call parseforge/nyfed-reference-rates-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=parseforge/nyfed-reference-rates-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/1bbCU3csOXBnA5dOJ/builds/4sxNPgKYPu7FfWWXn/openapi.json