claude-scientific-skills/scientific-skills/usfiscaldata/references/datasets-fiscal.md

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

# 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)

# 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

# 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_