# Kronos Crypto Data API > Real-time crypto market data for autonomous agents and trading bots — derivatives, spot price, liquidations, options IV, macro, and more. > 17 assets (BTC/ETH/SOL/BNB/XRP/DOGE/ADA/AVAX/LINK/DOT/LTC/TRX/BCH/ATOM/NEAR/APT/HYPE). HYPE is derivatives-only: liquidations, signals, alerts and funding, no forecast/OHLC/vol. > USDC micropayments on Base via x402 protocol. No API keys required. > Base URL: https://kronossignals.com ## Paid Tools Paths containing {asset} are templates: replace {asset} with a slug from that tool's Assets line, e.g. GET https://kronossignals.com/api/v1/liquidations/btc. ### /api/v1/liquidations/{asset} — $0.02 USDC/call Forward liquidation cluster map + recent OKX prints. Estimated liq price levels for 5x/10x/25x/50x leverage bands from OI + mark price. Includes squeeze_bias (long_squeeze_risk/short_squeeze_risk/balanced). Honest model disclaimers. Assets: btc, eth, sol, bnb, xrp, doge, ada, avax, link, dot, ltc, trx, bch, atom, near, apt, hype ### /api/v1/alerts/{asset} — $0.02 USDC/call Market-regime alerts for any asset: squeeze, breakout, funding_extreme, oi_surge events from the Kronos regime engine (last 2h). Includes live funding + OI derived state. Assets: btc, eth, sol, bnb, xrp, doge, ada, avax, link, dot, ltc, trx, bch, atom, near, apt, hype ### /api/v1/signals/{asset} — $0.02 USDC/call Perpetual swap derivatives intelligence. Returns funding_rate, funding_rate_annualized, mark/index price, basis, OI, OI 1h change, funding trend, plain-language read. Assets: btc, eth, sol, bnb, xrp, doge, ada, avax, link, dot, ltc, trx, bch, atom, near, apt, hype ### /api/v1/funding-extremes — $0.02 USDC/call All 17 perpetual futures markets ranked by absolute funding rate. Identifies crowded positions and squeeze risk across the market. ### /api/v1/funding-arb/{asset} — $0.02 USDC/call Cross-venue funding arbitrage signal. Queries up to 6 exchanges (Binance/OKX/Bybit/KuCoin/Bitget/Hyperliquid) for real-time 8h-equivalent funding rates (venues_count says how many answered) and computes the gross and net-of-fees spread between the best short venue (highest rate) and best long venue (lowest rate). Returns gross_spread_bps, net_spread_bps (after 20 bps conservative round-trip fee), annualized_pct, actionability label (not_actionable/marginal/actionable), per-venue rates with OI, OI-weighted average, and dispersion stats. Outcome recorded to funding_arb_signals. Computed facts only — not a profit forecast. Assets: btc, eth, sol, bnb, xrp, doge, ada, avax, link, dot, ltc, trx, bch, atom, near, apt, hype ### /api/v1/cex-premium/{asset} — $0.02 USDC/call Coinbase price premium vs composite median (OKX + Kraken + Binance). premium_pct = (coinbase/composite_median − 1) × 100. Positive = US/institutional demand bias. 30d z-score and 24h percentile from cex_premium_history (hourly cron). Coinbase-listed assets only. Assets: btc, eth, sol, xrp, doge, ada, avax, link, dot, ltc, bch, atom, near ### /api/v1/gex/{asset} — $0.04 USDC/call Gamma Exposure (GEX) and max-pain options tool from Deribit. Aggregate GEX strike ladder (dealer-convention net gamma per strike), gamma flip level (zero-cumulative-GEX strike), spot regime above/below flip, max-pain strikes for the upcoming weekly and nearest monthly expiries, expected-move cone (ATM-IV-derived 1-sigma, front expiry), and a heuristic pin-risk score (0-1). 15-minute in-memory cache. Assets: btc, eth ### /api/v1/options-iv/{asset} — $0.03 USDC/call Implied volatility surface from Deribit (fallback OKX). ATM IV, IV rank/percentile (from iv_history daily cron), term structure (weekly/1m/3m ATM IV + contango/backwardation/flat shape), 25-delta risk reversal, 10-delta wing IVs, max-pain strike, vol regime label. 1-hour cache. BTC and ETH only. Assets: btc, eth ### /api/v1/implied-prob/{asset} — $0.02 USDC/call Options-implied probability that BTC or ETH is above each of up to 25 prices at a target time, backed out of the Deribit option book (skew-inclusive call-spread digitals; total variance interpolated between expiries). The options market's fair value for prediction-market crypto threshold contracts (Kalshi, Polymarket): compare probability_above with a contract's YES price. Risk-neutral, not a forecast. Query: strikes=85000,90000 (default: a ±1-10% ladder around the forward), at=ISO-8601 with timezone or Unix (default: the nearest Deribit expiry, 08:00 UTC). Assets: btc, eth ### /api/v1/snapshot/{asset} — $0.08 USDC/call Full bundle in one call: spot price + derivatives signals + regime alerts + Kronos 1h ML forecast. Cheaper than buying each separately. Assets: btc, eth, sol, bnb, xrp, doge, ada, avax, link, dot, ltc, trx, bch, atom, near, apt ### /api/v1/market-pulse — $0.02 USDC/call Material-change feed: pass the cursor from your last call and receive ONLY what changed since (funding sign/band, funding trend, open-interest regime, alert set, source stale/recovered) for up to 5 assets. Returns an explicit no-change packet, per-asset freshness, and a next-poll time derived from the real 5-minute collection cadence. An outage is reported as an outage, never as a market move. Market data, not advice. Params: assets=, since= ### /api/v1/scan — $0.04 USDC/call Market-wide screener across all 17 assets in one call. Returns funding rate, annualized rate, OI 1h change, basis, funding trend, funding_extreme flag, and regime event count per asset. Accepts optional ?assets=btc,eth,sol to scan a subset. ### /api/v1/overview — $0.02 USDC/call Market-wide derivatives snapshot for all 17 assets: funding rate, OI, mark price, 24h volume. One call replaces 17 separate signals calls. ### /api/v1/digest/{asset} — $0.02 USDC/call Structured market digest: deterministic thesis from live signals (funding, basis, regime, 30d vol, Fear & Greed, VIX, ML forecast probability). Per-driver interpretations and honest caveats. No LLM. Assets: btc, eth, sol, bnb, xrp, doge, ada, avax, link, dot, ltc, trx, bch, atom, near, apt ### /api/v1/briefing — $0.10 USDC/call Composite briefing in one round-trip: BTC/ETH/SOL ML forecasts (1h horizon), Crypto Fear & Greed Index (alternative.me), TradFi macro context (VIX, DXY, US 10Y yield, S&P 500, gold from stooq.com/Yahoo Finance), and top funding-rate extremes (|z|≥2 across 17 perpetual markets from Kronos market_signals). Per-section available flags for graceful degradation — partial responses are valid. Saves 4+ separate paid calls. ### /api/v1/trade-preflight — $0.05 USDC/call Pre-trade context pack for one asset in one call: derivatives state (funding, annualised funding, basis, open interest and 1h change), recent liquidation prints, implied-volatility surface (BTC/ETH), and active regime alerts. Replaces four separate paid calls. Each component independently marked available/unavailable/stale and never flattened into a neutral value. Facts and data quality only — no recommendation. Params: asset=, side=long|short|neutral, horizon=1h|4h|24h ### /api/v1/macro — $0.02 USDC/call TradFi macro context: VIX, DXY (Dollar Index), US 10-Year yield, S&P 500, gold. Fetched from stooq.com and Yahoo Finance with 15-minute caching. Null on source failure (never fabricated). ### /api/v1/stablecoins — $0.02 USDC/call Stablecoin market cap, top stablecoins by market cap, 7-day and 30-day flows, sourced from DeFiLlama. 15-minute cache. Returns total_stablecoin_mcap, top_stablecoins (name/symbol/circulating/dominance_pct), flows (7d + 30d net USD flows and pct), plain-language interpretation, and stale flag. ### /api/v1/unlocks — $0.02 USDC/call Upcoming token unlock events for a curated set of major tokens: next scheduled cliff/linear unlock per protocol, tokens released, USD value at the current price, % of circulating supply, and the largest unlock within 7 days. DeFiLlama emissions + coins.llama.fi prices, refreshed hourly. available:false when sources are unreachable — never fabricated. ### /api/v1/ohlc/{asset} — $0.02 USDC/call Consolidated OHLC candles: Binance (primary) + Coinbase (secondary) per candle, with VWAP, dollar volume, body/wick % and doji flags, plus gap and volume-anomaly flags. Accepts ?interval=1h|4h|1d (default 1h) and ?limit=1-200 (default 50). Assets: btc, eth, sol, bnb, xrp, doge, ada, avax, link, dot, ltc, trx, bch, atom, near, apt ### /api/v1/volatility/{asset} — $0.02 USDC/call 7-day, 30-day and 90-day annualized realized volatility from closed Binance daily candles, with three estimators (close-to-close, Parkinson, Garman-Klass), annualized by sqrt(252). Includes percentile context and a vol-regime label. Assets: btc, eth, sol, bnb, xrp, doge, ada, avax, link, dot, ltc, trx, bch, atom, near, apt ### /api/v1/fear-greed — $0.03 USDC/call Crypto Fear & Greed Index (0-100) from alternative.me with classification (Extreme Fear/Fear/Neutral/Greed/Extreme Greed). ### /api/v1/price/{asset} — $0.02 USDC/call Volume-weighted median spot price from up to 4 exchanges (Binance, Coinbase, Kraken, OKX) with outlier rejection, spread %, and confidence grading. Assets: btc, eth, sol, bnb, xrp, doge, ada, avax, link, dot, ltc, trx, bch, atom, near, apt ### /api/v1/forecast-ledger — $0.02 USDC/call Paginated list of resolved forecasts with actual outcomes. Per-row: original ML prediction vs real result. Summary includes hit_rate (cache-source rows, matching /api/stats methodology). Filterable by asset, horizon, date range, source. ## Premium Add-on — ML Forecasts > ML price-direction forecasts. The data endpoints above are the core service; forecasts are an optional premium layer. ### /api/v1/forecast/{asset} — $0.05 USDC/call Premium add-on: ML price-direction forecast (1h/4h/24h) for BTC/ETH/SOL. Returns up_prob, expected_close, range_low/high, p10-p90 quantiles, model version. Assets: btc, eth, sol ### /api/v1/forecast/doge — $0.05 USDC/call DOGE-USD directional forecast (1h/4h/24h). Kronos-base ML model (60-path Monte-Carlo, run hourly; composite heuristic when no recent run exists) — graduated from the composite heuristic 2026-07-10. Per-asset served accuracy is published live at /api/stats (beta_accuracy.per_asset). Response includes accuracy_note. ### /api/v1/forecast/xrp — $0.05 USDC/call XRP-USD composite directional forecast (1h/4h/24h). Composite model (EMA/RSI/MACD/ATR off Binance klines). It has shown no directional edge; check the live per-asset figure at /api/stats (beta_accuracy.per_asset, free) before buying. Response includes model_type:"composite" and accuracy_note. ### /api/v1/forecast/bnb — $0.05 USDC/call BNB-USD directional forecast (1h/4h/24h). Kronos-base ML model (60-path Monte-Carlo, run hourly; composite heuristic when no recent run exists) — graduated from the composite heuristic 2026-07-10. Per-asset served accuracy is published live at /api/stats (beta_accuracy.per_asset). Response includes accuracy_note. ### /api/v1/forecast/near — $0.05 USDC/call NEAR-USD directional forecast (1h/4h/24h). Kronos-base ML model (60-path Monte-Carlo, run hourly; composite heuristic when no recent run exists). Per-asset served accuracy is published live at /api/stats (beta_accuracy.per_asset). Response includes accuracy_note. ### /api/v1/forecast/ada — $0.05 USDC/call ADA-USD directional forecast (1h/4h/24h). Kronos-base ML model (60-path Monte-Carlo, run hourly; composite heuristic when no recent run exists). Served accuracy is published live at /api/v1/forecast-ledger and /api/stats. Response includes accuracy_note. ### /api/v1/forecast-path/{asset} — $0.08 USDC/call 3-horizon quantile fan for BTC/ETH/SOL: p10/p25/p50/p75/p90 quantiles, expected close and forward volatility at 1h, 4h and 24h horizons, from 60-path Kronos-base Monte-Carlo runs refreshed every 20 min. Discrete-horizon distributions (no interpolation). Assets: btc, eth, sol ### /api/v1/target-prob/{asset} — $0.05 USDC/call Empirical P(close above/below your target) at 1h, 4h or 24h for BTC/ETH/SOL, computed directly from the 60 terminal prices of each cached Kronos-base Monte-Carlo run. Resolution ~1/60 ≈ 1.7 percentage points — an empirical sample frequency, not a market-implied probability. Requires ?target=; optional &horizon=1h|4h|24h (default 24h). Assets: btc, eth, sol ### /api/v1/forward-vol/{asset} — $0.03 USDC/call Model-predicted forward volatility for BTC/ETH/SOL at 1h, 4h and 24h horizons, from Kronos-base 60-path Monte-Carlo dispersion, refreshed every 20 min, alongside a realized-volatility comparison (Binance daily OHLC, close-to-close/Parkinson/Garman-Klass). Assets: btc, eth, sol ## Free Tools ### /api/v1/sample/{asset} — FREE Coarse directional signal (up/down + confidence bucket) from the latest cached Kronos forecast. No payment required. Rate-limited 10 req/min/IP. Assets: btc, eth, sol ### /api/v1/track-record — FREE Accuracy audit: overall hit_rate, total resolved forecasts (n), per-asset hit_rate for BTC/ETH/SOL, Brier score, and the last 20 resolved forecasts as row-level audit data. Lets an agent verify model accuracy before paying for the full ledger. Data sourced from the same Supabase join used by the paid /api/v1/forecast-ledger. Full paginated history with filtering available via /api/v1/forecast-ledger ($0.02/call via x402). ### /api/stats — FREE Aggregate service stats: total requests, paid calls, USD earned, unique payers, forecast accuracy (hit rate, in-range rate). ### /api/health — FREE Liveness check. Returns {ok: true, ts: ""}. ### /api/methodology — FREE Track-record methodology: how forecasts are scored, current live accuracy figures, caveats. ## How to Pay (x402 Protocol) 1. Call any paid endpoint WITHOUT an X-PAYMENT header — server returns HTTP 402 with machine-readable payment instructions. 2. Use an x402-compatible client (e.g. npm install x402-fetch) to complete the USDC payment on Base. 3. Re-send request with the X-PAYMENT header — server settles and returns data in one round-trip. No API key or account required. Pay only for what you use. ## Discovery & Docs - Full machine-readable catalog: https://kronossignals.com/api/v1/catalog (free JSON; one-call agent directory with categories, inputs, prices, and when_to_use hints) - x402 manifest: https://kronossignals.com/.well-known/x402 - OpenAPI 3.0.3: https://kronossignals.com/api/openapi.json - Tool manifests: https://kronossignals.com/api/tools (index) — OpenAI + Anthropic tool-calling schemas, ready to load into an agent loop - OpenAPI 3.1.0: https://kronossignals.com/openapi.json - MCP server: npx crypto-derivatives-mcp - Stats: https://kronossignals.com/api/stats ## Disclaimer All output is informational only and NOT financial advice. Forecasts are probabilistic model outputs; signals are heuristics derived from public market data. Past signals do not guarantee future returns.