skills/claude-scientific-skills
1
0
Fork 0
mirror of https://github.com/K-Dense-AI/claude-scientific-skills.git synced 2026-03-27 07:09:27 +08:00
Code Issues Packages Projects Releases Wiki Activity

Add support for FiscalData.treasury.gov

Browse Source
This commit is contained in:
Timothy Kassis
2026-02-23 13:20:34 -08:00
parent 0ffa12a0e2
commit 86b5d1d30b
12 changed files with 1605 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

196
scientific-skills/usfiscaldata/references/datasets-fiscal.md Normal file
View File

@@ -0,0 +1,196 @@
# Fiscal Statement Datasets — U.S. Treasury Fiscal Data
## Daily Treasury Statement (DTS)
The DTS dataset has **9 data tables**, all under `/v1/accounting/dts/`. Updated daily (business days).
**Date Range:** October 2005 to present
### DTS Tables
| Table | Endpoint | Description |
|-------|----------|-------------|
| Operating Cash Balance | `/v1/accounting/dts/operating_cash_balance` | Treasury General Account balance |
| Deposits & Withdrawals | `/v1/accounting/dts/deposits_withdrawals_operating_cash` | Changes to TGA |
| Public Debt Transactions | `/v1/accounting/dts/public_debt_transactions` | Issues and redemptions of securities |
| Adjustment of Public Debt | `/v1/accounting/dts/adjustment_public_debt_transactions_cash_basis` | Cash basis adjustments |
| Debt Subject to Limit | `/v1/accounting/dts/debt_subject_to_limit` | Debt vs. statutory limit |
| Inter-Agency Tax Transfers | `/v1/accounting/dts/inter_agency_tax_transfers` | Intra-government tax transfers |
| Federal Tax Deposits | `/v1/accounting/dts/federal_tax_deposits` | Tax deposit activity |
| Short-Term Cash Investments | `/v1/accounting/dts/short_term_cash_investments` | Cash investment activity |
| Income Tax Refunds Issued | `/v1/accounting/dts/income_tax_refunds_issued` | Tax refund issuances |
### Common DTS Fields
| Field | Type | Description |
|-------|------|-------------|
| `record_date` | DATE | Business date |
| `account_type` | STRING | Account/balance type |
| `open_today_bal` | CURRENCY | Opening balance |
| `open_month_bal` | CURRENCY | Opening month balance |
| `open_fiscal_year_bal` | CURRENCY | Opening fiscal year balance |
| `close_today_bal` | CURRENCY | Closing balance |
| `transaction_today_amt` | CURRENCY | Today's transaction amount |
| `transaction_mtd_amt` | CURRENCY | Month-to-date amount |
| `transaction_fytd_amt` | CURRENCY | Fiscal year-to-date amount |
```python
# Get current Treasury General Account (TGA) balance
resp = requests.get(
"https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v1/accounting/dts/operating_cash_balance",
params={"sort": "-record_date", "page[size]": 5}
)
for row in resp.json()["data"]:
print(f"{row['record_date']}: ${float(row['close_today_bal']):,.0f}M (closing balance)")
# Get deposits and withdrawals for a specific period
resp = requests.get(
"https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v1/accounting/dts/deposits_withdrawals_operating_cash",
params={
"filter": "record_date:gte:2024-01-01,record_date:lte:2024-01-31",
"sort": "record_date",
"page[size]": 1000
}
)
```
### Aggregation Example (DTS)
```python
# Get sum of today's transaction amounts by transaction type
resp = requests.get(
"https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v1/accounting/dts/deposits_withdrawals_operating_cash",
params={
"fields": "record_date,transaction_type,transaction_today_amt",
"filter": "record_date:eq:2024-01-15"
}
)
```
---
## Monthly Treasury Statement (MTS)
The MTS dataset has **16 data tables**, all under `/v1/accounting/mts/`. Updated monthly.
**Date Range:** October 1980 to present
### MTS Tables
| Table | Endpoint | Description |
|-------|----------|-------------|
| MTS Table 1 | `/v1/accounting/mts/mts_table_1` | Summary of Receipts and Outlays |
| MTS Table 2 | `/v1/accounting/mts/mts_table_2` | Receipts by Source |
| MTS Table 3 | `/v1/accounting/mts/mts_table_3` | Outlays by Function |
| MTS Table 4 | `/v1/accounting/mts/mts_table_4` | Outlays by Agency |
| MTS Table 5 | `/v1/accounting/mts/mts_table_5` | Outlays by Category |
| MTS Table 6 | `/v1/accounting/mts/mts_table_6` | Means of Financing |
| MTS Table 7 | `/v1/accounting/mts/mts_table_7` | Receipts by Source (Quarterly) |
| MTS Table 8 | `/v1/accounting/mts/mts_table_8` | Outlays by Function (Quarterly) |
| MTS Table 9 | `/v1/accounting/mts/mts_table_9` | Receipts: Comparative Summary |
| MTS Table 10 | `/v1/accounting/mts/mts_table_10` | Outlays: Comparative Summary |
| MTS Table 11 | `/v1/accounting/mts/mts_table_11` | Supplemental Detail on Receipts |
| MTS Table 12 | `/v1/accounting/mts/mts_table_12` | Supplemental Detail on Outlays |
| MTS Table 13 | `/v1/accounting/mts/mts_table_13` | Federal Borrowing and Debt |
| MTS Table 14 | `/v1/accounting/mts/mts_table_14` | Means of Financing: Federal |
| MTS Table 15 | `/v1/accounting/mts/mts_table_15` | Federal Trust Fund Summary |
| MTS Table 16 | `/v1/accounting/mts/mts_table_16` | Means of Financing: Off-Budget |
### Common MTS Fields
| Field | Type | Description |
|-------|------|-------------|
| `record_date` | DATE | Month end date |
| `record_fiscal_year` | STRING | Fiscal year (Oct–Sep) |
| `record_fiscal_quarter` | STRING | Fiscal quarter (1–4) |
| `classification_desc` | STRING | Line item description |
| `classification_id` | STRING | Line item code |
| `parent_id` | STRING | Parent classification ID |
| `current_month_gross_rcpt_amt` | CURRENCY | Current month gross receipts |
| `current_fytd_gross_rcpt_amt` | CURRENCY | Fiscal year-to-date gross receipts |
| `prior_fytd_gross_rcpt_amt` | CURRENCY | Prior year fiscal-year-to-date |
```python
# MTS Table 1: Summary of receipts and outlays
resp = requests.get(
"https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v1/accounting/mts/mts_table_1",
params={
"filter": "record_fiscal_year:eq:2024",
"sort": "record_date"
}
)
df = pd.DataFrame(resp.json()["data"])
# MTS Table 9: Get line 120 (Total Receipts) for most recent period
resp = requests.get(
"https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v1/accounting/mts/mts_table_9",
params={
"filter": "line_code_nbr:eq:120",
"sort": "-record_date",
"page[size]": 1
}
)
```
---
## U.S. Government Revenue Collections
**Endpoint:** `/v1/accounting/od/rev_collections`
**Frequency:** Daily
**Date Range:** October 2004 to present
Daily tax and non-tax revenue collections.
---
## Financial Report of the U.S. Government
**Endpoint:** (8 tables)
**Frequency:** Annual
**Date Range:** September 1995 to present (FY2024 latest)
Annual audited financial statements. Includes:
- Balance sheets
- Statement of net cost
- Statement of operations
- Statement of changes in net position
---
## Monthly Treasury Disbursements
**Frequency:** Monthly
**Date Range:** October 2013 to present
Monthly federal disbursements data.
---
## Receipts by Department
**Endpoint:** `/v2/accounting/od/receipts_by_dept`
**Frequency:** Annual
**Date Range:** September 2015 to present
Annual breakdown of federal receipts by department.
---
## Treasury Managed Accounts
**Frequency:** Quarterly
**Date Range:** December 2022 to present (3 data tables)
Treasury-managed trust and special funds account data.
---
## Treasury Bulletin
**Frequency:** Quarterly
**Date Range:** March 2021 to present (13 tables)
Quarterly financial report covering government finances, public debt, savings bonds, and more.
**Endpoint prefix:** `/v1/accounting/od/treasury_bulletin_`