# US Treasury Fiscal Data Scraper (`parseforge/us-treasury-fiscal-data-scraper`) Actor

Scrape US Treasury fiscal data including national debt totals, daily cash balances, interest rates, savings bond rates, and federal spending breakdowns. Filter by date range across 80+ datasets covering decades of financial history.

- **URL**: https://apify.com/parseforge/us-treasury-fiscal-data-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Developer tools, Automation, Other
- **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $6.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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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

![ParseForge Banner](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)

## 🏦 US Treasury Fiscal Data Scraper

Whether you're a financial analyst tracking national debt, an economist monitoring interest rates, or a researcher studying government revenue, this tool makes it easy to collect structured fiscal data from the U.S. Department of the Treasury.

> **The US Treasury Fiscal Data Scraper collects federal fiscal records including national debt figures, average interest rates, exchange rates, debt outstanding, state-level debt, revenue collections, and Treasury auction results. Filter by dataset and date range.**

### ✨ What Does It Do

- 💰 **National debt tracking** - collect daily "Debt to the Penny" figures showing total public debt and intragovernmental holdings
- 📈 **Interest rate data** - extract average interest rates on Treasury securities across different maturities
- 💱 **Exchange rates** - gather Treasury exchange rates for international currencies
- 🏛️ **Debt outstanding** - get detailed breakdowns of outstanding federal debt by security type
- 📊 **Revenue collections** - track federal tax revenue and collections data
- 🔨 **Treasury auctions** - collect auction results for government securities

### 🔧 Input

- **Dataset** - choose which Treasury dataset to collect (Debt to the Penny, Average Interest Rates, Rates of Exchange, Debt Outstanding, Top State Debt, Revenue Collections, or Treasury Auctions)
- **Max Items** - how many records to collect (free users get 10 items, paid users up to 1,000,000)
- **Date From** - optional start date filter in YYYY-MM-DD format
- **Date To** - optional end date filter in YYYY-MM-DD format

```json
{
    "dataset": "v2/accounting/od/debt_to_penny",
    "maxItems": 50,
    "dateFrom": "2024-01-01",
    "dateTo": "2024-12-31"
}
````

### 📊 Output

Each record includes data fields specific to the selected dataset. Download as JSON, CSV, or Excel.

| Field | Description |
|-------|-------------|
| 📅 record\_date | Date of the fiscal record |
| 💰 tot\_pub\_debt\_out\_amt | Total public debt outstanding (Debt to the Penny) |
| 📈 avg\_interest\_rate\_amt | Average interest rate (Interest Rates dataset) |
| 💱 exchange\_rate | Currency exchange rate (Rates of Exchange) |
| 🏛️ debt\_held\_public\_amt | Debt held by the public |
| 📊 net\_collections\_amt | Net revenue collections (Revenue dataset) |
| 🔨 security\_type | Type of Treasury security |
| 🕐 scrapedAt | Timestamp when the data was collected |

```json
{
    "record_date": "2024-12-31",
    "security_type_desc": "Treasury Bills",
    "avg_interest_rate_amt": 5.157,
    "src_line_nbr": 1,
    "record_fiscal_year": 2025,
    "record_fiscal_quarter": 1,
    "record_calendar_year": 2024,
    "record_calendar_quarter": 4,
    "record_calendar_month": 12,
    "record_calendar_day": 31,
    "scrapedAt": "2026-04-09T12:00:00.000Z"
}
```

### 💎 Why Choose the US Treasury Fiscal Data Scraper?

| Feature | Our Tool | Manual Treasury Website |
|---------|----------|------------------------|
| Batch collection | ✅ Up to 1M records | ❌ Browse one page at a time |
| Date filtering | ✅ Custom date ranges | ⚠️ Limited options |
| Multiple datasets | ✅ 7 datasets in one tool | ❌ Navigate each separately |
| Structured output | ✅ JSON, CSV, Excel | ❌ PDF reports only |
| Automated scheduling | ✅ Daily/weekly monitoring | ❌ Manual visits |
| Numeric parsing | ✅ Auto-converted to numbers | ❌ Raw text strings |

### 📋 How to Use

1. **Sign Up** - [Create a free account w/ $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp)
2. **Configure** - select the Treasury dataset and set optional date filters
3. **Run It** - click "Start" and get structured fiscal data in seconds

No coding, no setup, no manual browsing required.

### 🎯 Business Use Cases

- 📈 **Financial analysts** - track national debt levels and interest rate trends over time for investment research
- 🏦 **Banks and lenders** - monitor Treasury interest rates to inform lending and pricing decisions
- 💱 **Import/export businesses** - collect historical exchange rates for international trade calculations
- 📊 **Economists** - analyze federal revenue collections and debt patterns for economic research
- 🎓 **Academic researchers** - gather long-term fiscal data for studies on government finance and monetary policy
- 🏛️ **Policy organizations** - monitor debt growth, auction results, and state-level debt distributions

### 🔗 Integrate US Treasury Fiscal Data Scraper with any app

- [Make](https://docs.apify.com/platform/integrations/make) - Automate fiscal data monitoring workflows
- [Zapier](https://docs.apify.com/platform/integrations/zapier) - Get alerts when new Treasury data is published
- [Slack](https://docs.apify.com/platform/integrations/slack) - Get notified in your team channel
- [Google Drive](https://docs.apify.com/platform/integrations/drive) - Export fiscal data to spreadsheets
- [Webhooks](https://docs.apify.com/platform/integrations/webhooks) - Trigger actions when runs complete

### 💡 Recommended Actors

Looking for more government and financial data tools? Check out these related actors:

| Actor | Description | Link |
|-------|-------------|------|
| GSA eLibrary Scraper | Collect government contract data from GSA | [Link](https://apify.com/parseforge/gsa-elibrary-scraper) |
| FINRA BrokerCheck Scraper | Look up broker and advisor registration data | [Link](https://apify.com/parseforge/finra-brokercheck-scraper) |
| FAA Aircraft Registry Scraper | Extract aircraft registration records | [Link](https://apify.com/parseforge/faa-aircraft-registry-scraper) |
| Pitchbook Funds Scraper | Collect fund data from Pitchbook | [Link](https://apify.com/parseforge/pitchbook-funds-scraper) |
| Smart Apify Actor Scraper | Discover and analyze Apify marketplace actors | [Link](https://apify.com/parseforge/smart-apify-actor-scraper) |

**Pro Tip:** 💡 Browse our complete collection of [data collection actors](https://apify.com/parseforge) to find the perfect tool for your needs.

### 🆘 Need Help?

- Visit the [Apify documentation](https://docs.apify.com) for platform guides
- Contact us at [Tally contact form](https://tally.so/r/BzdKgA)

### ⚠️ Disclaimer

> This Actor is an independent tool and is not affiliated with, endorsed by, or connected to the U.S. Department of the Treasury, the U.S. government, or any federal agency. It accesses only publicly available data.

# Actor input Schema

## `dataset` (type: `string`):

Select the Treasury fiscal dataset to scrape

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

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000

## `dateFrom` (type: `string`):

Filter records from this date (YYYY-MM-DD format)

## `dateTo` (type: `string`):

Filter records up to this date (YYYY-MM-DD format)

## Actor input object example

```json
{
  "dataset": "v2/accounting/od/debt_to_penny",
  "maxItems": 10
}
```

# Actor output Schema

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

Overview

# 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 = {
    "dataset": "v2/accounting/od/debt_to_penny",
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/us-treasury-fiscal-data-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 = {
    "dataset": "v2/accounting/od/debt_to_penny",
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/us-treasury-fiscal-data-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": "v2/accounting/od/debt_to_penny",
  "maxItems": 10
}' |
apify call parseforge/us-treasury-fiscal-data-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "US Treasury Fiscal Data Scraper",
        "description": "Scrape US Treasury fiscal data including national debt totals, daily cash balances, interest rates, savings bond rates, and federal spending breakdowns. Filter by date range across 80+ datasets covering decades of financial history.",
        "version": "0.0",
        "x-build-id": "F3hwnVtQz8J9Nh6bb"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/parseforge~us-treasury-fiscal-data-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-parseforge-us-treasury-fiscal-data-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/parseforge~us-treasury-fiscal-data-scraper/runs": {
            "post": {
                "operationId": "runs-sync-parseforge-us-treasury-fiscal-data-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/parseforge~us-treasury-fiscal-data-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-parseforge-us-treasury-fiscal-data-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",
                "required": [
                    "dataset"
                ],
                "properties": {
                    "dataset": {
                        "title": "Dataset",
                        "enum": [
                            "v2/accounting/od/debt_to_penny",
                            "v2/accounting/od/avg_interest_rates",
                            "v1/accounting/od/rates_of_exchange",
                            "v2/accounting/od/debt_outstanding",
                            "v1/debt/top/top_state",
                            "v2/revenue/rcm",
                            "v2/accounting/od/auctions_query"
                        ],
                        "type": "string",
                        "description": "Select the Treasury fiscal dataset to scrape"
                    },
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
                    },
                    "dateFrom": {
                        "title": "Date From",
                        "type": "string",
                        "description": "Filter records from this date (YYYY-MM-DD format)"
                    },
                    "dateTo": {
                        "title": "Date To",
                        "type": "string",
                        "description": "Filter records up to this date (YYYY-MM-DD format)"
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```