Decisions — Browse Recent Predictions
The /decisions endpoint lets you browse recent predictions ordered by most recent first. Each decision includes a decision ID, symbol, consensus direction, audit status, Brier score, and per-timeframe summary (direction, change_pct, ranges). Filter by ?symbol, ?status (audited/auditing/pending), ?days, and ?limit. Use ?detail=1 to include full pred_candles arrays (default: stripped — use /decision/:id for single full detail). Without ?status, returns the most recent decisions regardless of audit state (audit fields will be null for pending decisions).
Endpoint
GET /api/feeds/kronos/decisions?symbol=btc_usdt&status=audited&days=30&limit=50Parameters
| Param | Type | Required | Description |
|---|---|---|---|
symbol | query | No | Filter to a single asset, e.g. btc_usdt |
status | query | No | Audit status: audited, auditing, or pending |
days | query | No | Lookback window in days (default: 30) |
limit | query | No | Max results (default: 50, max: 100, max 20 with ?detail=1) |
detail | query | No | 1 to include full pred_candles arrays (default: 0, stripped) |
Pricing
$0.001 per request (payment after delivery — settled only if the response is successfully sent).
Example request
curl -H "X-PAYMENT: <x402-payment-header>" \
"https://kronos.seshat.markets/api/feeds/kronos/decisions?symbol=btc_usdt&status=audited&limit=5"Example response (truncated)
{
"decisions": [
{
"decision_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"symbol": "btc_usdt",
"consensus": "up",
"predicted_at": "2025-06-15T14:30:00Z",
"audit_status": "audited",
"brier_score": 0.18,
"timeframes": {
"1h": { "direction": "up", "change_pct": 1.2, "correct": true },
"4h": { "direction": "up", "change_pct": 2.8, "correct": true }
}
},
{
"decision_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"symbol": "btc_usdt",
"consensus": "down",
"predicted_at": "2025-06-15T10:00:00Z",
"audit_status": "audited",
"brier_score": 0.31,
"timeframes": {
"1h": { "direction": "down", "change_pct": -0.5, "correct": true },
"4h": { "direction": "down", "change_pct": 0.3, "correct": false }
}
}
],
"total": 142,
"filtered": 5
}Use cases
Audit Trail
Every prediction creates a decision with a unique ID. Trace any signal from forecast to resolution — what was predicted, when, and whether it was correct.
Brier Score Screening
Filter by ?status=audited and sort by Brier score. Low-Brier decisions are high-quality predictions — use them as benchmarks for strategy calibration.
Per-Symbol Analysis
Filter by ?symbol=btc_usdt to see all recent BTC predictions. Spot patterns — does the model consistently call ETH better than SOL? Adjust your per-symbol trust accordingly.
Decision Replay
Use ?detail=1 to get full pred_candles for a decision. Replay the prediction candle-by-candle to understand exactly what the model expected vs what happened.
Frequently asked questions
How do I browse past crypto predictions with an API?
GET /api/feeds/kronos/decisions?symbol=btc_usdt&status=audited&limit=50. Each decision includes a decision ID, consensus direction, audit status, Brier score, and per-timeframe summary. Use ?detail=1 for full candle arrays.Can I trace a crypto prediction from forecast to resolution?
decision_id. Filter by ?status=audited to see only resolved predictions with Brier scores. Trace any signal from forecast to resolution — what was predicted, when, and whether it was correct.How much does the decisions API cost?
$0.001 per request (payment after delivery) — one of the cheapest endpoints. Pay with USDC on Solana or Base via x402. Use ?detail=1 for full candle data (max 20 results with detail).How do I filter crypto predictions by audit status?
?status parameter: audited (scored against actual prices), auditing (in progress), or pending (not yet scored). Without ?status, returns the most recent decisions regardless of audit state.