How to get the US Treasury yield curve with an API

Updated 2026-10-12

Use when an agent needs the US Treasury par yield curve for a given date.

From an MCP client, add https://tanod.dev/mcp and call treasury_yield_curve; its free daily calls are applied automatically, no key or signup.

POST to /v1/finance/treasury/yields for the latest US Treasury daily par yield curve, or send a date (YYYY-MM-DD) for a past one. Yields come back as numbers in percent for every published tenor, 1 month to 30 years.

Request

curl, using the free tier
curl -s -X POST https://tanod.dev/v1/finance/treasury/yields \
  -H 'content-type: application/json' -H 'X-Tanod-Free: 1' -d '{}'

Response

Response (live, trimmed)
{"date": "2026-10-07", "requested_date": null, "adjusted": false,
 "yields_pct": {"1 Mo": 4.07, "1.5 Mo": 4.13, "2 Mo": 4.14, "3 Mo": 4.22, "6 Mo": 4.28,
                "1 Yr": 4.42, "2 Yr": 4.77, "5 Yr": 5.03, "10 Yr": 5.28, "30 Yr": 5.67, ...}}

Dates

The Treasury publishes one curve per government-securities business day. Ask for a weekend or holiday and you get the nearest earlier published date, with adjusted: true and a note. Future dates are refused. Tenors that did not exist in a given year (the 1.5-month bill is recent) come back as null.

Limits and caveats

Source: the official daily par yield curve published by the US Department of the Treasury. Cached curves are eligible for refresh after six hours. While a refresh is pending or the source is unavailable, a copy fetched within the last 24 hours may be returned with stale: true; the curve's date remains the published date. The Treasury's site can be slow (10 to 20 seconds per calendar year of data fetched), so a request without an eligible cached copy may take longer near a year boundary. If the source is busy or unavailable and no eligible copy exists, the API returns an uncharged 503; retry shortly. Not investment advice.

Price and free allowance

USD 0.002 per call, paid in USDC on Base, Polygon, Solana, BNB Chain or Arbitrum with x402. 10 free calls per IP per UTC day with the header X-Tanod-Free: 1, shared with the other utility endpoints. MCP tool: treasury_yield_curve at https://tanod.dev/mcp, where the free tier is automatic.

All endpoints →

Use it from Claude without writing code: in claude.ai or Claude Desktop, add https://tanod.dev/mcp/finance?via=treasury-yield-curve-api as a custom connector (steps), then ask in plain words, for example "What did the US Treasury yield curve look like on 2 January 2026?" The free daily allowance is applied automatically over MCP. Beyond it a call needs an x402 payment, which these clients can make.

Related guides: Hosted SEC and Treasury MCP server, SEC EDGAR company and filings API, Exchange rates API. Back to tanod.dev or the guide index.