{"uid":"cap_kAXds2Up8BA4xopnUbrpp","slug":"prereason-bitcoin-energy-cost-analysis-api-6e353468","name":"PreReason Bitcoin Energy Cost Analysis 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/energy","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":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.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_JLlwq1uLFci6ue5rkfCH8","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 production cost, hashprice, and energy pressure metrics for miners and market context","exampleAgentPrompt":"Pull the btc.energy briefing from PreReason to show me today's Bitcoin production cost, hashprice, and whether there's meaningful energy pressure on miners — give it to me in JSON format.","exampleUseCases":null,"resultDescription":"Returns a structured JSON object containing Bitcoin energy-related metrics including production cost (break-even price), hashprice, energy pressure signals, trend indicators, and confidence scores, along with a generated timestamp and briefing ID.","failureModes":["Missing or invalid 'briefing' query parameter returns 400 error","Date out of allowed range for subscription tier returns 403 or data-unavailable error","Invalid date format (not YYYY-MM-DD) returns validation error","Payment not completed or invalid x402 payment header returns 402 Payment Required","Network timeout on external data source returns 503"],"whenToPreferThis":"Use this endpoint when you need Bitcoin miner economics data specifically — production cost, hashprice, and energy pressure — as opposed to general price action, on-chain metrics, or macro context. Ideal for assessing whether Bitcoin is trading above or below miner break-even, evaluating miner capitulation risk, or understanding energy-driven selling pressure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:45:00.345Z","isFirstParty":false}