{"uid":"cap__mDtIiZQYi-LG0AOEuGut","slug":"us-treasury-yield-spread-calculator-4b853199","name":"US Treasury Yield Spread Calculator","description":"Returns the spread in percentage points between two US Treasury tenors on a date and whether it is inverted.","url":"https://macro-data-api-313m.onrender.com/v1/spread?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"a":{"type":"string","description":"Tenor: 1m, 1.5m, 2m, 3m, 4m, 6m, 1y, 2y, 3y, 5y, 7y, 10y, 20y, 30y"},"b":{"type":"string","description":"Tenor: 1m, 1.5m, 2m, 3m, 4m, 6m, 1y, 2y, 3y, 5y, 7y, 10y, 20y, 30y"},"date":{"type":"string","description":"Optional date YYYY-MM-DD. Default: latest available."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_aUnn7Yiwihaioqol3bjAh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the spread in percentage points between any two US Treasury yield curve tenors for a given date, and flags whether the spread is inverted.","exampleAgentPrompt":"What's the spread between the 2-year and 10-year US Treasury yields today, and is the curve inverted?","exampleUseCases":[{"title":"Real-time yield curve inversion alert","prompt":"Is the 3-month to 10-year Treasury spread inverted right now? I want to know the exact spread in basis points."},{"title":"Historical recession signal research","prompt":"What was the spread between the 2-year and 10-year US Treasuries on 2019-08-14, and was the curve inverted that day?"},{"title":"Custom tenor spread comparison","prompt":"Can you tell me the spread between the 5-year and 30-year Treasury yields for today and whether it's inverted?"}],"resultDescription":"Returns the spread in percentage points between two specified US Treasury tenors (tenor A yield minus tenor B yield), whether the spread is currently inverted (negative), and the date of the data. Includes the individual yield values for each tenor.","failureModes":["Invalid tenor code returns an error — only specific tenors (1m, 1.5m, 2m, 3m, 4m, 6m, 1y, 2y, 3y, 5y, 7y, 10y, 20y, 30y) are accepted","Date with no available Treasury data (weekends, federal holidays) may return an error or fall back to the nearest available date","Future dates return an error as data is not yet available","Render cold-start latency may cause occasional slow responses or timeouts","Network errors from the underlying data source may result in 500-level errors"],"whenToPreferThis":"Use this endpoint when you need a precise, point-in-time spread between any two specific US Treasury tenors, especially for yield curve inversion analysis. Prefer this over fetching the full yield curve when you only need a single spread value. Ideal for recession signal monitoring, fixed income analysis, or any workflow that needs to programmatically detect yield curve inversion between arbitrary tenor pairs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T02:25:13.934Z","isFirstParty":false,"canonicalSlug":"us-treasury-yield-spread-calculator-4b853199"}