{"uid":"cap_ts3-L8DSJ3XkD7_Sq2VWP","slug":"prereason-market-context-api-bitcoin-on-chain-context-btc-context-c72f15da","name":"PreReason Market Context API – Bitcoin On-Chain Context (btc.context)","description":"Bitcoin context with on-chain and liquidity data. Active addresses, hash ribbon, difficulty, momentum signals. Intermediate BTC intelligence for AI agents.","url":"https://api.prereason.com/api/btc/context?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"},"net-liquidity":{"name":"net-liquidity"},"bitcoin-hash-rate":{"name":"bitcoin-hash-rate"},"bitcoin-difficulty":{"name":"bitcoin-difficulty"}},"briefing_used":"btc.context","briefing_metadata":{"name":"BTC Context","description":"Bitcoin price, mining health, and liquidity overview with 7-day and 30-day trend signals","metrics_count":5,"correlations_count":1}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"format":"json","briefing":"btc.context"}}},"response":{"date":"2026-06-12","_timing":{"total_ms":735,"computedAt":"2026-06-12T04:46:09.980Z","metrics_ms":490,"correlations_ms":245,"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-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}},"net-liquidity":{"name":"net-liquidity","trend":{"momentum":"steady","change_7d":0.42,"direction":"flat","change_30d":1.14,"change_90d":1.53,"percentile":64,"percentile_label":"moderate growth"},"signal":"neutral","context":"Net liquidity stable at $5.90T. Consolidating.","timestamp":"2026-06-12T04:05:42.328+00:00","confidence":64,"regulatory_mode":"signal","value_formatted":"$5.90T","confidence_label":"Medium","confidence_factors":{"data_quality":100,"signal_strength":44,"percentile_score":32,"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-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}}},"correlations":{"bitcoin-price_vs_net-liquidity":{"pair":"bitcoin-price_vs_net-liquidity","value":0.38,"metric1":"bitcoin-price","metric2":"net-liquidity","interpretation":"BTC weak positive correlation with Net Liquidity (+0.38)"}},"data_quality":{"severity":"ok","health_score":100,"metrics_total":5,"metrics_available":5,"correlations_total":1,"unavailable_metrics":[],"correlations_computable":1,"unavailable_correlations":[]},"generated_at":"2026-06-12T04:46:09.980Z","_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.context","briefing_metadata":{"name":"BTC Context","tier":"free","data_access":"Today + last 30 days","description":"Bitcoin price, mining health, and liquidity overview with 7-day and 30-day trend signals","metrics_count":5,"correlations_count":1,"earliest_usable_date":"2009-01-03","correlations_window_days":30}}},"exampleRequest":{"format":"json","briefing":"btc.context"},"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.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qpUp67DS5qnMp2Al6K1Ct","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 on-chain context including active addresses, transaction volume, and momentum signals for a given date.","exampleAgentPrompt":"Pull me the Bitcoin on-chain context briefing from PreReason for today — I want active addresses, transaction volume, and momentum signals in JSON format.","exampleUseCases":null,"resultDescription":"Returns a structured object containing a natural-language context summary of Bitcoin on-chain activity, plus a metrics object with signals (e.g. bullish/bearish), 7-day trend values, and confidence scores for active addresses and transaction volume. Includes the briefing ID and generation timestamp.","failureModes":["Missing required 'briefing' query parameter returns 400 error","Invalid date format (not YYYY-MM-DD) returns validation error","Date out of range for subscription tier returns 403 or tier-restriction error","Payment not received or x402 payment header missing returns 402 Payment Required","Unknown briefing ID enum value returns 400 invalid parameter error","Server-side data unavailability for requested date returns 503 or empty metrics"],"whenToPreferThis":"Choose this endpoint when you specifically need Bitcoin on-chain metrics — active addresses, transaction volume, and momentum signals — rather than price action, miner health, or macro liquidity. Use btc.context over btc.quick-check when you want deeper network activity signals rather than a simple price snapshot, and over btc.on-chain when you want momentum alongside on-chain data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:38:36.334Z","isFirstParty":false,"canonicalSlug":"prereason-market-context-api-bitcoin-on-chain-context-btc-context-c72f15da"}