{"uid":"cap_2XNiXjE8_i4gXuaQJc0q4","slug":"prereason-us-treasury-holders-full-briefing-62a63920","name":"PreReason US Treasury Holders Full Briefing","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/full?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.full","briefing_metadata":{"name":"US Treasury Holders","description":"Who holds Treasuries: 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; the Fed's own Treasury holdings, debt held by the public and the largest foreign holders; what changed, what would change each label and the next reports; then the 10 year yield and three bond funds.","metrics_count":4,"correlations_count":0}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Rue4rmAEKtTVR3iUxBfLY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a comprehensive briefing on who holds US Treasuries, including foreign investor net purchases (TIC), primary dealer position changes (NY Fed), speculator futures positions (CFTC), Fed holdings, and key bond market metrics.","exampleAgentPrompt":"Give me the full Treasury holders briefing — foreign investor TIC flows, primary dealer positioning, CFTC speculator futures data, the Fed's own holdings, and the 10-year yield — in markdown format for today.","exampleUseCases":[{"title":"Daily macro briefing for portfolio managers","prompt":"Pull the full US Treasury holders briefing for today — I want to see who's buying, who's selling, primary dealer position changes, CFTC speculator positioning in 10Y futures, and the current 10-year yield, all in markdown."},{"title":"Historical Treasury ownership snapshot","prompt":"Get me the full Treasury holder breakdown as of 2024-09-30 — TIC foreign investor flows, primary dealer 13-week position changes, speculator futures positioning, and the Fed's holdings — in JSON format so I can log it."},{"title":"Bond market context for AI agent research","prompt":"I need a complete picture of who holds US Treasuries right now — foreign investors, primary dealers, CFTC speculators, the Fed — plus the 10-year yield and the TLT, LQD, and HYG ETF levels, formatted as markdown."}],"resultDescription":"Returns a structured briefing with: foreign investor net purchases of long-term Treasuries (TIC), primary dealer 13-week change in positions (NY Fed), speculator 10-year note futures positions (CFTC), each benchmarked against historical context; the Fed's own Treasury holdings; debt held by the public; the largest foreign holders; what changed and what would change each metric; next report dates; the 10-year yield; and three bond ETF metrics (TLT, LQD, HYG). Available in token-optimized markdown or structured JSON.","failureModes":["Date not on record returns an error or empty dataset — only dates with available data are served","Invalid date format (not YYYY-MM-DD) returns a validation error","Invalid format parameter returns a bad request error","Network or payment failure results in a 402 or connection error","Data may lag behind real-time due to reporting cadences of source agencies (TIC, NY Fed, CFTC)"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, multi-source view of US Treasury ownership — combining TIC, NY Fed primary dealer data, CFTC futures positioning, and Fed holdings in a single call. Prefer this over the short/summary sibling endpoint when you need the full detail including ETF metrics, historical context, next report dates, and all foreign holder breakdowns. Ideal for macro research agents, portfolio analysis workflows, or daily fixed income briefings where completeness matters more than brevity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:40:57.334Z","isFirstParty":false,"canonicalSlug":"prereason-us-treasury-holders-full-briefing-62a63920"}