Coverage
What you get
| Item | Detail |
|---|---|
| Product code | X-BONDS |
| Coverage | US Treasury par yield curve (1M to 30Y) and real yields on TIPS (5Y to 30Y). Benchmark government yields for major countries from central bank sources on Starter. Corporate bonds on Enterprise only. |
| Granularity | Daily |
| History | US Treasury curves as far back as the Treasury publishes them. Other countries added per central bank source. |
| Delivery | REST and CSV or Parquet files. No stream, since the source data is daily. |
| Update speed | Once a day, after the Treasury publishes its daily rates |
Yields drive almost everything else: the 10-year moves growth stocks, the 2-year tracks Fed expectations, and the gap between them is the most watched recession signal in markets. A clean daily curve in the same format as your price data saves you from scraping the Treasury site.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
symbol |
string | yes | Benchmark ID (US10Y, DE10Y) or ISIN for single bonds |
isin, cusip, figi |
string | optional | Identifiers |
bond_type |
string | yes | government, corporate, municipal |
country |
string | yes | ISO code |
timestamp / date |
string | yes | Price time or date |
price |
number | yes | Clean price per 100 |
yield |
number | yes | Yield to maturity, percent |
yield_to_worst |
number | optional | Callable bonds |
open, high, low, close |
number | optional | Bars, where available |
volume |
number | optional | Reported trade volume |
coupon |
number | optional | Percent |
maturity_date |
string | optional | YYYY-MM-DD |
amount_outstanding |
number | optional | Face value outstanding |
currency |
string | yes | e.g. USD |
Example record (illustrative values):
{
"symbol": "US10Y",
"bond_type": "government",
"country": "US",
"date": "2026-11-18",
"price": 98.84,
"yield": 5.07,
"coupon": 4.875,
"maturity_date": "2036-11-15",
"currency": "USD"
}
The free Treasury samples use a slimmer curve layout (symbol, date, tenor, yield_pct), one row per tenor per day.
Sample data
Sample data
US Treasury Yield Curve. Daily par yields from 1 month to 30 years for the last 20 trading days. First 10 rows:
| symbol | date | tenor | yield_pct |
|---|---|---|---|
| UST-1M | 2026-11-18 | 1M | 4.1 |
| UST-1.5M | 2026-11-18 | 1.5M | 4.24 |
| UST-2M | 2026-11-18 | 2M | 4.27 |
| UST-3M | 2026-11-18 | 3M | 4.34 |
| UST-4M | 2026-11-18 | 4M | 4.35 |
| UST-6M | 2026-11-18 | 6M | 4.43 |
| UST-1Y | 2026-11-18 | 1Y | 4.62 |
| UST-2Y | 2026-11-18 | 2Y | 4.8 |
| UST-3Y | 2026-11-18 | 3Y | 4.84 |
| UST-5Y | 2026-11-18 | 5Y | 4.89 |
Source: U.S. Treasury
US Treasury Real Yields (TIPS). Daily real yields from 5 to 30 years for the last 40 trading days. First 10 rows:
| symbol | date | tenor | real_yield_pct |
|---|---|---|---|
| TIPS-5Y | 2026-11-18 | 5Y | 2.66 |
| TIPS-7Y | 2026-11-18 | 7Y | 2.76 |
| TIPS-10Y | 2026-11-18 | 10Y | 2.88 |
| TIPS-20Y | 2026-11-18 | 20Y | 3.12 |
| TIPS-30Y | 2026-11-18 | 30Y | 3.25 |
| TIPS-5Y | 2026-11-17 | 5Y | 2.64 |
| TIPS-7Y | 2026-11-17 | 7Y | 2.76 |
| TIPS-10Y | 2026-11-17 | 10Y | 2.89 |
| TIPS-20Y | 2026-11-17 | 20Y | 3.14 |
| TIPS-30Y | 2026-11-17 | 30Y | 3.28 |
Source: U.S. Treasury
Use cases
Use cases
Curve inversion signal. Take yield_pct for UST-10Y minus UST-2Y on each date. A negative spread is an inverted curve. Track how long it stays negative and when it turns back, since many traders watch the re-steepening as closely as the inversion.
Breakeven inflation. Subtract real_yield_pct for TIPS-10Y from the nominal UST-10Y on the same date. What's left is the market's implied average inflation over ten years, useful for sizing gold, TIPS or commodity trades.
Rate regime filter for equity strategies. Use the daily change in UST-10Y as a switch: run a growth-heavy model only when yields are falling over 20 days. It's one join on date against your stock bars.
Cross-country spreads. On Starter, compare yield for US10Y and DE10Y by date. The US minus German spread is a common driver for EUR/USD.
Code
Code examples
Example: the US curve for one day.
curl "https://api.marketdata.co/v1/bonds/yield-curve?country=US&date=2026-11-18" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, 2s10s spread from the free sample CSV.
import pandas as pd
curve = pd.read_csv("us-treasury-yield-curve.csv", parse_dates=["date"])
wide = curve.pivot(index="date", columns="tenor", values="yield_pct")
wide["2s10s"] = wide["10Y"] - wide["2Y"]
print(wide[["2Y", "10Y", "2s10s"]].tail())
Pricing
Pricing
| Plan | Bond yields |
|---|---|
| Free, $0 | US Treasury par and real yield curves |
| Starter, $29/mo | Adds benchmark government yields for major countries |
| Enterprise, quote | Corporate bond prices (needs a FINRA TRACE licence) |
The US Treasury history is a free download. Full government curve history for other countries is planned at $19 per country. Among the vendors we studied, paid plans that include bond yields run from $9.99 to $99.99 a month.
Side by side
How we compare
6 of the 50 providers we studied sell bond prices or yields, and none make it the centre of their offer. Government yields come from public sources, so we don't charge for the US curve at all. What you get from us is the curve in the same symbol and date layout as every other dataset, with a published price for the international curves and files you can keep.
FAQ
Frequently asked questions
What is the difference between par yields and real yields?
Par yields are the nominal Treasury curve: what a bond priced at par would yield. Real yields come from TIPS and strip out expected inflation. The gap between the two at the same tenor is the breakeven inflation rate.
Are yields adjusted in any way?
No. We publish the Treasury's daily values as released. If the Treasury revises a past value, we plan to update the file and note the change.
Which time zone are the dates in?
Each date is the US business day the Treasury's rate applies to. There is no intraday timestamp because the source is a single daily value.
Do you have corporate bond data?
Not at launch. Corporate bond trade data comes through FINRA's TRACE, which needs a licence, so it is planned for Enterprise only.
Is this real-time?
No. Government yield curves are published once per business day, and we update after each publication. Intraday Treasury quotes are not part of this product.
What formats can I download?
The free samples are ZIP files with CSV and JSON. Paid files will come as CSV or Parquet with the same columns.
Keep reading
Related
- Asset hub: Cross-asset data
- Docs: API Reference: Economic Data and Calendars
- Learn: The Yield Curve for Traders, Trading Around CPI, Jobs and FOMC Releases
- Related data: Economic data API