# US Treasury Average Interest Rates — official Fiscal Data API,  (`pappy-dev/treasury-avg-interest-rates`) Actor

Monthly average interest rates on U.S. Treasury securities (Bills, Notes, Bonds, TIPS, and more — 22 types) via the Treasury's official public Fiscal Data API — no login, no API key. Query any security type and get every monthly rate on record. Official U.S. gov data, licensed for commercial reuse.

- **URL**: https://apify.com/pappy-dev/treasury-avg-interest-rates.md
- **Developed by:** [Backyard Tools](https://apify.com/pappy-dev) (community)
- **Categories:** Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$1.00 / 1,000 interest rate record scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#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

## US Treasury Average Interest Rates — official Fiscal Data API, no login

Monthly average interest rates on U.S. Treasury securities — Bills, Notes, Bonds, TIPS,
Floating Rate Notes, savings securities, and more (22 security types) — pulled from the
official **U.S. Department of the Treasury, Bureau of the Fiscal Service** public Fiscal
Data REST API (`api.fiscaldata.treasury.gov`). No account, no API key, no proxies.

The Fiscal Data license page states it plainly: "The data is offered free, without restriction,
and available to copy, adapt, redistribute, or otherwise use for non-commercial or commercial
purposes."

### Tested (2026-09-02)

| Security type | Records returned | Notes |
|---|---:|---|
| `Treasury Bills` | 307 total on file | monthly |
| `Treasury Inflation-Protected Securities (TIPS)` | 262 total on file | parentheses in the name work fine |
| Nonexistent security type | 0 | empty result, no error |

### Average interest rates on us treasury securities — input

```json
{
  "targets": ["Treasury Bills", "Treasury Notes"],
  "maxItems": 2000
}
```

Each target is a **security type** exactly as Treasury lists it (e.g. `Treasury Bills`,
`Treasury Notes`, `Treasury Bonds`, `Treasury Inflation-Protected Securities (TIPS)`,
`Treasury Floating Rate Notes (FRN)`, `Government Account Series`, `Total Marketable`,
`Total Non-marketable`). A security type with no matching records simply returns 0 items
for that target (no charge).

### Average interest rates on us treasury securities — output fields

One dataset item per monthly rate record:

| Field | |
|---|---|
| `security_type_desc` / `security_desc` | marketable vs. non-marketable, and the specific instrument |
| `avg_interest_rate_amt` | the official average interest rate for that month (percentage) |
| `record_date` | the reporting date |
| `record_fiscal_year` / `record_fiscal_quarter` | U.S. federal fiscal period |
| `record_calendar_year` / `record_calendar_quarter` / `record_calendar_month` / `record_calendar_day` | calendar period breakdown |
| `src_line_nbr` | Treasury's own source line number for the record |

No personal data: these are government accounting statistics by security type, not
individual transactions or people.

### Why this over Treasury's own website

fiscaldata.treasury.gov's UI is built for browsing one dataset at a time. This actor runs a
batch of security types in one call and hands back structured rows — for building rate-history
trackers, fixed-income research pipelines, or datasets that need this as data, not a web page.

### Use Cases

- **Rate-history tracking** — build a monthly time series of average interest rates by security type
- **Fixed-income benchmarking** — compare average rates across security types over time
- **Government accounting reference** — pull official average rates by fiscal period for reporting
- **Economic trend analysis** — correlate average Treasury rates with other macro indicators

### Pricing

Pay per event: **$1.00 per 1,000 interest-rate records** collected. Nothing else.

# Actor input Schema

## `targets` (type: `array`):

Treasury の公式表記で証券種別を指定（例: Treasury Bills, Treasury Notes, Treasury Bonds, Treasury Inflation-Protected Securities (TIPS), Treasury Floating Rate Notes (FRN), Government Account Series, Total Marketable, Total Non-marketable）。fiscaldata.treasury.gov の Average Interest Rates データセットで使われている表記と一致させる。複数指定可

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

1 run で取得する最大件数

## Actor input object example

```json
{
  "targets": [
    "Treasury Bills"
  ],
  "maxItems": 2000
}
```

# Actor output Schema

## `items` (type: `string`):

取得した各件（type=item）と、選択した分析の結果（type=analysis）

## `overview` (type: `string`):

件数・平均評点・期間・ネガティブ比率（下側信頼限界つき）

# 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 = {
    "targets": [
        "Treasury Bills"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("pappy-dev/treasury-avg-interest-rates").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 = { "targets": ["Treasury Bills"] }

# Run the Actor and wait for it to finish
run = client.actor("pappy-dev/treasury-avg-interest-rates").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "targets": [
    "Treasury Bills"
  ]
}' |
apify call pappy-dev/treasury-avg-interest-rates --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,pappy-dev/treasury-avg-interest-rates"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/jwX89kW2TbgCSH2kN/builds/agnbIzhAWbmcQh1Gf/openapi.json