Predict API — Multi-Timeframe Price Forecasts
The /predict endpoint returns fresh, on-demand price-path forecasts for any supported asset. Each forecast includes direction (up/down), probability, conformal prediction intervals, and candle-by-candle price paths across 5 timeframes.
Endpoint
GET /api/feeds/kronos/predict/:symbolKey?timeframes=5m,1hParameters
| Param | Type | Required | Description |
|---|---|---|---|
symbolKey | path | Yes | Asset symbol, e.g. btc_usdt, eth_usdt, sol_usdt |
timeframes | query | No | Comma-separated: 5m,15m,1h,4h,1d (default: all 5) |
refresh | query | No | true forces GPU inference (bypasses cache). 2x price. |
Pricing
| Mode | Price | Cap |
|---|---|---|
| Cached (default) | $0.01/timeframe | $0.04 (all 5 TFs, 20% off) |
| Refresh (?refresh=true) | $0.02/timeframe | $0.08 (all 5 TFs) |
Example request
curl -H "X-PAYMENT: <x402-payment-header>" \
"https://kronos.seshat.markets/api/feeds/kronos/predict/btc_usdt?timeframes=1h,4h"Example response (truncated)
{
"symbol": "btc_usdt",
"timeframes": {
"1h": {
"direction": "up",
"upside_prob": 0.68,
"confidence": 0.72,
"horizon_hours": 2,
"conformal_lower": 67000,
"conformal_upper": 68500,
"current_price": 67250,
"pred_candles": [
{ "t": 1690000000, "o": 67250, "h": 67800, "l": 67100, "c": 67600, "p": 0.65 }
]
},
"4h": {
"direction": "up",
"upside_prob": 0.61,
"confidence": 0.58,
"horizon_hours": 10,
"conformal_lower": 66500,
"conformal_upper": 69200
}
},
"audited": true,
"decision_id": "a1b2c3d4-..."
}Horizons
| Timeframe | Horizon |
|---|---|
| 5m | 6 hours |
| 15m | 24 hours |
| 1h | 2 days |
| 4h | 10 days |
| 1d | 14 days |
Rate limits
- 10 requests/minute per IP (cached)
- 2 requests/minute per IP (?refresh=true)
- 3 refresh requests per 5 minutes per payer wallet
Cached predictions have a 5-15 minute TTL per timeframe. Use ?refresh=true for GPU-fresh inference at 2x price.
Use cases
Directional Trading
The core use case: upside_prob > 0.65 is a bullish signal, < 0.35 is bearish. Combine with conformal ranges to set entry, target, and stop-loss levels for any supported asset.
Risk-Adjusted Sizing
Use confidence to size positions. A 0.72 confidence signal deserves 2x the position size of a 0.55 signal. Confidence is the model's own quality estimate — respect it.
Multi-Timeframe Confluence
Request all 5 timeframes. If 5m, 15m, and 1h all say "up" but 4h says "down", the short-term signal is strong but contested. Trade the timeframe cluster with highest agreement.
Portfolio Construction
Call /predict for BTC, ETH, SOL, and XRP. Build a long-only portfolio weighted by upside_prob — the assets with the strongest bullish signals get the largest allocations.
Frequently asked questions
How accurate is the Kronos crypto prediction API?
What assets does the predict API support?
How much does the crypto price prediction API cost?
$0.01 per timeframe (cached), capped at $0.04 for all 5 timeframes (20% off). Use ?refresh=true for fresh GPU inference at 2x price. Pay with USDC on Solana or Base via x402.How do I get a Bitcoin price forecast via API?
GET /api/feeds/kronos/predict/btc_usdt?timeframes=1h,4h with an X-PAYMENT header. The response includes direction, upside probability, conformal ranges, and candle-by-candle price paths. See the API overview for the full flow.