# TIPS Real Yields & Breakeven Inflation API > The inflation-adjusted side of the US Treasury yield curve, served from the Treasury's official daily feeds. The realyields endpoint returns the latest TIPS real yield curve — the inflation-protected (real) yield at the 5, 7, 10, 20 and 30-year maturities. The breakeven endpoint returns market-implied inflation: at each maturity it takes the nominal Treasury yield minus the real yield, which is the average annual inflation rate the bond market is pricing in over that horizon, and returns it alongside the nominal and real components. The history endpoint returns the daily time series of the real yield, the nominal yield and the breakeven inflation rate for one maturity over a year. A 10-year breakeven of 2.3 means the market is pricing roughly 2.3% average inflation over the next decade — a core gauge for rates traders, macro funds and inflation hedgers. This is the real-yield and inflation-expectations data-cut — distinct from the nominal yield-curve, the world-government-bond and the central-bank-rate APIs in the catalogue. Live, no key on the upstream, nothing stored. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/realyields-api/..." ``` ## Pricing - **Free** (Free) — 28,000 calls/Mo, 5 req/s - **Starter** ($7/Mo) — 325,000 calls/Mo, 15 req/s - **Pro** ($21/Mo) — 1,370,000 calls/Mo, 40 req/s - **Scale** ($48/Mo) — 4,850,000 calls/Mo, 100 req/s ## Endpoints ### Rates #### `GET /v1/breakeven` — Market-implied inflation = nominal - real **Parameters:** - `year` (query, optional, string) — Year (defaults to current) Example: `2026` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/realyields-api/v1/breakeven?year=2026" ``` **Response:** ```json { "data": { "date": "2026-06-11", "source": "US Treasury", "breakeven": [ { "maturity": "5y", "real_yield_pct": 1.78, "nominal_yield_pct": 4.18, "breakeven_inflation_pct": 2.4 }, { "maturity": "7y", "real_yield_pct": 1.96, "nominal_yield_pct": 4.31, "breakeven_inflation_pct": 2.35 }, { "maturity": "10y", "real_yield_pct": 2.16, "nominal_yield_pct": 4.45, "breakeven_inflation_pct": 2.29 }, { "maturity": "20y", "real_yield_pct": 2.53, "nominal_yield_pct": 4.96, "breakeven_inflation_pct": 2.43 }, { "maturity": "30y", "real_yield_pct": 2.72, "nominal_yield_pct": 4.95, "breakeven_inflation_pct": 2.23 } ], "nominal_date": "2026-06-11" }, "meta": { "timestamp": "2026-06-12T01:41:31.271Z", "request_id": "754b17f6-0cdd-442e-bd9f-dc78170a76b8" }, "status": "ok", "message": "Breakeven inflation retrieved successfully", "success": true } ``` #### `GET /v1/history` — Daily real/nominal/breakeven series for a maturity **Parameters:** - `maturity` (query, optional, string) — 5year, 7year, 10year, 20year, 30year Example: `10year` - `year` (query, optional, string) — Year (defaults to current) Example: `2026` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/realyields-api/v1/history?maturity=10year&year=2026" ``` **Response:** ```json { "data": { "year": "2026", "count": 112, "source": "US Treasury", "history": [ { "date": "2026-01-02", "real_yield_pct": 1.94, "nominal_yield_pct": 4.19, "breakeven_inflation_pct": 2.25 }, { "date": "2026-01-05", "real_yield_pct": 1.91, "nominal_yield_pct": 4.17, "breakeven_inflation_pct": 2.26 }, { "date": "2026-01-06", "real_yield_pct": 1.91, "nominal_yield_pct": 4.18, "breakeven_inflation_pct": 2.27 }, { "date": "2026-01-07", "real_yield_pct": 1.88, "nominal_yield_pct": 4.15, "breakeven_inflation_pct": 2.27 }, { "date": "2026-01-08", "real_yield_pct": 1.92, "nominal_yield_pct": 4.19, "breakeven_inflation_pct": 2.27 }, { "date": "2026-01-09", "real_yield_pct": 1.9, "nominal_yield_pct": 4.18, "breakeven_inflation_pct": 2.28 }, { "date": "2026-01-12", "real_yield_pct": 1.9, "nominal_yield_pct": 4.19, "breakeven_inflation_pct": 2.29 }, …(truncated, see openapi.json for full schema) ``` #### `GET /v1/realyields` — Latest TIPS real (inflation-protected) yield curve **Parameters:** - `year` (query, optional, string) — Year (defaults to current) Example: `2026` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/realyields-api/v1/realyields?year=2026" ``` **Response:** ```json { "data": { "date": "2026-06-11", "curve": [ { "maturity": "5y", "real_yield_pct": 1.78 }, { "maturity": "7y", "real_yield_pct": 1.96 }, { "maturity": "10y", "real_yield_pct": 2.16 }, { "maturity": "20y", "real_yield_pct": 2.53 }, { "maturity": "30y", "real_yield_pct": 2.72 } ], "source": "US Treasury" }, "meta": { "timestamp": "2026-06-12T01:41:31.440Z", "request_id": "4039ba6d-02b7-423a-8502-42a1282c1a71" }, "status": "ok", "message": "Real yields retrieved successfully", "success": true } ``` ### Meta #### `GET /v1/meta` — Spec **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/realyields-api/v1/meta" ``` **Response:** ```json { "data": { "note": "Yields are percent. Breakeven inflation = nominal yield - real yield (a 10-year breakeven of 2.3 means the market prices ~2.3% average inflation over 10 years). maturity is 5year, 7year, 10year, 20year or 30year. year defaults to the current year.", "source": "US Treasury daily yield-curve feeds (home.treasury.gov, real + nominal)", "service": "realyields-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/history": "Daily real/nominal/breakeven series for one maturity (maturity=10year, year=2026).", "GET /v1/breakeven": "Market-implied inflation by maturity = nominal - real (with components).", "GET /v1/realyields": "Latest TIPS real (inflation-protected) yield curve (year=2026 optional)." }, "description": "The inflation-adjusted side of the US Treasury curve. realyields returns the latest TIPS real yield curve (inflation-protected yields at 5, 7, 10, 20 and 30 years); breakeven returns market-implied inflation — the nominal yield minus the real yield at each maturity, i.e. the inflation the bond market is pricing in — with the nominal and real components; history returns the daily real-yield, nominal-yield and breakeven time series for one maturity over a year. Live, no key, nothing stored. The real-yield / inflation-expectations data-cut — distinct from the nominal yield-curve, world-bond and central-bank-rate APIs.", "latest_d …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/realyields-api OpenAPI spec: https://www.oanor.com/api/realyields-api/openapi.json