@saibolla/ada 0.1.2

package/skills/usfiscaldata/references/datasets-interest-rates.md

@@ -0,0 +1,182 @@
+# Interest Rates & Exchange Rate Datasets — U.S. Treasury Fiscal Data
+
+## Average Interest Rates on U.S. Treasury Securities
+
+**Endpoint:** `/v2/accounting/od/avg_interest_rates`  
+**Frequency:** Monthly  
+**Date Range:** January 2001 to present
+
+Average interest rates for marketable and non-marketable Treasury securities, broken down by security type.
+
+**Key fields:**
+| Field | Type | Description |
+|-------|------|-------------|
+| `record_date` | DATE | Month end date |
+| `security_desc` | STRING | Security description (e.g., "Treasury Bills") |
+| `security_type_desc` | STRING | "Marketable" or "Non-marketable" |
+| `avg_interest_rate_amt` | PERCENTAGE | Average interest rate (%) |
+
+```python
+# Get average rates for all marketable securities, most recent month
+resp = requests.get(
+    "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v2/accounting/od/avg_interest_rates",
+    params={
+        "filter": "security_type_desc:eq:Marketable",
+        "sort": "-record_date",
+        "page[size]": 50
+    }
+)
+df = pd.DataFrame(resp.json()["data"])
+latest = df[df["record_date"] == df["record_date"].max()]
+print(latest[["security_desc", "avg_interest_rate_amt"]])
+
+# Historical rate for a specific security type
+resp = requests.get(
+    "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v2/accounting/od/avg_interest_rates",
+    params={
+        "fields": "record_date,avg_interest_rate_amt",
+        "filter": "security_desc:eq:Treasury Notes,record_date:gte:2010-01-01",
+        "sort": "-record_date"
+    }
+)
+```
+
+**Common security descriptions:**
+- `Treasury Bills`
+- `Treasury Notes`
+- `Treasury Bonds`
+- `Treasury Inflation-Protected Securities (TIPS)`
+- `Treasury Floating Rate Notes (FRN)`
+- `Federal Financing Bank`
+- `United States Savings Securities`
+- `Government Account Series`
+- `Total Marketable`
+- `Total Non-marketable`
+- `Total Interest-bearing Debt`
+
+---
+
+## Treasury Reporting Rates of Exchange
+
+**Endpoint:** `/v1/accounting/od/rates_of_exchange`  
+**Frequency:** Quarterly  
+**Date Range:** March 2001 to present
+
+Official Treasury exchange rates for foreign currencies used by federal agencies for reporting purposes. Updated quarterly (March 31, June 30, September 30, December 31).
+
+**Key fields:**
+| Field | Type | Description |
+|-------|------|-------------|
+| `record_date` | DATE | Quarter end date |
+| `country` | STRING | Country name |
+| `currency` | STRING | Currency name |
+| `country_currency_desc` | STRING | Combined "Country-Currency" (e.g., "Canada-Dollar") |
+| `exchange_rate` | NUMBER | Units of foreign currency per 1 USD |
+| `effective_date` | DATE | Date rate became effective |
+
+```python
+# Get all current exchange rates (latest quarter)
+resp = requests.get(
+    "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v1/accounting/od/rates_of_exchange",
+    params={"sort": "-record_date", "page[size]": 200}
+)
+df = pd.DataFrame(resp.json()["data"])
+latest_date = df["record_date"].max()
+current_rates = df[df["record_date"] == latest_date].copy()
+current_rates["exchange_rate"] = current_rates["exchange_rate"].astype(float)
+print(current_rates[["country_currency_desc", "exchange_rate"]].to_string())
+
+# Euro rate history
+resp = requests.get(
+    "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v1/accounting/od/rates_of_exchange",
+    params={
+        "fields": "record_date,exchange_rate",
+        "filter": "country_currency_desc:eq:Euro Zone-Euro",
+        "sort": "-record_date",
+        "page[size]": 100
+    }
+)
+euro_df = pd.DataFrame(resp.json()["data"])
+euro_df["exchange_rate"] = euro_df["exchange_rate"].astype(float)
+euro_df["record_date"] = pd.to_datetime(euro_df["record_date"])
+```
+
+---
+
+## TIPS and CPI Data
+
+**Endpoint:** `/v1/accounting/od/tips_cpi_data`  
+**Frequency:** Monthly  
+**Date Range:** April 1998 to present (2 data tables)
+
+Treasury Inflation-Protected Securities (TIPS) reference CPI data and index ratios used to calculate TIPS values.
+
+**Key fields:**
+| Field | Type | Description |
+|-------|------|-------------|
+| `record_date` | DATE | Date of record |
+| `index_ratio` | NUMBER | Index ratio for TIPS adjustment |
+| `ref_cpi` | NUMBER | Reference CPI value |
+
+---
+
+## FRN Daily Indexes
+
+**Endpoint:** `/v1/accounting/od/frn_daily_indexes`  
+**Frequency:** Daily  
+**Date Range:** April 2024 to present
+
+Daily index values for Treasury Floating Rate Notes (FRNs). The rate is based on the 13-week Treasury bill auction rate.
+
+---
+
+## Treasury Certified Interest Rates
+
+Four certification periods, each with their own endpoint set:
+
+### Annual Certification
+**Frequency:** Annual  
+**Date Range:** October 2006 to present (9 data tables)
+
+### Monthly Certification  
+**Frequency:** Monthly  
+**Date Range:** October 2006 to present (6 data tables)
+
+### Quarterly Certification
+**Frequency:** Quarterly  
+**Date Range:** October 2006 to present (4 data tables)
+
+### Semi-Annual Certification
+**Frequency:** Semi-Annual  
+**Date Range:** January 2008 to present (1 data table)
+
+These certified interest rates are used for federal loans, financing programs, and other purposes requiring official Treasury-certified rates.
+
+---
+
+## Federal Credit Similar Maturity Rates
+
+**Endpoint:** `/v1/accounting/od/fed_credit_similar_maturity_rates`  
+**Frequency:** Annual  
+**Date Range:** September 1992 to present
+
+Interest rates used for valuing federal credit programs (loans and loan guarantees) under the Federal Credit Reform Act.
+
+---
+
+## Historical Qualified Tax Credit Bond Interest Rates
+
+**Frequency:** Daily (Discontinued)  
+**Date Range:** March 2009 – January 2018
+
+Historical interest rates for Qualified Tax Credit Bonds (QTCB). No longer updated.
+
+---
+
+## State and Local Government Series (SLGS) Daily Rate Table
+
+**Endpoint:** `/v1/accounting/od/slgs_savings_bonds` (2 tables)  
+**Frequency:** Daily  
+**Date Range:** June 1992 to present
+
+Daily interest rates for State and Local Government Series securities, used by state and local issuers to comply with federal tax law arbitrage restrictions.

package/skills/usfiscaldata/references/datasets-securities.md

@@ -0,0 +1,216 @@
+# Securities & Savings Bonds Datasets — U.S. Treasury Fiscal Data
+
+## Treasury Securities Auctions Data
+
+**Endpoint:** `/v1/accounting/od/auctions_query`  
+**Frequency:** As Needed  
+**Date Range:** November 1979 to present
+
+Historical data on Treasury securities auctions including bills, notes, bonds, TIPS, and FRNs.
+
+**Key fields:**
+| Field | Type | Description |
+|-------|------|-------------|
+| `record_date` | DATE | Auction date |
+| `security_type` | STRING | Bill, Note, Bond, TIPS, FRN |
+| `security_term` | STRING | e.g., "4-Week", "2-Year", "10-Year" |
+| `cusip` | STRING | CUSIP identifier |
+| `offering_amt` | CURRENCY | Amount offered |
+| `accepted_comp_bid_rate_amt` | PERCENTAGE | High accepted competitive bid rate |
+| `bid_to_cover_ratio` | NUMBER | Bid-to-cover ratio |
+| `total_accepted_amt` | CURRENCY | Total accepted amount |
+| `indirect_bid_pct_accepted` | PERCENTAGE | Indirect bidder percentage |
+| `issue_date` | DATE | Issue/settlement date |
+| `maturity_date` | DATE | Maturity date |
+
+```python
+# Get recent 10-year Treasury note auctions
+resp = requests.get(
+    "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v1/accounting/od/auctions_query",
+    params={
+        "filter": "security_type:eq:Note,security_term:eq:10-Year",
+        "sort": "-record_date",
+        "page[size]": 10
+    }
+)
+df = pd.DataFrame(resp.json()["data"])
+
+# Get all auctions in 2024
+resp = requests.get(
+    "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v1/accounting/od/auctions_query",
+    params={
+        "filter": "record_date:gte:2024-01-01,record_date:lte:2024-12-31",
+        "sort": "-record_date",
+        "page[size]": 10000
+    }
+)
+```
+
+## Treasury Securities Upcoming Auctions
+
+**Endpoint:** `/v1/accounting/od/upcoming_auctions`  
+**Frequency:** As Needed  
+**Date Range:** March 2024 to present
+
+Announced but not yet settled auction schedule.
+
+**Key fields:**
+| Field | Type | Description |
+|-------|------|-------------|
+| `auction_date` | DATE | Scheduled auction date |
+| `security_type` | STRING | Security type |
+| `security_term` | STRING | Maturity term |
+| `offering_amt` | CURRENCY | Announced offering amount |
+
+```python
+# Get upcoming auctions
+resp = requests.get(
+    "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v1/accounting/od/upcoming_auctions",
+    params={"sort": "auction_date"}
+)
+upcoming = pd.DataFrame(resp.json()["data"])
+print(upcoming[["auction_date", "security_type", "security_term", "offering_amt"]])
+```
+
+## Record-Setting Treasury Securities Auction Data
+
+**Frequency:** As Needed
+
+Tracks auction records (largest, highest rate, lowest rate, etc.) for each security type and term.
+
+## Treasury Securities Buybacks
+
+**Frequency:** As Needed (2 data tables)  
+**Date Range:** March 2000 to present
+
+Data on Treasury's secondary market buyback (repurchase) operations. Active since the program's relaunch in 2024.
+
+---
+
+## I Bonds Interest Rates
+
+**Endpoint:** `/v2/accounting/od/i_bond_interest_rates`  
+**Frequency:** Semi-Annual (May and November)  
+**Date Range:** September 1998 to present
+
+Composite interest rates for Series I Savings Bonds, including fixed rate and inflation rate components.
+
+**Key fields:**
+| Field | Type | Description |
+|-------|------|-------------|
+| `effective_date` | DATE | Rate effective date |
+| `announcement_date` | DATE | Announcement date |
+| `fixed_rate` | PERCENTAGE | Fixed rate component |
+| `semiannual_inflation_rate` | PERCENTAGE | Semi-annual CPI-U inflation rate |
+| `earnings_rate_i_bonds` | PERCENTAGE | Combined composite rate |
+
+```python
+# Current I Bond rates
+resp = requests.get(
+    "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v2/accounting/od/i_bond_interest_rates",
+    params={"sort": "-effective_date", "page[size]": 5}
+)
+df = pd.DataFrame(resp.json()["data"])
+latest = df.iloc[0]
+print(f"Current I Bond rate: {latest['earnings_rate_i_bonds']}%")
+print(f"  Fixed rate: {latest['fixed_rate']}%")
+print(f"  Inflation component: {latest['semiannual_inflation_rate']}%")
+```
+
+## U.S. Treasury Savings Bonds: Issues, Redemptions & Maturities
+
+**Endpoint:** `/v1/accounting/od/sb_issues_redemptions`  (3 tables)  
+**Frequency:** Monthly  
+**Date Range:** September 1998 to present
+
+Monthly statistics on Series EE, Series I, and Series HH savings bonds outstanding, issued, and redeemed.
+
+**Key fields:**
+| Field | Type | Description |
+|-------|------|-------------|
+| `record_date` | DATE | Month end date |
+| `series_cd` | STRING | Bond series (EE, I, HH) |
+| `issued_amt` | CURRENCY | Amount issued |
+| `redeemed_amt` | CURRENCY | Amount redeemed |
+| `matured_amt` | CURRENCY | Amount matured |
+| `outstanding_amt` | CURRENCY | Total outstanding |
+
+## Savings Bonds Value Files
+
+**Frequency:** Semi-Annual  
+**Date Range:** May 1992 to present
+
+Files for calculating current redemption values of savings bonds.
+
+## Accrual Savings Bonds Redemption Tables (Discontinued)
+
+**Endpoint:** `/v2/accounting/od/redemption_tables`  
+**Frequency:** Discontinued (last updated 2022)  
+**Date Range:** March 1999 – May 2023
+
+Monthly redemption value tables for historical savings bonds.
+
+## Savings Bonds Securities Sold (Discontinued)
+
+**Frequency:** Discontinued  
+**Date Range:** October 1998 – June 2022
+
+---
+
+## State and Local Government Series (SLGS) Securities
+
+**Endpoint:** `/v1/accounting/od/slgs_statistics`  
+**Frequency:** Daily  
+**Date Range:** October 1998 to present
+
+SLGS securities outstanding data — non-marketable special purpose securities sold to state and local governments.
+
+## Monthly State and Local Government Series (SLGS) Securities Program
+
+**Frequency:** Monthly  
+**Date Range:** March 2014 to present
+
+Monthly statistics on the SLGS program.
+
+---
+
+## Electronic Securities Transactions
+
+**Frequency:** Monthly (8 data tables)  
+**Date Range:** January 2000 to present
+
+Electronic book-entry transactions for Treasury securities in the TRADES (Treasury/Reserve Automated Debt Entry System) system.
+
+---
+
+## Federal Investments Program
+
+### Interest Cost by Fund
+**Frequency:** Monthly  
+**Date Range:** October 2001 to present
+
+Monthly interest cost by government trust fund for invested federal funds.
+
+### Principal Outstanding
+**Frequency:** Monthly (2 tables)  
+**Date Range:** October 2017 to present
+
+### Statement of Account
+**Frequency:** Monthly (3 tables)  
+**Date Range:** November 2011 to present
+
+---
+
+## Federal Borrowings Program
+
+### Distribution and Transaction Data
+**Frequency:** Daily (2 tables)  
+**Date Range:** September 2000 to present
+
+### Interest on Uninvested Funds
+**Frequency:** Quarterly  
+**Date Range:** December 2016 to present
+
+### Summary General Ledger Balances Report
+**Frequency:** Monthly (2 tables)  
+**Date Range:** October 2005 to present

package/skills/usfiscaldata/references/examples.md

@@ -0,0 +1,258 @@
+# Code Examples — U.S. Treasury Fiscal Data
+
+## Python Examples
+
+### Setup
+
+```python
+import requests
+import pandas as pd
+
+BASE_URL = "https://api.fiscaldata.treasury.gov/services/api/fiscal_service"
+
+def fetch(endpoint, **params):
+    resp = requests.get(f"{BASE_URL}{endpoint}", params=params)
+    resp.raise_for_status()
+    return resp.json()
+```
+
+### National Debt Tracker
+
+```python
+# Current total public debt
+result = fetch("/v2/accounting/od/debt_to_penny", 
+               sort="-record_date", **{"page[size]": 1})
+d = result["data"][0]
+debt = float(d["tot_pub_debt_out_amt"])
+print(f"National debt as of {d['record_date']}: ${debt/1e12:.2f} trillion")
+
+# Debt trend over last 5 years
+result = fetch("/v2/accounting/od/debt_to_penny",
+               fields="record_date,tot_pub_debt_out_amt",
+               filter="record_date:gte:2020-01-01",
+               sort="-record_date", **{"page[size]": 10000})
+df = pd.DataFrame(result["data"])
+df["date"] = pd.to_datetime(df["record_date"])
+df["debt_trillion"] = df["tot_pub_debt_out_amt"].astype(float) / 1e12
+df = df.sort_values("date")
+print(df[["date", "debt_trillion"]].tail(10))
+```
+
+### Federal Exchange Rates
+
+```python
+# All current Treasury exchange rates
+result = fetch("/v1/accounting/od/rates_of_exchange",
+               sort="-record_date", **{"page[size]": 300})
+df = pd.DataFrame(result["data"])
+latest = df[df["record_date"] == df["record_date"].max()]
+latest = latest.copy()
+latest["exchange_rate"] = latest["exchange_rate"].astype(float)
+latest = latest.sort_values("country_currency_desc")
+print(latest[["country_currency_desc", "exchange_rate", "record_date"]].to_string(index=False))
+
+# Convert USD amount to foreign currencies
+def convert_usd(usd_amount, rates_df):
+    rates_df = rates_df.copy()
+    rates_df["value_in_foreign"] = usd_amount * rates_df["exchange_rate"].astype(float)
+    return rates_df[["country_currency_desc", "value_in_foreign"]]
+
+conversions = convert_usd(1000, latest)
+print(conversions.head(10))
+```
+
+### Treasury Securities Auction Analysis
+
+```python
+# Recent 10-year note auctions
+result = fetch("/v1/accounting/od/auctions_query",
+               filter="security_type:eq:Note,security_term:eq:10-Year",
+               sort="-record_date", **{"page[size]": 20})
+df = pd.DataFrame(result["data"])
+numeric_cols = ["accepted_comp_bid_rate_amt", "bid_to_cover_ratio", 
+                "total_accepted_amt", "indirect_bid_pct_accepted"]
+for col in numeric_cols:
+    if col in df.columns:
+        df[col] = pd.to_numeric(df[col], errors="coerce")
+print(df[["record_date", "security_term", "accepted_comp_bid_rate_amt", 
+         "bid_to_cover_ratio"]].head(10))
+
+# Auction yield trend: 2-year vs 10-year
+def get_auction_yields(term, n=24):
+    result = fetch("/v1/accounting/od/auctions_query",
+                   fields="record_date,security_term,accepted_comp_bid_rate_amt",
+                   filter=f"security_type:eq:Note,security_term:eq:{term}",
+                   sort="-record_date", **{"page[size]": n})
+    df = pd.DataFrame(result["data"])
+    df["yield"] = df["accepted_comp_bid_rate_amt"].astype(float)
+    df["date"] = pd.to_datetime(df["record_date"])
+    return df[["date", "yield", "security_term"]].sort_values("date")
+
+t2 = get_auction_yields("2-Year")
+t10 = get_auction_yields("10-Year")
+yield_curve = t2.merge(t10, on="date", suffixes=("_2y", "_10y"), how="inner")
+yield_curve["spread"] = yield_curve["yield_10y"] - yield_curve["yield_2y"]
+print("Yield curve spread (10y - 2y):")
+print(yield_curve[["date", "yield_2y", "yield_10y", "spread"]].tail(10))
+```
+
+### Daily Treasury Statement Analysis
+
+```python
+# Recent Treasury General Account (TGA) balance
+result = fetch("/v1/accounting/dts/operating_cash_balance",
+               sort="-record_date", **{"page[size]": 10})
+df = pd.DataFrame(result["data"])
+print("Treasury General Account Balances (most recent):")
+for _, row in df.head(5).iterrows():
+    bal = float(row["close_today_bal"])
+    print(f"  {row['record_date']}: ${bal:,.0f} million")
+
+# Monthly total receipts and withdrawals
+result = fetch("/v1/accounting/dts/deposits_withdrawals_operating_cash",
+               fields="record_date,transaction_type,transaction_today_amt",
+               filter="record_date:gte:2024-01-01",
+               sort="-record_date", **{"page[size]": 10000})
+df = pd.DataFrame(result["data"])
+df["amount"] = df["transaction_today_amt"].astype(float)
+summary = df.groupby(["record_date", "transaction_type"])["amount"].sum().unstack()
+print(summary.tail(10))
+```
+
+### Monthly Treasury Statement (Budget)
+
+```python
+# Federal budget receipts and outlays (MTS Table 1)
+result = fetch("/v1/accounting/mts/mts_table_1",
+               filter="record_fiscal_year:eq:2024",
+               sort="record_date", **{"page[size]": 1000})
+df = pd.DataFrame(result["data"])
+
+# Get total receipts line (line code varies; filter by description)
+receipts = df[df["classification_desc"].str.contains("Total Receipts", na=False, case=False)]
+outlays = df[df["classification_desc"].str.contains("Total Outlays", na=False, case=False)]
+print("FY2024 Monthly Summary:")
+print(receipts[["record_date", "current_month_gross_rcpt_amt"]].head(12))
+```
+
+### Interest Rate Analysis
+
+```python
+# Average interest rates on all marketable Treasury securities
+result = fetch("/v2/accounting/od/avg_interest_rates",
+               filter="security_type_desc:eq:Marketable,record_date:gte:2015-01-01",
+               sort="-record_date", **{"page[size]": 10000})
+df = pd.DataFrame(result["data"])
+df["date"] = pd.to_datetime(df["record_date"])
+df["rate"] = df["avg_interest_rate_amt"].astype(float)
+
+# Pivot to compare rates across security types
+pivot = df.pivot_table(index="date", columns="security_desc", values="rate")
+print(pivot.tail(5))
+
+# I Bond rates history
+result = fetch("/v2/accounting/od/i_bond_interest_rates",
+               sort="-effective_date", **{"page[size]": 20})
+df = pd.DataFrame(result["data"])
+df["total_rate"] = df["earnings_rate_i_bonds"].astype(float)
+df["fixed_rate"] = df["fixed_rate"].astype(float)
+print("I Bond rate history:")
+print(df[["effective_date", "fixed_rate", "total_rate"]].head(10))
+```
+
+### Fiscal Year Summary
+
+```python
+def get_fiscal_year_summary(fy: int):
+    """Get key fiscal metrics for a given fiscal year."""
+    
+    # Total debt at end of FY
+    fy_end = f"{fy}-09-30"
+    result = fetch("/v2/accounting/od/debt_to_penny",
+                   filter=f"record_date:lte:{fy_end}",
+                   sort="-record_date", **{"page[size]": 1})
+    debt = float(result["data"][0]["tot_pub_debt_out_amt"]) / 1e12
+
+    # Interest expense for FY
+    result = fetch("/v2/accounting/od/interest_expense",
+                   fields="record_date,expense_net_amt",
+                   filter=f"record_fiscal_year:eq:{fy}",
+                   **{"page[size]": 10000})
+    interest_df = pd.DataFrame(result["data"])
+    if not interest_df.empty:
+        total_interest = interest_df["expense_net_amt"].astype(float).sum() / 1e9
+    else:
+        total_interest = None
+    
+    return {
+        "fiscal_year": fy,
+        "total_debt_trillion": round(debt, 2),
+        "interest_expense_billion": round(total_interest, 1) if total_interest else None
+    }
+
+for fy in [2021, 2022, 2023, 2024]:
+    summary = get_fiscal_year_summary(fy)
+    print(f"FY{fy}: Debt=${summary['total_debt_trillion']}T, "
+          f"Interest=${summary['interest_expense_billion']}B")
+```
+
+---
+
+## R Examples
+
+```r
+library(httr)
+library(jsonlite)
+
+BASE_URL <- "https://api.fiscaldata.treasury.gov/services/api/fiscal_service"
+
+# National debt
+response <- GET(paste0(BASE_URL, "/v2/accounting/od/debt_to_penny"),
+                query = list(sort = "-record_date", `page[size]` = 1))
+data <- fromJSON(rawToChar(response$content))$data
+cat(sprintf("Total debt: $%.2f trillion\n", 
+            as.numeric(data$tot_pub_debt_out_amt) / 1e12))
+
+# Exchange rates
+response <- GET(paste0(BASE_URL, "/v1/accounting/od/rates_of_exchange"),
+                query = list(
+                    fields = "country_currency_desc,exchange_rate,record_date",
+                    filter = "record_date:gte:2024-01-01",
+                    sort = "-record_date",
+                    `page[size]` = 200
+                ))
+rates <- fromJSON(rawToChar(response$content))$data
+rates$exchange_rate <- as.numeric(rates$exchange_rate)
+head(rates)
+
+# MTS Table 9: latest total receipts
+response <- GET(paste0(BASE_URL, "/v1/accounting/mts/mts_table_9"),
+                query = list(
+                    filter = "line_code_nbr:eq:120",
+                    sort = "-record_date",
+                    `page[size]` = 1
+                ))
+mts_data <- fromJSON(rawToChar(response$content))$data
+cat("Latest total receipts line:", mts_data$current_month_gross_rcpt_amt, "\n")
+```
+
+---
+
+## Discovering Available Fields
+
+To find available fields for any endpoint, request a small sample and inspect the `meta.labels` and `meta.dataTypes`:
+
+```python
+result = fetch("/v2/accounting/od/debt_to_penny", **{"page[size]": 1})
+meta = result["meta"]
+for field, label in meta["labels"].items():
+    dtype = meta["dataTypes"].get(field, "?")
+    fmt = meta["dataFormats"].get(field, "?")
+    print(f"{field:40s} | {dtype:12s} | {label}")
+```
+
+## Finding Datasets
+
+Browse the full list of 54 datasets and 182 endpoints at:
+- `https://fiscaldata.treasury.gov/datasets/` — searchable dataset catalog
+- `https://fiscaldata.treasury.gov/api-documentation/#list-of-endpoints-table` — full endpoint table