Returns a pre-reasoned market briefing for the requested domain.
Parameters
briefing (required) — Briefing ID, e.g. btc.quick-check, macro.snapshot, btc.full
format (optional) — markdown (default) or json
date (optional) — YYYY-MM-DD for historical data (Basic+ tiers)
Example: GET /api/context?briefing=btc.context&format=markdown
Short URL Shortcuts
GET /api/btc — btc.quick-check briefing
GET /api/macro — macro.snapshot briefing
GET /api/fx — fx.liquidity briefing
GET /api/btc/treasury — btc.treasury briefing
Other Endpoints
GET /api/metrics — List all available metrics with current values
GET /api/metrics/{name} — Get a specific metric with trend analysis
GET /api/health — API health check and data pipeline status
Response Format
Markdown responses include: signal direction (bullish/bearish/neutral), confidence score (0-100), 7d/30d/90d trend changes, percentile ranking against historical distribution, cross-asset correlation coefficients, and narrative text (Pro tier).
JSON responses include the same data in structured key-value format with typed fields.
Rate Limits
Free: 60 requests/hour, 500/day — 6 briefings, rolling 30-day data
Basic ($19.99/mo): 120 requests/hour, 2,000/day — 12 briefings, data from Jan 2025
Pro ($49.99/mo): 300 requests/hour, 5,000/day — all 18 briefings, full historical data
Enterprise: Custom limits and SLA
Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
MCP Server Integration
Install the PreReason MCP server for native tool access in Claude Desktop, Claude Code, Cursor, and Windsurf.
Install: npx -y @prereason/mcp
Set environment variable PREREASON_API_KEY to your API key.
btc.grid-stress (free) — Grid Stress: Mining network health - block production speed and upcoming difficulty adjustment forecast
btc.momentum (basic) — BTC Momentum: Multi-timeframe momentum (7d, 30d, 90d) with percentile rankings, 200-day moving average levels, and dollar strength
macro.liquidity (basic) — Liquidity Momentum: Fed balance, TGA, RRP, and M2 direction tracking with 7d/30d/90d trend changes
macro.auctions (basic) — Treasury Auction Calendar and Dynamics: Bid-to-cover ratios for the most recent 10Y and 30Y Treasury auctions, indirect bidder share, primary dealer takedown, and days to the next scheduled auction
cross.delta (basic) — Cross-Asset Delta and Regime Stability: Ranked metric movements since the prior cron snapshot, plus the regime-stability-flag counting how many cross-regime input signals flipped 7d direction in the last 24h
cross.full (pro) — Cross-Asset Full Picture: Omnibus cross-asset briefing: BTC, equities, volatility, dollar, full Treasury curve, breakevens, spot BTC ETF flows, central-bank policy spreads, and regime-stability flag in a single response
cross.inflation-regime (pro) — Inflation Regime: Full breakeven inflation curve (5Y to 30Y), 5y5y forward inflation expectation, monetary aggregates (M2, Fed balance), and DXY for inflation-regime classification
macro.rates (pro) — Yield Curve and Breakeven Inflation: Full Treasury yield curve (3M to 30Y), breakeven inflation across maturities, 5y5y forward inflation expectation, and the 10Y-3M recession-indicator spread
btc.on-chain (basic) — On-Chain Health: Bitcoin network deep-dive - hash rate, difficulty, transaction count, volume, and active addresses with trends
cross.breadth (basic) — Market Breadth: Risk appetite across S&P 500, Nasdaq, and small caps with Bitcoin correlation for each
btc.miner-survival (basic) — Miner Survival Index: Miner profitability check - revenue per hash, production cost tiers, and stress signals
btc.full (pro) — Full Context: Full Bitcoin analysis - price, macro overlay, momentum, percentiles, correlations, and narrative text
btc.factors (pro) — Factor Attribution: Rule-based "why is Bitcoin moving" with contributing macro and on-chain factors