{"uid":"cap_2KMeDdI1NN7XM_RoFjMXc","slug":"prereason-bitcoin-grid-stress-api-216e115b","name":"PreReason Bitcoin Grid Stress API","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/grid","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.grid-stress"}}},"response":{"date":"2026-06-18","_timing":{"total_ms":815,"computedAt":"2026-06-18T06:03:13.243Z","metrics_ms":614,"correlations_ms":201,"tier_features_ms":0},"metrics":{"epoch-pace":{"name":"epoch-pace","trend":{"momentum":"accelerating","change_7d":-15.31,"direction":"falling","change_30d":-4.24,"change_90d":-3.89,"percentile":43,"percentile_label":"average"},"signal":"neutral","context":"Epoch pace at -2.9%: blocks mining faster than 10-min target. Hashrate increasing (new machines coming online or restarting). Difficulty increase likely at next adjustment, raising production cost and compressing miner margins.","timestamp":"2026-06-18T05:05:42.455+00:00","confidence":47,"regulatory_mode":"signal","value_formatted":"-2.9%","confidence_label":"Medium","confidence_factors":{"data_quality":100,"signal_strength":47,"percentile_score":60,"trend_consistency":20}},"hash-ribbon":{"name":"hash-ribbon","trend":{"momentum":"steady","change_7d":0,"direction":"flat","change_30d":0,"change_90d":-0.04,"percentile":11,"percentile_label":"low"},"signal":"bearish","context":"Hash Ribbon at 0.9869 (bearish, day 9).","timestamp":"2026-06-18T05:05:42.455+00:00","confidence":69,"regulatory_mode":"signal","value_formatted":"0.987","confidence_label":"Medium","confidence_factors":{"data_quality":100,"signal_strength":44,"percentile_score":97,"trend_consistency":75}},"bitcoin-hash-rate":{"name":"bitcoin-hash-rate","trend":{"momentum":"accelerating","change_7d":18.03,"direction":"rising","change_30d":7.4,"change_90d":4.7,"percentile":89,"percentile_label":"above-average growth"},"signal":"bullish","context":"Hash rate at 1005.82 EH/s, up 18.0% over 7d. Accelerating: network security strengthening, miners deploying capacity.","timestamp":"2026-06-17T00:00:00+00:00","confidence":90,"regulatory_mode":"signal","value_formatted":"1005.82 EH/s","confidence_label":"Very High","confidence_factors":{"data_quality":80,"signal_strength":100,"percentile_score":97,"trend_consistency":100}},"bitcoin-difficulty":{"name":"bitcoin-difficulty","trend":{"momentum":"accelerating","change_7d":-10.09,"direction":"falling","change_30d":-8.55,"change_90d":-6.62,"percentile":2,"percentile_label":"unusually slow or contracting"},"signal":"bearish","context":"Mining difficulty at 124.9T, down 8.6% over 30d. Decelerating: miner capitulation or difficulty adjustment underway.","timestamp":"2026-06-17T00:00:00+00:00","confidence":90,"regulatory_mode":"signal","value_formatted":"124.9T","confidence_label":"Very High","confidence_factors":{"data_quality":80,"signal_strength":100,"percentile_score":100,"trend_consistency":100}}},"correlations":{"hash-ribbon_vs_bitcoin-hash-rate":{"pair":"hash-ribbon_vs_bitcoin-hash-rate","value":-0.15,"metric1":"hash-ribbon","metric2":"bitcoin-hash-rate","interpretation":"No meaningful correlation (-0.15)"},"bitcoin-hash-rate_vs_bitcoin-difficulty":{"pair":"bitcoin-hash-rate_vs_bitcoin-difficulty","value":null,"metric1":"bitcoin-hash-rate","metric2":"bitcoin-difficulty","interpretation":"Insufficient variance: bitcoin-difficulty changes infrequently (10% of days had movement). Daily return correlation not meaningful for this pair.","unavailable_reason":"bitcoin-difficulty had meaningful daily returns on only 10% of days"}},"data_quality":{"severity":"ok","health_score":100,"metrics_total":4,"metrics_available":4,"correlations_total":2,"unavailable_metrics":[],"correlations_computable":2,"unavailable_correlations":[]},"generated_at":"2026-06-18T06:03:13.243Z","_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)"]},"basic_context":{"epoch-pace":"Blocks mining 2.9% faster than 10-min target (difficulty increase expected)","hash-ribbon":"Neutral zone (30d/60d hash rate MAs converged) - transitional period","bitcoin-hash-rate":"Total network computational power securing Bitcoin (higher = more secure)","bitcoin-difficulty":"Mining difficulty adjusts every 2016 blocks (~2 weeks) based on hash rate"},"briefing_used":"btc.grid-stress","briefing_metadata":{"name":"Grid Stress","tier":"free","data_access":"Today + last 30 days","description":"Mining network health - block production speed and upcoming difficulty adjustment forecast","metrics_count":4,"correlations_count":2,"earliest_usable_date":"2009-01-03","correlations_window_days":30}}},"exampleRequest":{"format":"json","briefing":"btc.grid-stress"},"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_bieVUymIuavCXsplWbWu3","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 grid stress analysis including epoch pace, difficulty adjustment forecasts, and miner pressure metrics as structured market context.","exampleAgentPrompt":"Pull me the btc.grid-stress briefing from PreReason in markdown format so I can see the current Bitcoin epoch pace, difficulty adjustment forecast, and miner pressure signals for today.","exampleUseCases":null,"resultDescription":"Returns a JSON or markdown document containing Bitcoin grid stress context: epoch pace, estimated difficulty adjustment percentage, miner production cost vs price pressure, and directional signals (bullish/bearish/neutral) with confidence scores and a generated_at timestamp.","failureModes":["Missing required 'briefing' query parameter returns a 400 validation error","Invalid briefing ID enum value returns a 400 bad request","Date outside the tier's allowed historical range returns a 403 or 402 payment required","Payment not provided or invalid returns a 402 Payment Required (x402)","Server-side data unavailability for the requested date returns a 503 or 404","Invalid date format (not YYYY-MM-DD) returns a 400 error"],"whenToPreferThis":"Use this endpoint when you specifically need Bitcoin mining network health data — epoch progression, difficulty adjustment outlook, and miner financial stress — rather than general price or macro context. Prefer this over btc.miner-survival for grid/epoch timing focus, and over btc.pulse for mining-specific signals rather than mempool or fee data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:40:08.778Z","isFirstParty":false}