Back to Claude Scientific Skills

Fiscal Statement Datasets — U.S. Treasury Fiscal Data

skills/usfiscaldata/references/datasets-fiscal.md

2.44.08.7 KB
Original Source

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

TableEndpointDescription
Operating Cash Balance/v1/accounting/dts/operating_cash_balanceTreasury General Account balance
Deposits & Withdrawals/v1/accounting/dts/deposits_withdrawals_operating_cashChanges to TGA
Public Debt Transactions/v1/accounting/dts/public_debt_transactionsIssues and redemptions of securities
Adjustment of Public Debt/v1/accounting/dts/adjustment_public_debt_transactions_cash_basisCash basis adjustments
Debt Subject to Limit/v1/accounting/dts/debt_subject_to_limitDebt vs. statutory limit
Inter-Agency Tax Transfers/v1/accounting/dts/inter_agency_tax_transfersIntra-government tax transfers
Federal Tax Deposits/v1/accounting/dts/federal_tax_depositsTax deposit activity
Short-Term Cash Investments/v1/accounting/dts/short_term_cash_investmentsCash investment activity
Income Tax Refunds Issued/v1/accounting/dts/income_tax_refunds_issuedTax refund issuances

Common DTS Fields

FieldTypeDescription
record_dateDATEBusiness date
account_typeSTRINGAccount/balance type
open_today_balCURRENCYOpening balance
open_month_balCURRENCYOpening month balance
open_fiscal_year_balCURRENCYOpening fiscal year balance
close_today_balCURRENCYClosing balance
transaction_today_amtCURRENCYToday's transaction amount
transaction_mtd_amtCURRENCYMonth-to-date amount
transaction_fytd_amtCURRENCYFiscal 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 18 data tables, all under /v1/accounting/mts/. Updated monthly.

Date Range: October 1980 to present

MTS Tables

EndpointDescription
/v1/accounting/mts/mts_table_1Summary of receipts, outlays, and deficit/surplus
/v1/accounting/mts/mts_table_2Summary of budget and off-budget results
/v1/accounting/mts/mts_table_3Summary of receipts and outlays
/v1/accounting/mts/mts_table_4Receipts of the U.S. Government
/v1/accounting/mts/mts_table_5Outlays of the U.S. Government
/v1/accounting/mts/mts_table_5mReceipts and outlays by month
/v1/accounting/mts/mts_table_6Means of financing the deficit or disposition of surplus
/v1/accounting/mts/mts_table_6aAnalysis of change in excess of liabilities
/v1/accounting/mts/mts_table_6bSecurities issued under special financing authorities
/v1/accounting/mts/mts_table_6cFederal agency borrowing via Treasury securities
/v1/accounting/mts/mts_table_6dInvestments of federal accounts in federal securities
/v1/accounting/mts/mts_table_6eGuaranteed and direct loan financing, net activity
/v1/accounting/mts/mts_table_7Receipts and outlays by month
/v1/accounting/mts/mts_table_8Trust fund impact on budget results and holdings
/v1/accounting/mts/mts_table_9Summary of receipts by source and outlays by function
/v1/accounting/mts/mts_table_9_outlays_functions_subfunctionsOutlays by function and subfunction
/v1/accounting/mts/mts_distributed_offsetting_receiptsDistributed offsetting receipts
/v1/accounting/mts/mts_receipts_outlays_deficit_surplusReceipts, outlays, and deficit/surplus

Common MTS Fields

FieldTypeDescription
record_dateDATEMonth end date
record_fiscal_yearSTRINGFiscal year (Oct–Sep)
record_fiscal_quarterSTRINGFiscal quarter (1–4)
classification_descSTRINGLine item description
classification_idSTRINGLine item code
parent_idSTRINGParent classification ID
current_month_gross_rcpt_amtCURRENCYCurrent month gross receipts
current_fytd_gross_rcpt_amtCURRENCYFiscal year-to-date gross receipts
prior_fytd_gross_rcpt_amtCURRENCYPrior 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: /v2/revenue/rcm
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: /v1/accounting/od/receipts_by_department
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. Endpoints use the /v1/accounting/tb/ prefix (not /v1/accounting/od/).

EndpointDescription
/v1/accounting/tb/esf1_balancesExchange Stabilization Fund balances
/v1/accounting/tb/esf2_statement_net_costESF statement of net cost
/v1/accounting/tb/fcp1_weekly_report_major_market_participantsMajor market participants (weekly)
/v1/accounting/tb/fcp2_monthly_report_major_market_participantsMajor market participants (monthly)
/v1/accounting/tb/fcp3_quarterly_report_large_market_participantsLarge market participants (quarterly)
/v1/accounting/tb/ffo5_internal_revenue_by_stateInternal revenue receipts by state
/v1/accounting/tb/ffo6_customs_border_protection_collectionsCustoms and border protection collections
/v1/accounting/tb/ofs1_distribution_federal_securities_class_investors_type_issuesDistribution of federal securities by class and investor
/v1/accounting/tb/ofs2_estimated_ownership_treasury_securitiesEstimated ownership of Treasury securities
/v1/accounting/tb/pdo1_offerings_regular_weekly_treasury_billsOfferings of regular weekly Treasury bills
/v1/accounting/tb/pdo2_offerings_marketable_securities_other_regular_weekly_treasury_billsOther marketable securities offerings
/v1/accounting/tb/uscc1_amounts_outstanding_circulationAmounts outstanding and in circulation
/v1/accounting/tb/uscc2_amounts_outstanding_circulationAmounts outstanding and in circulation (continued)