{"uid":"cap_rTI26y5fXlznjtxik24KT","slug":"prereason-treasury-auction-demand-4049f255","name":"PreReason Treasury Auction Demand","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/macro/auctions?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":{"treasury-2y":{"name":"treasury-2y"},"treasury-10y":{"name":"treasury-10y"},"treasury-30y":{"name":"treasury-30y"}},"briefing_used":"macro.auctions","briefing_metadata":{"name":"Treasury Auction Calendar and Dynamics","description":"Who bought at the latest auction of each Treasury note and bond maturity: size, high yield, bid-to-cover and the shares of primary dealers, direct and indirect bidders, each against that maturity's own prior auctions; then the auctions announced and scheduled next; then Treasury's newest buyback operations as its record states them (maturity bucket, maximum, par offered and accepted).","metrics_count":3,"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_zV9ZvJfBS9FaG-GpWgarm","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 the latest US Treasury auction statistics (size, high yield, bid-to-cover, dealer/direct/indirect bidder shares) for each maturity from 2Y to 30Y, with historical comparisons","exampleAgentPrompt":"Pull the latest Treasury auction results across all maturities — I want to see the bid-to-cover ratios and how much indirect bidders took at each, ideally in markdown format.","exampleUseCases":[{"title":"Macro briefing on bond demand","prompt":"Give me a summary of who showed up to the most recent Treasury auctions — I want bid-to-cover and the dealer vs indirect bidder breakdown for the 2Y, 10Y, and 30Y maturities."},{"title":"Monitor auction health after Fed decision","prompt":"After yesterday's Fed meeting, can you pull the latest Treasury auction demand data and tell me whether the bid-to-cover ratios look strong or weak relative to prior auctions?"},{"title":"Historical auction data for a specific date","prompt":"I'm building a rates model — can you fetch the Treasury auction statistics from 2024-11-15 in JSON format, including dealer shares and high yields for all available maturities?"}],"resultDescription":"Returns a structured dataset (JSON or token-optimized markdown) covering the latest auction of each Treasury maturity (2Y through 30Y): auction size, clearing yield, bid-to-cover ratio, and percentage shares taken by primary dealers, direct bidders, and indirect bidders — each benchmarked against prior auctions for that maturity. Also includes upcoming announced and scheduled auctions.","failureModes":["Date not found: requested ?date= has no auction record on file","Invalid date format: date parameter must match YYYY-MM-DD pattern","No auction on requested date: some dates have no scheduled auctions","Service unavailable: upstream data provider outage"],"whenToPreferThis":"Choose this endpoint when you need granular, per-maturity US Treasury auction demand metrics — specifically bid-to-cover ratios, bidder-type composition (dealers vs direct vs indirect), clearing yields, and historical comparisons. It is optimized for LLM consumption with a markdown format option, making it ideal for AI agent macro briefings, rates research, or bond market monitoring. Prefer this over generic financial data APIs when you need Treasury-specific auction microstructure data rather than yield curves or price feeds.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:38:20.436Z","isFirstParty":false,"canonicalSlug":"prereason-treasury-auction-demand-4049f255"}