---
title: "Treasury Yields (Historical)"
method: GET
path: "/macro/yield-curve"
tags: ["Macroeconomics"]
---

# Treasury Yields (Historical)

`GET /macro/yield-curve`

## Request

- Base URL: `https://api.financialdatasets.ai`
- URL: `https://api.financialdatasets.ai/macro/yield-curve`
- Auth: API key in header `X-API-KEY`

The daily US Treasury par yield curve, one object per business day with one key per tenor, newest first. Values are par yields in percent, sourced from authoritative government sources. A tenor is null when it was not published on that date.

## Query parameters

- `start_date` string
- `end_date` string
- `cursor` string

## Response `200`

Yield curve response

- YieldCurveResponse
  - `yield_curve` YieldCurve[]
    - `date` string: The business day of the curve in YYYY-MM-DD format.
    - `1_month` number, nullable: 1-month par yield in percent. Null when this tenor was not published on that date.
    - `1_5_month` number, nullable: 1.5-month par yield in percent. Null when this tenor was not published on that date.
    - `2_month` number, nullable: 2-month par yield in percent. Null when this tenor was not published on that date.
    - `3_month` number, nullable: 3-month par yield in percent. Null when this tenor was not published on that date.
    - `4_month` number, nullable: 4-month par yield in percent. Null when this tenor was not published on that date.
    - `6_month` number, nullable: 6-month par yield in percent. Null when this tenor was not published on that date.
    - `1_year` number, nullable: 1-year par yield in percent. Null when this tenor was not published on that date.
    - `2_year` number, nullable: 2-year par yield in percent. Null when this tenor was not published on that date.
    - `3_year` number, nullable: 3-year par yield in percent. Null when this tenor was not published on that date.
    - `5_year` number, nullable: 5-year par yield in percent. Null when this tenor was not published on that date.
    - `7_year` number, nullable: 7-year par yield in percent. Null when this tenor was not published on that date.
    - `10_year` number, nullable: 10-year par yield in percent. Null when this tenor was not published on that date.
    - `20_year` number, nullable: 20-year par yield in percent. Null when this tenor was not published on that date.
    - `30_year` number, nullable: 30-year par yield in percent. Null when this tenor was not published on that date.
  - `next_page_url` string: Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 100 records.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `402`: The request requires a paid subscription
- `404`: The specified resource was not found

## Changes

- **2026-11-03** `5872e134b56c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/financialdatasets/apis/financial-datasets-api/changes/macro/yield-curve/get.md)

---

[API](https://skmtc.dev/financialdatasets/apis/financial-datasets-api.md) - [All operations](https://skmtc.dev/financialdatasets/apis/financial-datasets-api/llms.txt) - [OpenAPI document](https://skmtc.dev/financialdatasets/apis/financial-datasets-api/revisions/42ba45d24472?raw)