{"uid":"cap_BDZ7b8KoWxxxEoORv-GbR","slug":"prereason-us-treasury-holders-context-200acb58","name":"PreReason US Treasury Holders Context","description":"Financial market context for AI agents: macro, rates, bonds, FX, commodities, companies and Bitcoin. One API call returns a briefing with the reasoning already in it.","url":"https://api.prereason.com/api/bonds/context?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"],"type":"string"},"queryParams":{"type":"object","properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Historical date in YYYY-MM-DD format. A paid call serves today or any ?date= on record."},"format":{"enum":["json","markdown"],"type":"string","description":"Response format. markdown is token-optimized for LLMs, json is structured. Default is markdown."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"metrics":{"etf-hyg":{"name":"etf-hyg"},"etf-lqd":{"name":"etf-lqd"},"etf-tlt":{"name":"etf-tlt"},"treasury-10y":{"name":"treasury-10y"}},"briefing_used":"bonds.context","briefing_metadata":{"name":"US Treasury Holders: Short Form","description":"Who holds Treasuries, in short: foreign investors' net purchases (Treasury's TIC), primary dealers' 13 week change in positions (the New York Fed) and speculators' 10 year note futures position (the CFTC), each against its own history; then the 10 year yield and three bond funds.","metrics_count":4,"correlations_count":0}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0y-gGSh02sdA-WJofy68f","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a structured briefing on who holds US Treasuries, combining TIC foreign investor flows, NY Fed primary dealer positions, and CFTC speculator futures data alongside the 10Y yield and key bond ETFs.","exampleAgentPrompt":"Give me the latest PreReason Treasury holders briefing — who's buying or selling US Treasuries right now, including foreign investor flows, primary dealer positions, and speculator futures bets, formatted as markdown.","exampleUseCases":[{"title":"Daily bond market positioning check","prompt":"Pull today's Treasury holders context from PreReason — I want to see foreign investor TIC flows, what primary dealers are doing with their positions, and where speculators are sitting in 10Y futures."},{"title":"Historical Treasury demand analysis","prompt":"Get me the PreReason Treasury holders briefing for 2023-10-15 in JSON format so I can see who was holding Treasuries during that period of elevated yields."},{"title":"Bond ETF and yield context for macro report","prompt":"I'm writing a macro report — can you grab the PreReason bonds context briefing so I have the 10-year yield alongside the TLT, LQD, and HYG ETF readings and the full Treasury positioning breakdown?"}],"resultDescription":"Returns a briefing with 4 financial metrics: foreign net purchases of long-term Treasuries (TIC data), NY Fed primary dealer 13-week position changes, CFTC speculator 10Y note futures positioning, and the 10-year Treasury yield, plus bond ETF data for TLT, LQD, and HYG. Each metric carries pre-reasoned trend context. Available in markdown (LLM-optimized) or structured JSON.","failureModes":["Requested historical date not available in the dataset — returns error or empty data","Invalid date format (not YYYY-MM-DD) causes schema validation failure","Invalid format parameter value returns error","Network or payment authorization failure (x402 payment required at $0.03 USDC per call)","Stale data if underlying TIC, NY Fed, or CFTC sources have not yet published for a recent date"],"whenToPreferThis":"Choose this endpoint when you need a consolidated, pre-reasoned view of US Treasury market positioning across the three major participant groups (foreign investors, primary dealers, speculators) in a single call. It is ideal for macro research, bond market monitoring, and LLM-based financial briefings where token-efficient markdown output is valuable. Prefer this over raw data APIs when you want interpretive context layered onto the raw figures, or when you need bond ETF data alongside yield and positioning in one response.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:44:11.748Z","isFirstParty":false,"canonicalSlug":"prereason-us-treasury-holders-context-200acb58"}