{"uid":"cap_3TvOcGymNnCVszY14-3Yq","slug":"prereason-bitcoin-on-chain-health-api-7500ddd5","name":"PreReason Bitcoin On-Chain Health API","description":"Bitcoin on-chain analytics. Active addresses, MVRV proxy, hash rate, transaction volume. Blockchain network health for crypto research agents.","url":"https://api.prereason.com/api/btc/onchain?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":{"hash-ribbon":{"name":"hash-ribbon"},"bitcoin-price":{"name":"bitcoin-price"},"bitcoin-tx-count":{"name":"bitcoin-tx-count"},"bitcoin-hash-rate":{"name":"bitcoin-hash-rate"},"bitcoin-tx-volume":{"name":"bitcoin-tx-volume"},"bitcoin-difficulty":{"name":"bitcoin-difficulty"},"on-chain-velocity-30d":{"name":"on-chain-velocity-30d"},"bitcoin-active-addresses":{"name":"bitcoin-active-addresses"}},"briefing_used":"btc.on-chain","briefing_metadata":{"name":"On-Chain Health","description":"Bitcoin network deep-dive - hash rate, difficulty, transaction count, volume, and active addresses with trends","metrics_count":8,"correlations_count":2}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"format":"json","briefing":"btc.quick-check"}}},"response":{"date":"2026-06-12","_timing":{"total_ms":706,"computedAt":"2026-06-12T04:46:16.413Z","metrics_ms":489,"correlations_ms":217,"tier_features_ms":0},"metrics":{"hash-ribbon":{"name":"hash-ribbon","trend":{"momentum":"steady","change_7d":-0.02,"direction":"flat","change_30d":-0.02,"change_90d":-0.05,"percentile":11,"percentile_label":"low"},"signal":"bearish","context":"Hash Ribbon at 0.9866 (bearish, day 3).","timestamp":"2026-06-12T04:05:42.328+00:00","confidence":44,"regulatory_mode":"signal","value_formatted":"0.987","confidence_label":"Low","confidence_factors":{"data_quality":100,"signal_strength":19,"percentile_score":97,"trend_consistency":25}},"bitcoin-tx-count":{"name":"bitcoin-tx-count","trend":{"momentum":"accelerating","change_7d":3.87,"direction":"rising","change_30d":2.27,"change_90d":50.06,"percentile":93,"percentile_label":"extremely high"},"signal":"bullish","context":"Daily BTC transactions at 611,041, up 3.9% over 7d. Accelerating network usage.","timestamp":"2026-06-12T04:30:46.172+00:00","confidence":90,"regulatory_mode":"signal","value_formatted":"611,041","confidence_label":"Very High","confidence_factors":{"data_quality":100,"signal_strength":100,"percentile_score":100,"trend_consistency":100}},"bitcoin-hash-rate":{"name":"bitcoin-hash-rate","trend":{"momentum":"accelerating","change_7d":-5.9,"direction":"falling","change_30d":7.77,"change_90d":1,"percentile":34,"percentile_label":"below-average growth"},"signal":"neutral","context":"Hash rate at 932.13 EH/s, down 5.9% over 7d. Decelerating: miner stress or difficulty adjustment, capacity going offline.","timestamp":"2026-06-12T00:00:00+00:00","confidence":39,"regulatory_mode":"signal","value_formatted":"932.13 EH/s","confidence_label":"Low","confidence_factors":{"data_quality":100,"signal_strength":44,"percentile_score":28,"trend_consistency":20}},"bitcoin-tx-volume":{"name":"bitcoin-tx-volume","trend":{"momentum":"accelerating","change_7d":-26.15,"direction":"falling","change_30d":-15.77,"change_90d":1000,"percentile":97,"percentile_label":"extremely high"},"signal":"bullish","context":"BTC transaction volume at 47,821,611,900.7, down 26.1% over 7d. Decelerating large value transfers.","timestamp":"2026-06-12T01:00:46.929+00:00","confidence":76,"regulatory_mode":"signal","value_formatted":"47,821,611,900.7","confidence_label":"High","confidence_factors":{"data_quality":100,"signal_strength":100,"percentile_score":100,"trend_consistency":20}},"bitcoin-difficulty":{"name":"bitcoin-difficulty","trend":{"momentum":"steady","change_7d":0,"direction":"flat","change_30d":4.89,"change_90d":-4.2,"percentile":82,"percentile_label":"above-average growth"},"signal":"neutral","context":"Mining difficulty at 139.0T, +4.9% over 30d. Network competition intensifying: hashrate rising faster than expected.","timestamp":"2026-06-04T00:00:00+00:00","confidence":36,"regulatory_mode":"signal","value_formatted":"139.0T","confidence_label":"Low","confidence_factors":{"data_quality":30,"signal_strength":37,"percentile_score":0,"trend_consistency":60}},"on-chain-velocity-30d":{"name":"on-chain-velocity-30d","trend":{"momentum":"accelerating","change_7d":-3.16,"direction":"falling","change_30d":14.97,"change_90d":18.58,"percentile":79,"percentile_label":"high"},"signal":"neutral","context":"On-chain velocity at 1.30x (30d turnover), accelerating. Coins moving faster on-chain. Distribution and rotation increasing relative to held supply.","timestamp":"2026-06-12T04:05:42.328+00:00","confidence":32,"regulatory_mode":"signal","value_formatted":"1.30x","confidence_label":"Low","confidence_factors":{"data_quality":100,"signal_strength":38,"percentile_score":2,"trend_consistency":20}},"bitcoin-active-addresses":{"name":"bitcoin-active-addresses","trend":{"momentum":"accelerating","change_7d":-11.65,"direction":"falling","change_30d":-0.45,"change_90d":18.91,"percentile":44,"percentile_label":"average"},"signal":"neutral","context":"Active BTC addresses at 483,735, down 11.7% over 7d. Decelerating network participation: waning interest.","timestamp":"2026-06-11T00:00:00+00:00","confidence":57,"regulatory_mode":"signal","value_formatted":"483,735","confidence_label":"Medium","confidence_factors":{"data_quality":80,"signal_strength":48,"percentile_score":60,"trend_consistency":60}}},"correlations":{"bitcoin-hash-rate_vs_bitcoin-price":{"pair":"bitcoin-hash-rate_vs_bitcoin-price","value":0.02,"metric1":"bitcoin-hash-rate","metric2":"bitcoin-price","interpretation":"No meaningful correlation (+0.02)"},"bitcoin-active-addresses_vs_bitcoin-tx-volume":{"pair":"bitcoin-active-addresses_vs_bitcoin-tx-volume","value":0.49,"metric1":"bitcoin-active-addresses","metric2":"bitcoin-tx-volume","interpretation":"Moderate positive correlation (+0.49)"}},"data_quality":{"severity":"ok","health_score":100,"metrics_total":7,"metrics_available":7,"correlations_total":2,"unavailable_metrics":[],"correlations_computable":2,"unavailable_correlations":[]},"generated_at":"2026-06-12T04:46:16.413Z","_tier_context":{"your_tier":"free","related_briefings":[{"id":"btc.momentum","tier":"basic","description":"Adds multi-timeframe btc momentum (7d/30d/90d) with percentile rankings, 200-day moving average distance, 24h volume, 30d volume z-score (confirmation/non-confirmation overlay), hash-rate, dollar strength, and net-liquidity backdrop"},{"id":"btc.on-chain","tier":"basic","description":"Adds bitcoin network deep-dive"},{"id":"btc.miner-survival","tier":"basic","description":"Adds miner profitability check"},{"id":"btc.full","tier":"pro","description":"Adds causal reasoning, 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, narrative analysis, historical context"},{"id":"btc.treasury","tier":"pro","description":"Adds narrative analysis"},{"id":"btc.etf-flows","tier":"basic","description":"Adds spot btc etf flow read: net daily flows, aggregate aum (~$99b real, 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"}],"higher_tier_features":["Causal reasoning (Pro)","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.on-chain","briefing_metadata":{"name":"On-Chain Health","tier":"basic","data_access":"Today + last 30 days","description":"Bitcoin network deep-dive - hash rate, difficulty, transaction count, volume, and active addresses with trends","metrics_count":7,"correlations_count":2,"earliest_usable_date":"2009-01-03","correlations_window_days":30}}},"exampleRequest":{"format":"json","briefing":"btc.quick-check"},"tags":["x402"],"displayCostAmount":"0.02","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.02/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_TdgK2whYtl0BVRb-T1XEQ","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 on-chain health metrics including active addresses, MVRV proxy, and transaction data with trend signals.","exampleAgentPrompt":"Can you pull the btc.on-chain briefing from PreReason for today and give me the active addresses, MVRV proxy, and transaction metrics in JSON format?","exampleUseCases":null,"resultDescription":"Returns a JSON or markdown object containing Bitcoin on-chain health context including active address counts, MVRV proxy values, transaction volume metrics, trend signals (bullish/bearish), confidence scores, and a generated_at timestamp.","failureModes":["Invalid briefing ID returns 400 error — must use one of the 17 valid enum values","Date out of range for subscription tier returns access denied — Free tier limited to 30 days, Basic from Jan 2025","Missing required 'briefing' query parameter returns 400 validation error","Invalid date format (not YYYY-MM-DD) returns 400 pattern mismatch","Payment not completed returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need structured Bitcoin on-chain health data (active addresses, MVRV proxy, transaction metrics) with pre-computed trend signals and confidence scores, especially when building automated market context pipelines or LLM-friendly briefings via the markdown format option.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:30:45.905Z","isFirstParty":false,"canonicalSlug":"prereason-bitcoin-on-chain-health-api-7500ddd5"}