svemagie/Substrate
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
Substrate/Data/sources/DS-00010—Treasury_FiscalData/source.md

12 KiB
Raw Permalink Blame History

Treasury FiscalData - Federal Fiscal Statistics

Source ID: DS-00010 Record Created: 2025-12-01 Last Updated: 2025-12-01 Cataloger: DM-001 Review Status: Initial Entry

Bibliographic Information

Title Statement

  • Main Title: FiscalData - U.S. Treasury Department Open Data
  • Subtitle: Federal Government Fiscal Information
  • Abbreviated Title: FiscalData, Treasury Data
  • Variant Titles: Treasury Open Data, USAspending fiscal data

Responsibility Statement

  • Publisher/Issuing Body: U.S. Department of the Treasury
  • Department/Division: Bureau of the Fiscal Service
  • Contributors: Office of Management and Budget (OMB), Congressional Budget Office (CBO)
  • Contact Information: https://fiscaldata.treasury.gov/contact-us/

Publication Information

  • Place of Publication: Washington, D.C., United States
  • Date of First Publication: 2019 (FiscalData portal); Treasury data collection since 1789
  • Publication Frequency: Daily (debt), Monthly (budget), Annual (comprehensive)
  • Current Status: Active

Edition/Version Information

  • Current Version: FiscalData API v2
  • Version History: Launched 2019, major updates 2020, 2023
  • Versioning Scheme: RESTful API with versioned endpoints

Authority Statement

Organizational Authority

Issuing Organization Analysis:

  • Official Name: U.S. Department of the Treasury
  • Type: Cabinet-level federal executive department
  • Established: 1789 (one of the oldest federal agencies)
  • Mandate: Manage federal finances, collect revenue, pay bills, manage government debt
  • Parent Organization: Executive Branch of U.S. Federal Government
  • Governance Structure: Secretary of the Treasury (Cabinet position)

Domain Authority:

  • Subject Expertise: 235+ years of federal financial management
  • Recognition: THE authoritative source for U.S. federal fiscal data; no alternative
  • Publication History: Daily Treasury Statement (1970s-present), Monthly Treasury Statement, Treasury Bulletins
  • Peer Recognition: Used by Congressional Budget Office, Federal Reserve, Wall Street, international institutions

Quality Oversight:

  • Peer Review: Internal audit processes; GAO oversight
  • Editorial Board: Bureau of the Fiscal Service
  • External Audit: Government Accountability Office (GAO), Treasury Inspector General
  • Certification: Federal accounting standards (FASAB); GAAP for government

Independence Assessment:

  • Funding Model: Federal appropriations
  • Political Independence: Data collection is administrative (not discretionary); political leadership cannot alter debt figures
  • Commercial Interests: None; constitutional obligation to report
  • Transparency: Legal requirement to publish debt, receipts, expenditures

Data Authority

Provenance Classification:

  • Source Type: Primary (Treasury is the source; not aggregation)
  • Data Origin: Treasury's own financial operations, tax collections, debt issuance
  • Chain of Custody: Treasury operations → Financial systems → Publication

Primary Source Characteristics:

  • Direct administrative data from Treasury operations
  • Legal requirement to maintain accurate records
  • Audited financial statements
  • Real-time debt tracking from Treasury securities operations

Scope Note

Content Description

Subject Coverage:

  • Primary Subjects: Federal debt, federal budget, government receipts, government spending
  • Secondary Subjects: Treasury securities, interest payments, fiscal policy indicators
  • Subject Classification:
    • LC: HJ (Public Finance), HG (Finance)
    • Dewey: 336 (Public Finance), 351.72 (Government Budgets)
  • Keywords: National debt, federal deficit, government spending, tax revenue, Treasury bonds, fiscal policy

Geographic Coverage:

  • Spatial Scope: United States federal government (national only)
  • Geographic Granularity: National (federal government only; state/local separate)
  • Coverage Completeness: 100% of federal fiscal operations
  • Notable Exclusions: State/local government debt (separate sources); Federal Reserve balance sheet

Temporal Coverage:

  • Start Date: Various; debt data to 1790s; modern format from 1970s
  • End Date: Present (daily updates for debt)
  • Historical Depth: 230+ years for some series
  • Frequency of Observations: Daily (debt), Monthly (budget statements), Annual (comprehensive)
  • Time Series Continuity: Excellent; methodology changes documented

Variables/Indicators:

Core Indicators for US-Common-Metrics:

  • Total Public Debt Outstanding - Total federal debt (daily)
  • Debt Held by the Public - Marketable Treasury securities held outside government
  • Intragovernmental Holdings - Debt held by government accounts (Social Security, etc.)
  • Monthly Treasury Statement Receipts - Federal tax/revenue collections
  • Monthly Treasury Statement Outlays - Federal government spending
  • Budget Deficit/Surplus - Receipts minus outlays

Access Conditions

Technical Access

API Information:

Authentication:

  • Authentication Required: No (public API)
  • Registration Process: None required
  • Approval Required: No

Rate Limits:

  • Rate Limiting: Reasonable use policy (no strict limits published)
  • Throttling Policy: May throttle excessive requests
  • Recommendation: Implement caching; batch requests where possible

Query Capabilities:

  • Filtering: By date, field values, record type
  • Sorting: By any field (ascending/descending)
  • Pagination: Supported (page[size], page[number])
  • Aggregation: Limited built-in aggregation

Data Formats:

  • Available Formats: JSON, CSV, XML
  • Format Quality: Well-structured, validated
  • Encoding: UTF-8

Download Options:

  • Bulk Download: CSV exports available for full datasets
  • API Access: Recommended for programmatic access
  • Direct Downloads: Available via FiscalData portal

Legal/Policy Access

License:

Usage Rights:

  • Redistribution Allowed: Yes
  • Commercial Use Allowed: Yes
  • Modification Allowed: Yes
  • Attribution Required: Recommended ("Source: U.S. Department of the Treasury")

Cost Structure:

  • Access Cost: Free

Collection Development Policy Fit

Relevance Assessment

Substrate Mission Alignment:

  • Human Progress Focus: Federal fiscal health affects all Americans; debt levels impact future generations
  • Problem-Solution Connection:
    • Links to Problems: National debt burden, deficit spending, fiscal sustainability
    • Links to Solutions: Fiscal policy reforms, spending prioritization, revenue policy
  • Evidence Quality: Authoritative source; legally mandated reporting; audited

Collection Priorities Match:

  • Priority Level: HIGH - essential for government/fiscal category
  • Uniqueness: Only authoritative source for federal debt and budget data
  • Comprehensiveness: Fills critical gap for fiscal metrics in US-Common-Metrics

Source Evaluation Narrative

Methodological Assessment

Data Collection Methodology:

  • Administrative Records: Direct recording of Treasury operations
  • Completeness: 100% - all federal fiscal transactions recorded
  • Validation: Internal controls, GAO audit, reconciliation with Fed records
  • Timeliness: Daily updates for debt; monthly for budget statements

Error Characteristics:

  • Measurement Error: Minimal (administrative data, not surveys)
  • Known Issues: Accounting treatments may change (documented); timing differences between cash and accrual
  • Revisions: Some figures revised as transactions settle

Currency Assessment

Update Characteristics:

  • Debt Data: Daily (by 6 PM ET)
  • Monthly Treasury Statement: ~8th business day of following month
  • Deficit/Surplus: Monthly with annual final
  • Reliability: Highly consistent; legal obligation to publish

Objectivity Assessment

Potential Biases:

  • Political Bias: Data is administrative (not discretionary); political leadership cannot alter figures
  • Presentation Bias: Different administrations may emphasize different metrics, but underlying data unchanged
  • Transparency: All data publicly available; methodology documented

Reliability Assessment

Consistency:

  • Internal Consistency: Reconciled with Federal Reserve, CBO figures
  • Temporal Consistency: Long time series with consistent definitions
  • Cross-source Consistency: Matches Fed Z.1 Financial Accounts, CBO estimates

Accuracy Assessment

Validation Evidence:

  • GAO Audit: Annual audit of Treasury financial statements
  • Reconciliation: Daily reconciliation with Federal Reserve
  • Error Rate: Minimal for administrative data

Known Limitations and Caveats

Coverage Limitations

What's NOT Included:

  • State and local government debt (separate sources)
  • Federal Reserve balance sheet (separate from Treasury debt)
  • Off-budget items (some military, emergency spending may be tracked differently)
  • Unfunded liabilities (Social Security, Medicare future obligations not counted as debt)

Temporal Gaps:

  • Historical data format varies; modern APIs cover recent decades
  • Some older data requires accessing archived reports

Methodological Limitations

Accounting Treatments:

  • Cash basis vs. accrual basis (MTS is cash; some reports accrual)
  • Intragovernmental holdings (Social Security surplus) counted differently
  • Debt ceiling periods may cause unusual timing patterns

Interpretation Cautions:

  • "Debt ceiling" periods create artificial constraints/timing issues
  • Debt-to-GDP ratio requires GDP from separate source (BEA)
  • Nominal vs. inflation-adjusted comparisons require CPI data

How to Use Responsibly

  1. Debt figures: Total Public Debt Outstanding is headline number
  2. Debt Held by Public: Better measure of government's market borrowing
  3. Deficit: Use 12-month rolling or fiscal year (Oct-Sep) for trends
  4. Context: Always provide GDP comparison for meaningful interpretation

API Usage Examples

Get Total Public Debt Outstanding

curl "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v2/accounting/od/debt_to_penny?sort=-record_date&page[size]=1"

Get Monthly Treasury Statement Summary

curl "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v1/accounting/mts/mts_table_5?sort=-record_date&page[size]=12"

TypeScript Example

interface DebtResponse {
  data: Array<{
    record_date: string;
    tot_pub_debt_out_amt: string;
    debt_held_public_amt: string;
    intragov_hold_amt: string;
  }>;
}

async function getTotalDebt(): Promise<DebtResponse> {
  const response = await fetch(
    "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v2/accounting/od/debt_to_penny?sort=-record_date&page[size]=1"
  );
  return response.json();
}

// Returns debt in dollars (e.g., "34123456789012.34")

Key Endpoints for US-Common-Metrics

Metric Endpoint Update Frequency
Total Public Debt /v2/accounting/od/debt_to_penny Daily
Debt Held by Public /v2/accounting/od/debt_to_penny Daily
Monthly Receipts /v1/accounting/mts/mts_table_4 Monthly
Monthly Outlays /v1/accounting/mts/mts_table_5 Monthly
Deficit/Surplus /v1/accounting/mts/mts_table_1 Monthly
Interest on Debt /v1/accounting/mts/mts_table_5 Monthly

Credits

Data Source: U.S. Department of the Treasury, Bureau of the Fiscal Service API Documentation: https://fiscaldata.treasury.gov/api-documentation/ Cataloged for Substrate: 2025-12-01 Cataloger: Kai (DM-001)

END OF SOURCE DOCUMENTATION

Reference in New Issue View Git Blame Copy Permalink