---
title: "Get context briefing"
method: GET
path: "/api/context"
tags: ["Context"]
---

# Get context briefing

`GET /api/context`

The primary endpoint for consuming PreReason data. Returns a pre-computed context bundle
for the requested briefing, including metrics, trend analysis, confidence scores,
and causal reasoning.

Briefings are tier-gated. Free tier has access to 6 briefings, Basic to 12, Pro to all 18.

**Available briefings:**
- `btc.quick-check` (Free) - Fast BTC snapshot: price, hashrate, fees, dominance
- `btc.context` (Free) - Full Bitcoin market context with on-chain + macro
- `btc.pulse` (Free) - BTC sentiment pulse: price action, volume, active addresses
- `btc.grid-stress` (Free) - Mining grid stress: hashprice, difficulty, production cost
- `macro.snapshot` (Free) - Macro environment: liquidity, yields, equities, FX
- `cross.correlations` (Free) - Cross-asset correlation matrix with interpretations
- `btc.momentum` (Basic) - Momentum with percentile rankings, 200D MA support/resistance, DXY
- `btc.on-chain` (Basic) - On-chain fundamentals: MVRV, hash ribbon, tx metrics
- `btc.miner-survival` (Basic) - Miner economics: hashprice, breakeven, capitulation risk
- `macro.liquidity` (Basic) - Deep liquidity analysis: Fed, RRP, TGA, M2, net liquidity
- `cross.breadth` (Basic) - Market breadth across equities, crypto, macro
- `btc.etf-flows` (Basic) - Spot BTC ETF net daily flows, aggregate AUM, and per-issuer breakdown (IBIT, FBTC, GBTC, others)
- `btc.full` (Pro) - Comprehensive BTC analysis (all metrics combined)
- `btc.factors` (Pro) - Multi-factor model with weighted signals
- `btc.energy` (Pro) - Energy-based valuation: production cost, thermocap
- `btc.treasury` (Pro) - Public company BTC treasury holdings intelligence
- `cross.regime` (Pro) - Market regime detection with divergence alerts, yield curve, USDT.D risk sentiment
- `fx.liquidity` (Pro) - FX and global liquidity flows

## Query parameters

- `briefing` 'btc.quick-check' | 'btc.context' | 'btc.pulse' | 'btc.grid-stress' | 'macro.snapshot' | 'cross.correlations' | 'btc.momentum' | 'btc.on-chain' | 'btc.miner-survival' | 'macro.liquidity' | 'cross.breadth' | 'btc.etf-flows' | 'btc.full' | 'btc.factors' | 'btc.energy' | 'btc.treasury' | 'cross.regime' | 'fx.liquidity', required
- `format` 'json' | 'markdown'
- `date` string

## Response `200`

Context data for the requested briefing

- object — Structure varies by briefing. All include generated_at timestamp.

## Other responses

- `400` — Missing or invalid briefing parameter
- `401` — Authentication required
- `403` — Briefing not available on your tier, or date outside tier access
- `404` — Briefing does not exist
- `410` — Briefing has been deprecated and merged into another
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/prereason/apis/prereason-api.md) · [All operations](https://skmtc.dev/prereason/apis/prereason-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/prereason/prereason-api/revisions/2a607b0906fc/schema)