# U.S. Treasury API: Get Treasury yields

> Gets official daily Treasury par yield curve rates for a date, or the latest published date on or before it.

Unofficial. Not affiliated with or endorsed by U.S. Treasury.

- Page: https://fous.com/methods/home.treasury.gov/get-treasury-yields
- Method: `home.treasury.gov/get_treasury_yields`, version 1
- Website: home.treasury.gov
- Returns: date, 14 maturity yields in percent, page_url
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `date` | string | no |  | Requested calendar date (YYYY-MM-DD), such as 2024-01-01. Defaults to today and returns the latest published date on or before it. |

## Output

From a run on Oct 23, 2026. Its input:

```json
{}
```

Its output:

```json
{
  "date": "2026-10-22",
  "page_url": "https://home.treasury.gov/resource-center/data-chart-center/interest-rates/daily-treasury-rates.csv/2026/all?type=daily_treasury_yield_curve&page&_format=csv",
  "yield_1_year": 4.41,
  "yield_2_year": 4.65,
  "yield_3_year": 4.72,
  "yield_5_year": 4.78,
  "yield_7_year": 4.86,
  "yield_10_year": 4.96,
  "yield_1_month": 4.11,
  "yield_20_year": 5.32,
  "yield_2_month": 4.16,
  "yield_30_year": 5.29,
  "yield_3_month": 4.22,
  "yield_4_month": 4.29,
  "yield_6_month": 4.29,
  "yield_1_5_month": 4.1
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"home.treasury.gov/get_treasury_yields","input":{}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What were the official Treasury par yield curve rates on 2024-03-15?
- Give me the daily Treasury yields for the 10-year and 2-year maturities as of 2023-11-30.
- I need the latest published Treasury par yield curve for today's date, with all 14 maturities.
- Look up the treasury.gov yield curve rates for 2022-06-10 and include the page link.
- Pull the 14-maturity Treasury yield curve from the last business day before 2025-01-01.

## Input schema

```json
{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Requested calendar date (YYYY-MM-DD), such as 2024-01-01. Defaults to today and returns the latest published date on or before it."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "date",
    "yield_1_month",
    "yield_1_5_month",
    "yield_2_month",
    "yield_3_month",
    "yield_4_month",
    "yield_6_month",
    "yield_1_year",
    "yield_2_year",
    "yield_3_year",
    "yield_5_year",
    "yield_7_year",
    "yield_10_year",
    "yield_20_year",
    "yield_30_year",
    "page_url"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Publication date for these rates."
    },
    "page_url": {
      "type": "string",
      "description": "Official Treasury link to this year’s published rates."
    },
    "yield_1_year": {
      "type": [
        "number",
        "null"
      ],
      "description": "Treasury yield in percent, or null when not published."
    },
    "yield_2_year": {
      "type": [
        "number",
        "null"
      ],
      "description": "Treasury yield in percent, or null when not published."
    },
    "yield_3_year": {
      "type": [
        "number",
        "null"
      ],
      "description": "Treasury yield in percent, or null when not published."
    },
    "yield_5_year": {
      "type": [
        "number",
        "null"
      ],
      "description": "Treasury yield in percent, or null when not published."
    },
    "yield_7_year": {
      "type": [
        "number",
        "null"
      ],
      "description": "Treasury yield in percent, or null when not published."
    },
    "yield_10_year": {
      "type": [
        "number",
        "null"
      ],
      "description": "Treasury yield in percent, or null when not published."
    },
    "yield_1_month": {
      "type": [
        "number",
        "null"
      ],
      "description": "Treasury yield in percent, or null when not published."
    },
    "yield_20_year": {
      "type": [
        "number",
        "null"
      ],
      "description": "Treasury yield in percent, or null when not published."
    },
    "yield_2_month": {
      "type": [
        "number",
        "null"
      ],
      "description": "Treasury yield in percent, or null when not published."
    },
    "yield_30_year": {
      "type": [
        "number",
        "null"
      ],
      "description": "Treasury yield in percent, or null when not published."
    },
    "yield_3_month": {
      "type": [
        "number",
        "null"
      ],
      "description": "Treasury yield in percent, or null when not published."
    },
    "yield_4_month": {
      "type": [
        "number",
        "null"
      ],
      "description": "Treasury yield in percent, or null when not published."
    },
    "yield_6_month": {
      "type": [
        "number",
        "null"
      ],
      "description": "Treasury yield in percent, or null when not published."
    },
    "yield_1_5_month": {
      "type": [
        "number",
        "null"
      ],
      "description": "Treasury yield in percent, or null when not published."
    }
  },
  "additionalProperties": false
}
```

## See more

- [U.S. Treasury API: Get reporting exchange rates](https://fous.com/methods/treasury.gov/get-reporting-exchange-rates.md): Gets the U.S. Treasury quarterly reporting exchange rate for a country or currency on a given date. If that quarter has no published record, it uses the latest preceding quarter.
- [U.S. Treasury API: Get national debt](https://fous.com/methods/home.treasury.gov/get-national-debt.md): Returns US national debt (Debt to the Penny) for a given date, or the latest published day. Dates without a record use the previous published day.
- [Investing.com API: Get government bond yields](https://fous.com/methods/investing.com/get-bond-yields.md): Gets current government bond yields from Investing.com's world government bonds table, optionally filtered by country and maturity term.
- [European Union API: Get euro exchange rates](https://fous.com/methods/ecb.europa.eu/get-euro-exchange-rates.md): Gets the official ECB euro reference exchange rates for a day, or the latest published day. Weekends, holidays and dates before publication return the previous published day.
- [Freddie Mac API: Get mortgage rates](https://fous.com/methods/freddiemac.com/get-mortgage-rates.md): Returns Freddie Mac's U.S. 30-year and 15-year fixed mortgage rates for the latest survey or a chosen date, with weekly and year-ago changes, and optionally a weekly history for a date range.
- [Macrotrends API: Get long-term price history](https://fous.com/methods/macrotrends.net/get-long-term-price-history.md): Gets decades of yearly commodity or stock-index price history from Macrotrends: yearly average, open, high, low, close, annual change and inflation-adjusted value for gold, silver, crude oil, natural gas, copper, Dow Jones, S&P 500 and Nasdaq. The current year may be incomplete.
- [XE API: Get historical exchange rate](https://fous.com/methods/xe.com/get-historical-rate.md): Gets XE's daily mid-market exchange rate for a past UTC date and converts an amount with it.
- [Yahoo API: Get price history](https://fous.com/methods/finance.yahoo.com/get-price-history.md): Returns Yahoo Finance daily, weekly or monthly price history and total adjusted-close return for a stock, fund, index or cryptocurrency.
- [All U.S. Treasury methods](https://fous.com/methods/treasury.gov.md)
