# Kronos Crypto Data API (kronossignals.com) > Near-real-time crypto market data for autonomous agents and trading bots — derivatives (refreshed every 5 minutes), 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. > Name note: this is kronossignals.com. Other x402 services also use "Kronos", the name of an open-source candlestick model; they are separate sellers. > 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 Up to 17 perpetual futures markets ranked by absolute funding rate (markets_evaluated says how many answered). Identifies crowded positions and squeeze risk across the market. z-score against a ~3.5-day baseline (the latest 1,000 five-minute samples, never older than 30 days); baseline_samples, baseline_from and baseline_hours state the exact window. ### /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. 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. 30-day z-score and 24-hour percentile of the premium (recorded hourly). 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, term structure (weekly/1m/3m ATM IV + contango/backwardation/flat shape), 25-delta skew (put minus call IV), 10-delta wing IVs, max-pain strike, vol regime label, and the variance risk premium (ATM IV minus 30d realized vol from Binance closes). 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: Binance spot price + OKX perp derivatives signals + liquidation squeeze_bias + Coinbase premium, plus regime alerts (BTC only), the Kronos 1h ML forecast (BTC/ETH/SOL) and Deribit ATM implied vol (BTC/ETH). A component an asset does not have is marked unavailable. 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 up to 17 perpetual markets from Kronos market_signals; funding_extremes.markets_evaluated says how many answered; z-score vs a ~3.5-day baseline). 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. Refreshed hourly; as_of_age_seconds gives the age of the data and the stale flag turns true after 2 hours. Returns total_stablecoin_mcap, top_stablecoins (name/symbol/circulating/dominance_pct), flows (7d + 30d net USD flows and pct), plain-language interpretation, and the 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 v2 Protocol) 1. Call any paid endpoint WITHOUT a payment header — the server returns HTTP 402. The payment requirements are in the PAYMENT-REQUIRED response header (base64 JSON) and are also mirrored in the JSON body. 2. Use an x402 v2 client to sign the USDC payment on Base (EIP-3009, gasless: the wallet needs USDC but no ETH). For Node.js / TypeScript: npm install @x402/fetch@2 @x402/evm@2 viem 3. Re-send the same request with the signed payment in the PAYMENT-SIGNATURE request header — the server settles and returns data in one round-trip, and the receipt is in the PAYMENT-RESPONSE response header. A v2 client library does all three steps for you (see the example below). No API key or account required. Pay only for what you use. Do not use the deprecated x402 v1 client packages (x402-fetch, x402-axios): they pay with an X-PAYMENT header, which this server does not read, so they cannot complete a payment here. Minimal buyer (TypeScript / ESM; the call below costs $0.02 USDC): ```ts import { wrapFetchWithPaymentFromConfig } from "@x402/fetch"; import { ExactEvmScheme } from "@x402/evm"; import { privateKeyToAccount } from "viem/accounts"; // Set BUYER_PRIVATE_KEY in your environment — never commit a real key const account = privateKeyToAccount( process.env.BUYER_PRIVATE_KEY as `0x${string}` ); const fetchWithPayment = wrapFetchWithPaymentFromConfig(fetch, { schemes: [{ network: "eip155:8453", // Base mainnet client: new ExactEvmScheme(account), }], }); // Paid automatically: the client signs the payment and re-sends with PAYMENT-SIGNATURE const res = await fetchWithPayment("https://kronossignals.com/api/v1/signals/btc", { method: "GET" }); console.log(res.status, await res.json()); ``` Other languages: any client that implements x402 v2 works — sign the EIP-3009 authorization for the requirements in the 402 and send the base64 JSON payment payload in the PAYMENT-SIGNATURE header (spec: https://github.com/coinbase/x402, specs/transports-v2/http.md). ## 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.