PreReason
Every financial API gives you numbers. Your agent then has to figure out what those numbers mean, how they relate to each other, whether they're high or low historically, and what direction they're moving. That interpretation step is where agents fail. PreReason does the interpretation before your agent ever sees the data. One API call returns a complete market briefing with trend direction,…
PreReason endpoints
| Method | Endpoint | Description |
|---|---|---|
| Context | ||
| GET |
getContext /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… |
| GET |
listBriefings /api/context/briefings |
Returns all briefings available for your tier, with descriptions and metadata. Useful for agents to discover what context is available before requesting it. |
| Metrics | ||
| GET |
listMetrics /api/metrics |
Returns all 26 available metrics with their names, descriptions, and categories. Use this to discover what individual metrics are available. |
| GET |
getBtcPriceHistory /api/metrics/bitcoin-price/history |
Daily BTC price time series. Tier-gated date ranges: - **Free**: Rolling 30-day window - **Basic**: From January 1, 2025 - **Pro/Enterprise**: All available data (2009+) |
| GET |
getMetric /api/metrics/{metric} |
Returns signal analysis for a single metric: trend (7d/30d/90d), momentum, confidence score, percentile ranking, and data quality. **Available metrics (26):** **Bitcoin:**… |
| Short URLs | ||
| GET |
shortCrossRegime /api/cross/regime |
Alias for `GET /api/context?briefing=cross.regime`. Pro tier. |
| GET |
shortFx /api/fx |
Alias for `GET /api/context?briefing=fx.liquidity`. Pro tier. |
| GET |
shortBtcEnergy /api/btc/energy |
Alias for `GET /api/context?briefing=btc.energy`. Pro tier. |
| GET |
shortBtcContext /api/btc/context |
Alias for `GET /api/context?briefing=btc.context`. Free tier. |
| GET |
shortBtcMomentum /api/btc/momentum |
Alias for `GET /api/context?briefing=btc.momentum`. Basic tier. |
| GET |
shortBtcPulse /api/btc/pulse |
Alias for `GET /api/context?briefing=btc.pulse`. Free tier. |
| GET |
shortBtcFull /api/btc/full |
Alias for `GET /api/context?briefing=btc.full`. Pro tier. |
| GET |
shortBtc /api/btc |
Alias for `GET /api/context?briefing=btc.quick-check`. Free tier. |
| GET |
shortBtcGrid /api/btc/grid |
Alias for `GET /api/context?briefing=btc.grid-stress`. Free tier. |
| GET |
shortBtcOnchain /api/btc/onchain |
Alias for `GET /api/context?briefing=btc.on-chain`. Basic tier. |
| GET |
shortBtcFactors /api/btc/factors |
Alias for `GET /api/context?briefing=btc.factors`. Pro tier. |
| GET |
shortBtcMiners /api/btc/miners |
Alias for `GET /api/context?briefing=btc.miner-survival`. Basic tier. |
| GET |
shortMacroLiquidity /api/macro/liquidity |
Alias for `GET /api/context?briefing=macro.liquidity`. Basic tier. |
| GET |
shortBtcTreasury /api/btc/treasury |
Alias for `GET /api/context?briefing=btc.treasury`. Pro tier. |
| GET |
shortMacro /api/macro |
Alias for `GET /api/context?briefing=macro.snapshot`. Free tier. |
| GET |
shortCrossCorrelations /api/cross/correlations |
Alias for `GET /api/context?briefing=cross.correlations`. Free tier. |
| GET |
shortCrossBreadth /api/cross/breadth |
Alias for `GET /api/context?briefing=cross.breadth`. Basic tier. |
| System | ||
| GET |
getVersionConfig /api/version |
Returns current API version and supported versions. No authentication required. |
| GET |
getHealth /api/health |
Returns API health status. No authentication required. |
| GET |
getOpenApiJson /api/openapi/spec.json |
Returns this OpenAPI specification in JSON format. |
| POST |
mcpEndpoint /api/mcp |
Stateless Streamable HTTP transport for MCP-compatible AI agents. Provides 5 tools: get_context, get_metric, list_briefings, list_metrics, get_health. Configure in your MCP… |
| GET |
getOpenApiYaml /api/openapi/spec.yaml |
Returns this OpenAPI specification in YAML format. |
| GET |
getHeadline /api/headline |
Returns 2-3 key market metrics for display (e.g., login page, dashboards). Cached 5 minutes. No authentication required. |
| GET |
getStatus /api/status |
Public system status page data. Returns operational status for API, database, and data pipeline components. No authentication required. |
PreReason pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC Recommended | Free | 60 / hour |
|