# US Treasury Yields & Interest Rates Scraper (`scrapemint/us-treasury-rates-scraper`) Actor Official US Treasury data, keyless: the daily yield curve (1-month to 30-year, with 2s10s spread and inversion flag), TIPS real yields, T-bill rates, auction results with bid-to-cover, average interest on US debt, and total public debt to the penny. - **URL**: https://apify.com/scrapemint/us-treasury-rates-scraper.md - **Developed by:** [Ken M](https://apify.com/scrapemint) (community) - **Categories:** Business, Education - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use 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 Yields & Interest Rates Scraper The official US Treasury interest-rate record, straight from government feeds: the daily yield curve, TIPS real yields, T-bill rates, auction results, average interest on the US debt, and the total public debt to the penny. No API key, no login, no browser. ### Datasets Pick one per run: - **Daily yield curve** - par yields for 1-month through 30-year maturities, one row per trading day, plus a computed **2s10s spread** and **curve inversion flag** (the classic recession signal). History back to 1990. - **Real yield curve (TIPS)** - inflation-adjusted 5Y-30Y yields. - **T-bill rates** - 4 to 52-week bill discount and coupon-equivalent rates. - **Long-term composite rates** - the 20-year-plus composite and real rate. - **Treasury auction results** - one row per auction: security type and term, offering size, total tendered and accepted, **bid-to-cover ratio**, high yield/discount rate, and the competitive/non-competitive/dealer/direct/indirect acceptance split. Announced-but-not-yet-held auctions appear with their terms and serve as an auction calendar. - **Average interest rates** - the average rate the US pays on each class of its debt, monthly. - **Total public debt** - the daily debt to the penny, split by public and intragovernmental holdings. ### Example ```json { "dataset": "yield_curve", "sinceDays": 365 } ```` One row per trading day, newest first: ```json { "date": "2026-07-17", "yield3Month": 3.85, "yield2Year": 4.18, "yield10Year": 4.55, "yield30Year": 5.06, "spread2y10y": 0.37, "curveInverted": false } ``` Set **sinceDays** to 0 for the full available history; rows stream newest first so **maxRows** keeps the recent end. ### Monitor mode Turn on **newOnly**, put the actor on a daily schedule, and each run emits only rows it has not returned before - fresh yields after each trading day, new auction results as they land. Runs where nothing new arrived cost nothing. ### Who uses this - **Finance teams and analysts**: the risk-free rate for DCF models, loan pricing and benchmarks, as a clean feed instead of a screenshot from treasury.gov. - **Fintech and dashboard builders**: yield curve and debt data without a data-vendor subscription. - **Business schools and econ courses**: real historical curve data for teaching, back to 1990. - **Macro researchers and journalists**: inversion history, auction demand (bid-to-cover) and debt growth in structured rows. Pairs with our Labor Statistics Scraper (BLS) for the inflation and jobs side of the macro picture, and our Stock Earnings Calendar for the equity side. ### Pricing A small fee per data row. Pulls that match nothing are free note rows, and the first 2 rows of every run are free. ### Notes - Sources: treasury.gov interest-rate XML feeds and the Treasury FiscalData API - both official, keyless US government data. - Yields are par yields in percent. Auction and debt amounts are in US dollars. - New yield-curve rows appear each business day around 6pm US Eastern time. # Actor input Schema ## `dataset` (type: `string`): Which official Treasury dataset to pull. Daily yield curve is the one most people want: par yields for 1-month through 30-year maturities, one row per trading day. ## `sinceDays` (type: `integer`): How far back to go, in days. 0 = full available history (the yield curve goes back to 1990; other datasets vary). Rows come newest first, so Max rows caps long pulls at the recent end. ## `newOnly` (type: `boolean`): Remember rows already returned and emit only ones not seen before. Run on a daily schedule for a clean feed of fresh yields, auctions or debt figures - quiet runs cost nothing. ## `maxRows` (type: `integer`): Stop after this many rows, newest first. ## Actor input object example ```json { "dataset": "yield_curve", "sinceDays": 90, "newOnly": false, "maxRows": 250 } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "dataset": "yield_curve", "sinceDays": 90 }; // Run the Actor and wait for it to finish const run = await client.actor("scrapemint/us-treasury-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "dataset": "yield_curve", "sinceDays": 90, } # Run the Actor and wait for it to finish run = client.actor("scrapemint/us-treasury-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 '{ "dataset": "yield_curve", "sinceDays": 90 }' | apify call scrapemint/us-treasury-rates-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapemint/us-treasury-rates-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "US Treasury Yields & Interest Rates Scraper", "description": "Official US Treasury data, keyless: the daily yield curve (1-month to 30-year, with 2s10s spread and inversion flag), TIPS real yields, T-bill rates, auction results with bid-to-cover, average interest on US debt, and total public debt to the penny.", "version": "0.1", "x-build-id": "zOR4dA5Rtxf3egYh2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapemint~us-treasury-rates-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapemint-us-treasury-rates-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapemint~us-treasury-rates-scraper/runs": { "post": { "operationId": "runs-sync-scrapemint-us-treasury-rates-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapemint~us-treasury-rates-scraper/run-sync": { "post": { "operationId": "run-sync-scrapemint-us-treasury-rates-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "dataset": { "title": "Dataset", "enum": [ "yield_curve", "real_yield_curve", "bill_rates", "long_term_rates", "avg_interest_rates", "auctions", "debt_to_penny" ], "type": "string", "description": "Which official Treasury dataset to pull. Daily yield curve is the one most people want: par yields for 1-month through 30-year maturities, one row per trading day.", "default": "yield_curve" }, "sinceDays": { "title": "History (days)", "minimum": 0, "maximum": 20000, "type": "integer", "description": "How far back to go, in days. 0 = full available history (the yield curve goes back to 1990; other datasets vary). Rows come newest first, so Max rows caps long pulls at the recent end.", "default": 90 }, "newOnly": { "title": "Monitor mode: new rows only", "type": "boolean", "description": "Remember rows already returned and emit only ones not seen before. Run on a daily schedule for a clean feed of fresh yields, auctions or debt figures - quiet runs cost nothing.", "default": false }, "maxRows": { "title": "Max rows", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stop after this many rows, newest first.", "default": 250 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```