{"uid":"cap_R3AdfKYUu8D5phgfeaZGx","slug":"prereason-btc-pulse-briefing-8b8def8a","name":"PreReason BTC Pulse 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/pulse","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":{"request":{"input":{"type":"http","method":"GET","queryParams":{"format":"json","briefing":"btc.pulse"}}},"response":{"date":"2026-06-12","_timing":{"total_ms":515,"computedAt":"2026-06-12T04:46:13.397Z","metrics_ms":358,"correlations_ms":157,"tier_features_ms":0},"metrics":{"bitcoin-price":{"name":"bitcoin-price","trend":{"momentum":"steady","change_7d":-0.2,"direction":"flat","change_30d":-20.92,"change_90d":-10.57,"percentile":69,"percentile_label":"above average"},"signal":"neutral","context":"BTC at $63,626, flat over 7d. Consolidating.","timestamp":"2026-06-12T04:42:29+00:00","confidence":49,"regulatory_mode":"signal","value_formatted":"$63,626","confidence_label":"Medium","confidence_factors":{"data_quality":100,"signal_strength":42,"percentile_score":22,"trend_consistency":60}},"bitcoin-dominance":{"name":"bitcoin-dominance","trend":{"momentum":"steady","change_7d":0.55,"direction":"flat","change_30d":-1.9,"change_90d":-0.5,"percentile":35,"percentile_label":"below average"},"signal":"neutral","context":"BTC dominance stable at 56.4%. Consolidating: no rotation signal.","timestamp":"2026-06-12T04:42:29+00:00","confidence":64,"regulatory_mode":"signal","value_formatted":"56.4%","confidence_label":"Medium","confidence_factors":{"data_quality":100,"signal_strength":44,"percentile_score":30,"trend_consistency":100}},"bitcoin-change-24h":{"name":"bitcoin-change-24h","trend":{"momentum":"accelerating","change_7d":2.1,"direction":"rising","change_30d":3.23,"change_90d":1.39,"percentile":67,"percentile_label":"above average"},"signal":"neutral","context":"BTC 24h change at +1.68%, up. Strong short-term momentum: Accelerating above average daily moves.","timestamp":"2026-06-12T04:42:29+00:00","confidence":38,"regulatory_mode":"signal","value_formatted":"1.68","confidence_label":"Low","confidence_factors":{"data_quality":100,"signal_strength":43,"percentile_score":26,"trend_consistency":20}}},"correlations":{"bitcoin-price_vs_bitcoin-dominance":{"pair":"bitcoin-price_vs_bitcoin-dominance","value":-0.12,"metric1":"bitcoin-price","metric2":"bitcoin-dominance","interpretation":"No meaningful correlation (-0.12)"}},"data_quality":{"severity":"ok","health_score":100,"metrics_total":3,"metrics_available":3,"correlations_total":1,"unavailable_metrics":[],"correlations_computable":1,"unavailable_correlations":[]},"generated_at":"2026-06-12T04:46:13.397Z","_tier_context":{"your_tier":"free","related_briefings":[{"id":"btc.momentum","tier":"basic","description":"Adds percentile rankings, extended 90d momentum"},{"id":"btc.on-chain","tier":"basic","description":"Adds percentile rankings, extended 90d momentum"},{"id":"btc.miner-survival","tier":"basic","description":"Adds percentile rankings, extended 90d momentum"},{"id":"btc.full","tier":"pro","description":"Adds causal reasoning, percentile rankings, extended 90d momentum, narrative analysis, historical context"},{"id":"btc.factors","tier":"pro","description":"Adds causal reasoning, narrative analysis, historical context"},{"id":"btc.energy","tier":"pro","description":"Adds causal reasoning, percentile rankings, extended 90d momentum, narrative analysis, historical context"},{"id":"btc.treasury","tier":"pro","description":"Adds narrative analysis"},{"id":"btc.etf-flows","tier":"basic","description":"Adds percentile rankings, extended 90d momentum"}],"higher_tier_features":["Causal reasoning (Pro)","Percentile rankings (Basic+)","Extended 90d momentum (Basic+)","Narrative analysis (Pro)","Regime classification (Pro)","Divergence detection (Pro)","Historical context (Pro)","Extended historical data from Jan 2025 (Basic+)","Full historical data access (Pro)"]},"briefing_used":"btc.pulse","briefing_metadata":{"name":"BTC Pulse","tier":"free","data_access":"Today + last 30 days","description":"Quick price action check - price, 24h change, dominance","metrics_count":3,"correlations_count":1,"earliest_usable_date":"2010-08-18","correlations_window_days":30}}},"exampleRequest":{"format":"json","briefing":"btc.pulse"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wYNU8pXCyBwG8P3xNbjEr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns Bitcoin volume, transaction fees, and mempool activity with trend signals as a pulse-style market briefing.","exampleAgentPrompt":"Give me a Bitcoin pulse briefing — I want to see current volume, fee levels, and mempool activity with trend signals to understand network congestion right now.","exampleUseCases":null,"resultDescription":"Returns a structured briefing (JSON or markdown) with Bitcoin price context, volume metrics, mempool activity, transaction fee levels, trend signals (bullish/bearish), confidence scores, and a generated_at timestamp.","failureModes":["Invalid briefing ID returns error — must use 'btc.pulse'","Date out of tier range (Free plan limited to 30d history) returns access error","Invalid date format (not YYYY-MM-DD) returns validation error","Payment not completed returns 402 Payment Required","Invalid format enum value returns 400 error"],"whenToPreferThis":"Use this endpoint when you need a focused snapshot of Bitcoin network activity — specifically volume, fees, and mempool — with trend signals. Prefer over btc.quick-check when network-layer metrics (not just price) are the primary concern, and over btc.on-chain when you want a concise pulse rather than a deep on-chain health report.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:38:25.727Z","isFirstParty":false}