{"uid":"cap_weNhK0ug4Yi9RcF0DSwZ2","slug":"prereason-btc-etf-flows-briefing-9aace3a8","name":"PreReason BTC ETF Flows Briefing","description":"PreReason delivers market context for financial agents. Bitcoin on-chain metrics, macro indicators, and reasoning context in one API call.","url":"https://api.prereason.com/api/btc/etf","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","required":["briefing"],"properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Historical date in YYYY-MM-DD format. Access range depends on tier: Free=30d, Basic=from Jan 2025, Pro=all."},"format":{"enum":["json","markdown"],"type":"string","description":"Response format. markdown is token-optimized for LLMs, json is structured."},"briefing":{"enum":["btc.quick-check","btc.context","btc.pulse","btc.grid-stress","macro.snapshot","cross.correlations","btc.momentum","btc.on-chain","btc.miner-survival","btc.etf-flows","macro.liquidity","cross.breadth","btc.full","btc.factors","btc.energy","btc.treasury","cross.regime","fx.liquidity"],"type":"string","description":"Briefing ID. 18 available: btc.quick-check, btc.context, btc.pulse, btc.grid-stress, macro.snapshot, cross.correlations (Tier 1), btc.momentum, btc.on-chain, btc.miner-survival, btc.etf-flows, macro.liquidity, cross.breadth (Tier 2), btc.full, btc.factors, btc.energy, btc.treasury, cross.regime, fx.liquidity (Tier 3)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"context":"Bitcoin trading at $84,200, up 4.2% over 7 days...","metrics":{"bitcoin_price":{"signal":"bullish","trend_7d":4.2,"confidence":82}},"briefing":"btc.quick-check","generated_at":"2026-03-17T12:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cnGI3tguf1RY8BlMvwuUm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns Bitcoin ETF flow data, on-chain metrics, and macro context as a structured briefing for financial AI agents","exampleAgentPrompt":"Pull the btc.etf-flows briefing from PreReason for today so I can see current Bitcoin ETF inflow and outflow signals and whether institutional demand looks bullish or bearish.","exampleUseCases":[{"title":"Daily BTC ETF flow check","prompt":"Get me today's Bitcoin ETF flows briefing — I want to know if institutions are buying or selling and what the overall signal looks like."},{"title":"Historical ETF flow analysis","prompt":"Pull the PreReason btc.etf-flows briefing for March 15, 2025 so I can compare how Bitcoin ETF demand looked around that date."},{"title":"Automated trading context pipeline","prompt":"Every morning, fetch the btc.etf-flows briefing in markdown format so my trading agent has the latest ETF flow context before it makes any decisions."}],"resultDescription":"A structured JSON or token-optimized markdown object containing Bitcoin ETF inflow/outflow metrics, a directional signal (bullish/bearish/neutral), a 7-day trend, a confidence score, and a generation timestamp. The 'context' field provides a plain-English summary ready for LLM consumption.","failureModes":["Invalid briefing ID returns 400 with enum validation error","Date out of tier access range returns 403 or 402 payment required","Missing required 'briefing' query parameter returns 400","Invalid date format (not YYYY-MM-DD) returns 400","Payment not received returns 402","Service unavailable or upstream data delay returns 503"],"whenToPreferThis":"Choose this endpoint when you need Bitcoin ETF-specific flow data combined with macro context in a single call, especially when feeding an AI agent that needs LLM-ready briefing text. Prefer over raw exchange APIs when you want pre-reasoned signals, confidence scores, and trend context without building your own aggregation layer. Best for automated financial agents that need daily or historical BTC ETF demand signals without post-processing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:40:59.498Z","isFirstParty":false}