US Treasury Data — Yield Curve, Debt & Rates for AI Agents

Get official US Treasury fiscal data in one call: the daily Treasury yield curve, the national debt, average interest rates, interest expense, and official exchange rates — as clean, structured records with a human-readable summary for every one.

Built for AI finance & macro agents, trading tools, and research. No API key, no setup — just current, authoritative government data.

---

Why this Actor?

An LLM can't know today's 10-year yield, this week's national debt, or the current Treasury exchange rate — these change constantly and are the kind of hard, citable numbers a finance agent must get exactly right. This Actor is that fiscal grounding: ask for the yield curve and get back every tenor with the 2s10s spread already computed; ask for the debt and get the exact figure to the penny.

• Macro & rates agents — the yield curve (and its inversion) is the single most-watched recession signal; this gives it to you live.
• Trading & fixed-income tools — current and historical Treasury rates, debt and interest expense.
• Research & dashboards — pull a date range and chart debt or yields over time.
• FX reference — the official US Treasury reporting rates of exchange, used for government accounting.

It complements company-level financial data (filings, fundamentals) and market FX with the government/sovereign side — the yield curve and debt figures that aren't in those sources.

---

Datasets

Pick any combination:

Dataset	What it gives
Daily Yield Curve	Par yield for every tenor (1 Mo → 30 Yr), with the 2s10s spread and an inversion flag
National Debt	Total public debt outstanding, split into public vs intragovernmental (to the penny)
Average Interest Rates	Average rate the Treasury pays on each type of security
Interest Expense	Interest expense on the public debt
Official Exchange Rates	Treasury reporting rate of exchange, USD → each currency

---

What you get

Each record is normalized to the same simple shape:

Field	Description
dataset	Which dataset
recordDate	The date of the figure
headline	The key number(s), formatted (e.g. 10Y 4.48% · 2Y 4.13% · 2s10s 0.35%)
summary	A human/agent-readable sentence
valuesJson	All metrics for the record as JSON
unit	Unit of the values (percent, USD, per USD)
source	US Department of the Treasury
scrapedAt	Timestamp

The headline and summary are ready to drop into an agent's context; valuesJson holds the full detail for programmatic use.

---

Example output

{
  "dataset": "yield_curve",
  "recordDate": "2026-07-06",
  "headline": "10Y 4.48% · 2Y 4.13% · 3M 3.87% · 2s10s 0.35%",
  "summary": "US Treasury par yield curve (2026-07-06): 3M 3.87%, 1Y 3.95%, 2Y 4.13%, 5Y 4.21%, 10Y 4.48%, 30Y 4.99%. 10Y–2Y spread 0.35% (normal).",
  "valuesJson": "{\"1 Mo\":\"3.69\",\"3 Mo\":\"3.87\",\"2 Yr\":\"4.13\",\"10 Yr\":\"4.48\",\"30 Yr\":\"4.99\"}",
  "unit": "percent",
  "source": "US Department of the Treasury",
  "scrapedAt": "2026-07-07T15:00:00.000Z"
}

{
  "dataset": "national_debt",
  "recordDate": "2026-07-03",
  "headline": "Total public debt outstanding: $39.38T",
  "summary": "US national debt on 2026-07-03: $39.38T total — $31.68T held by the public, $7.70T intragovernmental.",
  "unit": "USD"
}

---

Input

Field	Type	Default	Description
datasets	array	yield_curve, national_debt, interest_rates	Which datasets to fetch.
latest	boolean	true	Return only the most recent record(s).
startDate	string	—	Range start YYYY-MM-DD (when latest is off).
endDate	string	—	Range end YYYY-MM-DD.
maxRecords	integer	60	Cap on records per dataset in range mode.
currency	string	—	For Exchange Rates: filter to a currency/country (e.g. Euro, Japan).

Current snapshot

{ "datasets": ["yield_curve", "national_debt", "interest_rates"], "latest": true }

Historical yield curve

{
  "datasets": ["yield_curve"],
  "latest": false,
  "startDate": "2026-01-01",
  "endDate": "2026-07-06",
  "maxRecords": 200
}

Just the Euro exchange rate

{ "datasets": ["exchange_rates"], "latest": true, "currency": "Euro" }

---

Use cases in detail

1. Macro & rates agents

The yield curve is the headline macro indicator. This Actor returns every tenor plus the 2s10s spread with an inversion flag — so an agent can answer "is the curve inverted?" directly, with the number.

2. Trading & fixed-income tools

Pull current Treasury rates and debt to inform positioning, or a historical range to backtest against rate moves.

3. Fiscal & policy research

Track the national debt and interest expense over time — the cost of servicing the debt is an increasingly important macro story.

4. FX reference & accounting

The Treasury reporting rates of exchange are the official rates used for US government accounting and many contracts.

5. Dashboards & alerts

Schedule the Actor and alert when the curve inverts, the debt crosses a threshold, or a rate moves.

---

How to use it

1. Click Try for free.
2. Pick your datasets (and a date range if you want history).
3. Click Start.
4. Read the results as JSON, CSV, Excel, or via the Apify API.

Runs finish in seconds.

---

Calling from the API

curl -X POST "https://api.apify.com/v2/acts/YOUR_ACTOR_ID/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "datasets": ["yield_curve", "national_debt"], "latest": true }'

Then fetch the dataset:

$curl "https://api.apify.com/v2/acts/YOUR_ACTOR_ID/runs/last/dataset/items?token=YOUR_APIFY_TOKEN"

Works with webhooks, Zapier, Make and n8n.

---

Frequently asked questions

How fresh is the data? It's pulled live from official Treasury sources on each run. The yield curve updates each business day; debt is daily; interest and exchange rates on their own schedules.

What's the 2s10s spread? The 10-year yield minus the 2-year. When it's negative (inverted), it's historically been a recession signal — the Actor flags it for you.

Can I get history, not just the latest? Yes — set latest to false and give a startDate/endDate.

Which currencies are in Exchange Rates? The full Treasury reporting list (150+). Use the currency filter to narrow it.

Is this the same as market data? These are official Treasury/government figures (par yields, debt, reporting FX). They complement live market quotes rather than replace them.

Can an AI agent call this automatically? Yes — it's keyless and returns structured JSON with ready-made summaries, ideal as an agent/MCP tool.

---

Notes

This Actor retrieves publicly available fiscal data published by the US Department of the Treasury. Figures are provided for information and research; for official use, consult the Treasury's own publications. Data is public domain as a work of the US government.

---

Support

Want another Treasury dataset, an extra field, or a computed indicator? Open an issue from the Actor's page.