Financial Intelligence API
Kronos provides a JSON API for multi-asset financial forecasts. Every endpoint is accessible via x402 micropayments — no API keys, no signup, no subscriptions. Pay per request with USDC on Solana or Base.
Quick start
curl -H "X-PAYMENT: <x402-payment-header>" \
https://kronos.seshat.markets/api/feeds/kronos/predict/btc_usdt?timeframes=1hSee how x402 payments work for the full payment flow.
Base URL
https://kronos.seshat.markets/apiHow does authentication work?
No API keys. All paid endpoints use x402 — the HTTP 402 status code. The client sends a USDC payment in the X-PAYMENT header, the server verifies the on-chain transfer, and returns the data. Free endpoints require no payment.
What are the API rate limits?
| Endpoint | Limit | Window |
|---|---|---|
| Predict (cached) | 10 | per minute per IP, 20/min per wallet |
| Predict (?refresh=true) | 2 | per minute per IP (refresh), 20/min per wallet |
| Playground | 3 | per 5 minutes per IP, 3/5min per wallet |
| Decision by ID | 30 | per 5 minutes per IP |
| On-demand discovery | 10 | new symbols per hour per IP |
All endpoints
Each endpoint has a dedicated page with examples, parameters, pricing, and use cases.
Predict
Multi-timeframe price-path forecasts with conformal ranges. The core endpoint.
Forecast Distribution
Full sample paths with p05–p95 percentiles for risk and distribution analysis.
Market Context
Cross-venue funding rates, open interest, liquidations, and options IV.
Similar Markets
Semantic search via embeddings — find historically similar resolved markets.
Accuracy Candles
Per-timeframe MAPE and MAE from 47k+ audited candles. Model diagnostics.
Risk History
Historical streak analytics — best and worst streaks per symbol and timeframe.
Decisions
Browse recent predictions with audit status, Brier score, and per-timeframe summary.
Forecast Evolution
How predictions change over time — direction flips, confidence drift, revisions.
Historical Analogs
Past situations similar to the current forecast. Empirical outcome evidence.
Regime Detection
Cross-symbol alignment — risk-on vs risk-off with aligned count and confidence.
Agent Track Record
Kronos as market voter — win rate, Brier score, per-coin breakdown.
Agent Votes
Recent votes with market context, confidence, rationale, and outcome.
Agent Signals
Live view of open markets where Kronos is actively voting right now.
Composite Signal
Quant vs Crowd divergence — agreement rates and who wins when they disagree.
Confluence
Quant vs sentiment vs crowd — AGREE/CONFLICT/NEUTRAL tags with confluence score.
AI Digest
Cross-referenced analysis combining 7 data sources. Surfaces contradictions.
Market Brief
AI narrative with sourced news, sentiment, events, and model alignment.
Outcome Stats
Outcome distribution of historically similar markets via semantic search.
Behavioral Correlations
How similarly agents reason — semantic correlation via rationale embeddings.
Rationale Novelty
Detect agents recycling templated reasoning vs genuine per-market analysis.
Playground
Custom GPU inference with adjustable temperature, top_p, and sample_count.
Full OpenAPI specification · Machine-readable registry · Integration guide
Which assets does the Kronos API support?
Crypto (BTC, ETH, SOL, and 50+ altcoins), commodities (gold, silver, oil), forex, and pre-market equities. The /predict endpoint also supports on-demand discovery for any valid Gate.io symbol.
SDKs and integrations
- curl — any HTTP client works. x402 is just HTTP with a payment header.
- Python —
requestsorhttpx. Use the official x402 Python SDK for automatic 402 handling. - JavaScript —
fetchor axios. Drop-in wrappers:@x402/fetchand@x402/axios. - LLM agents — fetch skill.md for agent-ready instructions, or read the OpenAPI spec directly.
See pricing & plans for the full price table — from $0.005 to $0.05 per request, no subscriptions.
Frequently asked questions
How do I use the crypto prediction API without an API key?
X-PAYMENT header. No signup, no dashboard, no key rotation.What assets does the Kronos financial intelligence API support?
/predict endpoint also supports on-demand discovery for any valid Gate.io symbol. See the models page for the full list.How much does the crypto forecast API cost?
Can AI agents autonomously call the Kronos API?
@x402/fetch or @x402/axios, and pay per request with USDC. No human in the loop.