{"uid":"cap_weNhK0ug4Yi9RcF0DSwZ2","slug":"prereason-btc-etf-flows-briefing-9aace3a8","name":"PreReason BTC ETF Flows Briefing","description":"Spot Bitcoin ETF flows. Daily net flows, cumulative flow, AUM with per-fund breakdown (IBIT, FBTC, GBTC). Spot Bitcoin ETF flow data for research agents. A paid call serves today or any ?date= on record.","url":"https://api.prereason.com/api/btc/etf?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":{"btc-etf-aum":{"name":"btc-etf-aum"},"bitcoin-price":{"name":"bitcoin-price"},"btc-etf-net-flow":{"name":"btc-etf-net-flow"},"btc-etf-fbtc-flow":{"name":"btc-etf-fbtc-flow"},"btc-etf-gbtc-flow":{"name":"btc-etf-gbtc-flow"},"btc-etf-ibit-flow":{"name":"btc-etf-ibit-flow"},"btc-etf-cumulative-flow":{"name":"btc-etf-cumulative-flow"},"etf-ibit-intraday-quote":{"name":"etf-ibit-intraday-quote"}},"briefing_used":"btc.etf-flows","briefing_metadata":{"name":"BTC ETF Flows","description":"Spot BTC ETF flow read: net daily flows, aggregate AUM (sourced from per-issuer pages), and per-issuer breakdown across iShares Bitcoin Trust (IBIT), Fidelity Wise Origin Bitcoin Fund (FBTC), Grayscale Bitcoin Trust (GBTC), and other approved spot ETFs","metrics_count":8,"correlations_count":1}}},"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_cnGI3tguf1RY8BlMvwuUm","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 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-10-28T06:36:06.862Z","isFirstParty":false,"canonicalSlug":"prereason-btc-etf-flows-briefing-9aace3a8"}