GET /predict/:symbol?timeframes=
Fresh on-demand forecast for any supported asset (BTC, ETH, SOL, etc). Returns all timeframes by default, or filter with ?timeframes=5m,1h. $0.01 per timeframe, capped at $0.04 (20% off when requesting all 5). ?refresh=true forces GPU inference (bypasses cache) at 2x price ($0.02/TF, cap $0.08); synchronous refresh is rejected before payment and must use ?async=true. Synchronous reads remain available for fully cached predictions and small safe requests; requests needing three or more uncached timeframes return 409 async_required. Predict IP limits are checked before payment; payer rate limits apply to async mode before settlement. For long-running forecasts, ?async=true accepts a durable job using x402 authorization, returns 202 with job_id/status_url, and lets you poll GET /predict-jobs/{jobId} without another payment. A synchronous request needing inference while any GPU work is active returns 503 kronos_busy_use_async before payment. Async wallet/IP/force_fresh caps return 429 prediction_jobs_busy before settlement; a global queue cap returns 503 prediction_queue_full. A job failure appears as refund_due. Keep the returned job_id; if the 202 response is lost or a retry reuses an already-settled payment, contact support with the payment reference rather than blindly resubmitting. The public transaction is not a job lookup key. Horizon: 5m→6h, 15m→24h, 1h→2d, 4h→10d, 1d→14d.
Request
- Base URL: https://kronos.seshat.markets/api
- URL: https://kronos.seshat.markets/api/feeds/kronos/predict/{symbolKey}
- Auth: none declared
Path parameters
Kronos symbol key — on-demand discovery for any Gate.io symbol (crypto, stocks, forex, metals, commodities, indices). Curated: btc_usdt, eth_usdt, sol_usdt, xrp_usdt, bnb_usdt. On-demand examples: nvda_usdt, xauusd_usdt, eurusd_usdt, doge_usdt. Unknown symbols return 404 with available keys.
Query parameters
Comma-separated timeframes (5m, 15m, 1h, 4h, 1d). Defaults to all 5 for /predict, 5m for /forecast-distribution.
Set true or 1 to force fresh inference at the 2x timeframe price.
Set true or 1 to enqueue a durable job, receive 202 and poll status_url; omitted defaults to synchronous response.
Response
Kronos forecast response
Changes
No recorded changes to this operation across all 1 revision of this API.