{"uid":"cap_JGvY36WSwXeivX3JFC-tW","slug":"prereason-market-context-api-btc-quick-check-4926921d","name":"PreReason Market Context API – BTC Quick Check","description":"Bitcoin price analysis. BTC trend signals, net liquidity correlation, crypto market snapshot for AI trading agents and portfolio tools.","url":"https://api.prereason.com/api/btc?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":{"bitcoin-price":{"name":"bitcoin-price"},"net-liquidity":{"name":"net-liquidity"}},"briefing_used":"btc.quick-check","briefing_metadata":{"name":"Quick Check","description":"Quick directional read on Bitcoin price and net liquidity with their 30-day correlation","metrics_count":2,"correlations_count":1}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"format":"json","briefing":"btc.quick-check"}}},"response":{"date":"2026-06-18","_timing":{"total_ms":513,"computedAt":"2026-06-18T06:02:30.971Z","metrics_ms":365,"correlations_ms":148,"tier_features_ms":0},"metrics":{"bitcoin-price":{"name":"bitcoin-price","trend":{"momentum":"accelerating","change_7d":3.87,"direction":"rising","change_30d":-17,"change_90d":-9.42,"percentile":69,"percentile_label":"above average"},"signal":"neutral","context":"BTC at $63,864, up 3.9% over 7d. Accelerating upward - recent gains exceeding longer-term pace","timestamp":"2026-06-18T05:56:22+00:00","confidence":37,"regulatory_mode":"signal","value_formatted":"$63,864","confidence_label":"Low","confidence_factors":{"data_quality":100,"signal_strength":42,"percentile_score":22,"trend_consistency":20}},"net-liquidity":{"name":"net-liquidity","trend":{"momentum":"steady","change_7d":0.94,"direction":"flat","change_30d":0.13,"change_90d":1.52,"percentile":81,"percentile_label":"above-average growth"},"signal":"neutral","context":"Net liquidity stable at $5.89T. Consolidating.","timestamp":"2026-06-18T05:05:42.455+00:00","confidence":55,"regulatory_mode":"signal","value_formatted":"$5.89T","confidence_label":"Medium","confidence_factors":{"data_quality":100,"signal_strength":38,"percentile_score":0,"trend_consistency":100}}},"correlations":{"bitcoin-price_vs_net-liquidity":{"pair":"bitcoin-price_vs_net-liquidity","value":0.29,"metric1":"bitcoin-price","metric2":"net-liquidity","interpretation":"BTC weak positive correlation with Net Liquidity (+0.29)"}},"data_quality":{"severity":"ok","health_score":100,"metrics_total":2,"metrics_available":2,"correlations_total":1,"unavailable_metrics":[],"correlations_computable":1,"unavailable_correlations":[]},"generated_at":"2026-06-18T06:02:30.971Z","_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.quick-check","briefing_metadata":{"name":"Quick Check","tier":"free","data_access":"Today + last 30 days","description":"Quick directional read on Bitcoin price and net liquidity with their 30-day correlation","metrics_count":2,"correlations_count":1,"earliest_usable_date":"2003-03-19","correlations_window_days":30}}},"exampleRequest":{"format":"json","briefing":"btc.quick-check"},"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_VKwfaWBYfXo6NghmP9YTy","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 a 60-second snapshot of Bitcoin price, 7-day trend, and key bullish/bearish signals via the btc.quick-check briefing.","exampleAgentPrompt":"Give me a quick Bitcoin market check — current price, 7-day trend, and whether the signal is bullish or bearish, in JSON format.","exampleUseCases":null,"resultDescription":"A structured JSON object containing Bitcoin's current price, 7-day percentage trend, a bullish/bearish signal with confidence score (0-100), the briefing ID used, and a generated_at timestamp.","failureModes":["Invalid briefing ID returns 400 or validation error","Historical date out of tier access range returns 403 or empty data","Missing required 'briefing' query param returns 400","Payment not sent or invalid results in 402 Payment Required","Network timeout if upstream market data is unavailable"],"whenToPreferThis":"Use this endpoint when you need a fast, lightweight Bitcoin market snapshot with trend direction and a confidence signal, and you don't need deep on-chain data, miner metrics, or macro correlations. Ideal for quick status checks or pre-decision context gathering at minimal cost ($0.01/call).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:33:17.932Z","isFirstParty":false,"canonicalSlug":"prereason-market-context-api-btc-quick-check-4926921d"}