{ "service": { "name": "Kronos Crypto Data API", "base_url": "https://kronossignals.com", "payment": { "protocol": "x402", "network": "Base", "chain_id": "eip155:8453", "asset": "USDC", "how_to_pay": "Call any paid endpoint without an X-PAYMENT header → receive HTTP 402 with machine-readable payment requirements → complete USDC payment on Base using an x402-compatible client (e.g. npm install x402-fetch) → retry with X-PAYMENT header → server settles and returns data in one round-trip. No API key or account required." }, "discovery": { "catalog": "https://kronossignals.com/api/v1/catalog", "x402_manifest": "https://kronossignals.com/.well-known/x402", "llms_txt": "https://kronossignals.com/llms.txt", "agents_txt": "https://kronossignals.com/agents.txt", "openai_tools": "https://kronossignals.com/api/tools/openai.json", "anthropic_tools": "https://kronossignals.com/api/tools/anthropic.json", "agent_card": "https://kronossignals.com/.well-known/agent-card.json", "openapi": "https://kronossignals.com/api/openapi.json", "mcp_package": "npx crypto-derivatives-mcp" } }, "getting_started": "Each tool is a paid GET request — include an x402 USDC micropayment on Base (chain eip155:8453); see price per tool below. Free tools (get_sample, this catalog, /api/stats, /api/health, /api/methodology) require no payment and are good starting points.", "categories": [ { "name": "forecast", "tool_count": 10 }, { "name": "signals", "tool_count": 7 }, { "name": "other", "tool_count": 6 }, { "name": "price_market", "tool_count": 5 }, { "name": "derivatives", "tool_count": 2 }, { "name": "options", "tool_count": 1 }, { "name": "macro", "tool_count": 1 }, { "name": "sentiment", "tool_count": 1 }, { "name": "defi", "tool_count": 1 } ], "tools": [ { "name": "get_derivatives", "category": "signals", "price": "$0.02/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/signals/{asset}", "inputs": { "asset": { "type": "string", "enum": [ "btc", "eth", "sol", "bnb", "xrp", "doge", "ada", "avax", "link", "dot", "ltc", "trx", "bch", "atom", "near", "apt" ], "description": "Asset slug.", "required": true } }, "description": "Perpetual swap derivatives across 16 assets: funding rate (and annualized), next_funding_time, funding_interval_hours, open interest, basis, funding_trend, and a plain-language market read. The core positioning/leverage signal for a trading agent.", "when_to_use": "Need comprehensive perp swap data for an asset — funding, OI, basis, and a plain-language read all at once.", "key_outputs": [ "funding_rate", "funding_rate_annualized", "next_funding_time", "funding_interval_hours", "mark_price", "index_price", "basis", "open_interest", "oi_change_1h", "funding_trend", "read" ] }, { "name": "get_funding_rate", "category": "signals", "price": "$0.02/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/signals/{asset}", "inputs": { "asset": { "type": "string", "enum": [ "btc", "eth", "sol", "bnb", "xrp", "doge", "ada", "avax", "link", "dot", "ltc", "trx", "bch", "atom", "near", "apt" ], "description": "Asset slug.", "required": true } }, "description": "Returns current and historical perpetual swap funding rate data for the given asset, including next_funding_time and funding_interval_hours.", "when_to_use": "Need current and historical funding rate data only for a specific asset.", "key_outputs": [ "funding_rate", "funding_rate_annualized", "next_funding_time", "funding_interval_hours", "funding_trend", "history" ] }, { "name": "get_open_interest", "category": "signals", "price": "$0.02/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/signals/{asset}", "inputs": { "asset": { "type": "string", "enum": [ "btc", "eth", "sol", "bnb", "xrp", "doge", "ada", "avax", "link", "dot", "ltc", "trx", "bch", "atom", "near", "apt" ], "description": "Asset slug.", "required": true } }, "description": "Returns open interest data and trends for the given asset's perpetual swap market.", "when_to_use": "Need open interest data and trend direction for a specific asset.", "key_outputs": [ "open_interest", "oi_change_1h", "oi_change_pct", "oi_trend" ] }, { "name": "get_price", "category": "price_market", "price": "$0.02/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/price/{asset}", "inputs": { "asset": { "type": "string", "enum": [ "btc", "eth", "sol", "bnb", "xrp", "doge", "ada", "avax", "link", "dot", "ltc", "trx", "bch", "atom", "near", "apt" ], "description": "Asset slug.", "required": true }, "coins": { "type": "string", "description": "Optional comma-separated symbol list for a multi-symbol batch (e.g. \"BTC,ETH,SOL\"), case-insensitive, max 10. Adds quotes[] and unresolved[] to the response.", "required": false } }, "description": "Volume-weighted median spot across Binance/Coinbase/Kraken/OKX with 1% outlier rejection, cross-exchange spread %, and a confidence grade. A cross-exchange reference price for 16 assets, not a single-venue ticker. Optional coins= batches up to 10 symbols in one call (adds quotes[] + unresolved[]; price per call unchanged).", "when_to_use": "Need a quick, volume-weighted consensus spot price with confidence grade. Pass coins= to batch up to 10 symbols in one call.", "key_outputs": [ "price", "spread_pct", "confidence", "sources", "quotes[{asset,price,...}]", "unresolved" ] }, { "name": "get_snapshot", "category": "price_market", "price": "$0.08/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/snapshot/{asset}", "inputs": { "asset": { "type": "string", "enum": [ "btc", "eth", "sol", "bnb", "xrp", "doge", "ada", "avax", "link", "dot", "ltc", "trx", "bch", "atom", "near", "apt" ], "description": "Asset slug.", "required": true } }, "description": "Everything for one asset in a single call: price + derivatives + market regime + ML forecast + options IV + liquidations + CEX premium. The 'grab everything' entry call.", "when_to_use": "Need price + signals + alerts + 1h forecast in one call — cheaper than buying each endpoint separately.", "key_outputs": [ "price", "derivatives_signals", "regime_alerts", "forecast_1h" ] }, { "name": "get_market_overview", "category": "price_market", "price": "$0.02/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/overview", "inputs": {}, "description": "Market-wide derivatives snapshot across tracked assets: funding, open interest, mark price, and 24h volume in one call.", "when_to_use": "Need a cross-market dashboard of all 16 assets' funding, OI, and prices in one call.", "key_outputs": [ "assets[{slug, funding_rate, open_interest, mark_price, volume_24h}]" ] }, { "name": "get_liquidations", "category": "derivatives", "price": "$0.02/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/liquidations/{asset}", "inputs": { "asset": { "type": "string", "enum": [ "btc", "eth", "sol", "bnb", "xrp", "doge", "ada", "avax", "link", "dot", "ltc", "trx", "bch", "atom", "near", "apt" ], "description": "Asset slug.", "required": true } }, "description": "Returns 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 label (long_squeeze_risk/short_squeeze_risk/balanced). All 16 assets.", "when_to_use": "Identify key liquidation cluster levels and assess long/short squeeze risk.", "key_outputs": [ "squeeze_bias", "liq_clusters[{price, leverage, side}]", "nearest_long_liq_cluster", "nearest_short_liq_cluster", "recent_prints" ] }, { "name": "get_options_iv", "category": "options", "price": "$0.03/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/options-iv/{asset}", "inputs": { "asset": { "type": "string", "enum": [ "btc", "eth" ], "description": "Asset slug. Only btc and eth supported (Deribit liquidity).", "required": true } }, "description": "Returns implied volatility surface from Deribit (fallback OKX). ATM IV, IV rank/percentile, term structure (weekly/1m/3m), 25-delta risk reversal, 10-delta wing IVs, max-pain strike, vol regime, plus realized_vol (Binance 30d), vrp (variance risk premium), and vol_regime_iv_band (LOW/MID/HIGH, heuristic). BTC and ETH only. 1-hour cache.", "when_to_use": "Need implied volatility surface, term structure, risk reversals, max-pain strike, or variance risk premium for BTC or ETH.", "key_outputs": [ "atm_iv", "iv_rank", "iv_percentile", "term_structure[{weekly,1m,3m}]", "risk_reversal_25d", "wing_ivs_10d", "max_pain_strike", "vol_regime", "realized_vol", "vrp", "vol_regime_iv_band" ] }, { "name": "get_gex", "category": "other", "price": "$0.04/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/gex/{asset}", "inputs": { "asset": { "type": "string", "enum": [ "btc", "eth" ], "description": "Asset slug. Only btc and eth supported (Deribit liquidity).", "required": true } }, "description": "Gamma Exposure (GEX) and max-pain options tool from Deribit. Returns an 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, an expected-move cone (ATM-IV-derived 1-sigma, front expiry), and a heuristic pin-risk score (0-1). 15-minute in-memory cache. BTC and ETH only.", "when_to_use": "Gamma Exposure (GEX) and max-pain options tool from Deribit. Returns an 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, an expected-move cone (ATM-IV-derived 1-sigma, front expiry), and a heuristic pin-risk score (0-1). 15-minute in-memory cache. BTC and ETH only.", "key_outputs": [] }, { "name": "get_funding_extremes", "category": "signals", "price": "$0.02/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/funding-extremes", "inputs": {}, "description": "Returns assets with the highest and lowest perpetual swap funding rates, including next_funding_time and funding_interval_hours per asset.", "when_to_use": "Find which assets have the most extreme funding rates — identifying crowded longs/shorts and squeeze risk.", "key_outputs": [ "highest_funding[{asset, funding_rate, funding_rate_annualized, next_funding_time, funding_interval_hours}]", "lowest_funding[{asset, funding_rate, funding_rate_annualized, next_funding_time, funding_interval_hours}]" ] }, { "name": "get_scan", "category": "signals", "price": "$0.04/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/scan", "inputs": { "assets": { "type": "string", "description": "Comma-separated asset slugs to scan.", "required": false } }, "description": "Scans multiple assets for signals and returns a ranked summary.", "when_to_use": "Screen all 16 assets at once and rank by funding, OI change, and regime signals.", "key_outputs": [ "assets[{slug, funding_rate, funding_rate_annualized, oi_change_1h, basis, funding_trend, funding_extreme, regime_events}]" ] }, { "name": "get_macro", "category": "macro", "price": "$0.02/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/macro", "inputs": {}, "description": "Returns macro-level market indicators and cross-asset context.", "when_to_use": "Add TradFi macro context (VIX, DXY, rates, S&P 500, gold) to your crypto analysis.", "key_outputs": [ "vix", "dxy", "us10y", "spx", "gold", "as_of" ] }, { "name": "get_cex_premium", "category": "price_market", "price": "$0.02/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/cex-premium/{asset}", "inputs": { "asset": { "type": "string", "enum": [ "btc", "eth", "sol", "xrp", "doge", "ada", "avax", "link", "dot", "ltc", "bch", "atom", "near" ], "description": "Asset slug. Coinbase-listed assets only (13 supported).", "required": true } }, "description": "Returns Coinbase price premium vs composite median (OKX + Kraken + Binance). Positive = US/institutional demand bias. Includes 30d z-score and 24h percentile. Coinbase-listed assets only.", "when_to_use": "Detect US/institutional demand bias via Coinbase price premium vs composite exchange median.", "key_outputs": [ "premium_pct", "z_score_30d", "percentile_24h", "coinbase_price", "composite_median" ] }, { "name": "get_volatility", "category": "signals", "price": "$0.02/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/volatility/{asset}", "inputs": { "asset": { "type": "string", "enum": [ "btc", "eth", "sol", "bnb", "xrp", "doge", "ada", "avax", "link", "dot", "ltc", "trx", "bch", "atom", "near", "apt" ], "description": "Asset slug.", "required": true } }, "description": "7-day and 30-day annualized realized volatility (log-return close-to-close, plus Parkinson & Garman-Klass estimators) with percentile context and a vol-regime label. For risk sizing, position management, and options pricing.", "when_to_use": "Need realized volatility metrics (ATR, 7d/30d annualized) to assess risk or size positions.", "key_outputs": [ "vol_7d_annualized", "vol_30d_annualized", "atr", "asset" ] }, { "name": "get_ohlc", "category": "price_market", "price": "$0.02/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/ohlc/{asset}", "inputs": { "asset": { "type": "string", "enum": [ "btc", "eth", "sol", "bnb", "xrp", "doge", "ada", "avax", "link", "dot", "ltc", "trx", "bch", "atom", "near", "apt" ], "description": "Asset slug.", "required": true }, "interval": { "type": "string", "enum": [ "1h", "4h", "1d" ], "description": "Candle interval.", "required": false }, "limit": { "type": "integer", "description": "Number of candles to return (1–100).", "minimum": 1, "maximum": 100, "required": false } }, "description": "Returns OHLC (open/high/low/close) candlestick data for the given asset.", "when_to_use": "Need raw OHLC candles for charting, technical analysis, or volatility calculations.", "key_outputs": [ "candles[{t,o,h,l,c,v}]", "interval", "asset" ] }, { "name": "get_fear_greed", "category": "sentiment", "price": "$0.03/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/fear-greed", "inputs": {}, "description": "Returns the current crypto Fear & Greed Index value and classification.", "when_to_use": "Get the current crypto market sentiment index as a single macro signal.", "key_outputs": [ "value", "value_classification", "timestamp" ] }, { "name": "get_stablecoins", "category": "defi", "price": "$0.02/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/stablecoins", "inputs": {}, "description": "Stablecoin market cap, top stablecoins by market cap, 7-day and 30-day flows, sourced from DeFiLlama. 15-minute cache. Returns top stablecoins, total market cap, and net flow data.", "when_to_use": "Get stablecoin market dynamics — total market cap, per-coin dominance, and 7d/30d net capital flows (mint/burn) across all stablecoins via DeFiLlama.", "key_outputs": [ "total_stablecoin_mcap", "top_stablecoins[{name, symbol, circulating, dominance_pct}]", "flows.{flow_7d_usd, flow_7d_pct, flow_30d_usd, flow_30d_pct}", "interpretation", "stale", "source" ] }, { "name": "get_market_regime", "category": "signals", "price": "$0.02/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/alerts/{asset}", "inputs": { "asset": { "type": "string", "enum": [ "btc", "eth", "sol", "bnb", "xrp", "doge", "ada", "avax", "link", "dot", "ltc", "trx", "bch", "atom", "near", "apt" ], "description": "Asset slug.", "required": true } }, "description": "Returns current market regime classification and alert signals for the given asset.", "when_to_use": "Detect regime shifts, squeeze events, breakouts, and funding extremes for any asset.", "key_outputs": [ "regime", "events[{type, severity}]", "funding_state", "oi_state", "squeeze_risk", "read" ] }, { "name": "get_digest", "category": "forecast", "price": "$0.02/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/digest/{asset}", "inputs": { "asset": { "type": "string", "enum": [ "btc", "eth", "sol", "bnb", "xrp", "doge", "ada", "avax", "link", "dot", "ltc", "trx", "bch", "atom", "near", "apt" ], "description": "Asset slug.", "required": true } }, "description": "Returns a structured market digest: deterministic thesis from live signals (funding, basis, regime, 30d vol, Fear & Greed, VIX, ML forecast). Per-driver interpretations and honest caveats. No LLM. All 16 assets.", "when_to_use": "Want a pre-synthesized, deterministic thesis combining all signals for an asset — no LLM inference required.", "key_outputs": [ "thesis", "direction_bias", "drivers[{name, value, interpretation}]", "caveats", "ml_forecast" ] }, { "name": "get_briefing", "category": "forecast", "price": "$0.10/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/briefing", "inputs": {}, "description": "Composite briefing: BTC/ETH/SOL ML forecasts (1h), Fear & Greed Index, TradFi macro (VIX/DXY/US10Y/SPX/gold), and top funding-rate extremes (|z|≥2 across 16 markets) in one call.", "when_to_use": "Get BTC/ETH/SOL 1h forecasts + Fear & Greed sentiment + macro (VIX/DXY/SPX/gold) + top funding extremes in one call — saves 4+ separate paid requests.", "key_outputs": [ "forecasts.BTC.{direction,probability,expected_close,range_low,range_high}", "forecasts.ETH.{direction,probability,expected_close}", "forecasts.SOL.{direction,probability,expected_close}", "sentiment.fear_greed.{value,value_classification}", "macro.{vix,dxy,us_10y_yield,spx,gold}", "funding_extremes.{extremes_count,items[{asset,z_score,classification}]}" ] }, { "name": "get_funding_arb", "category": "derivatives", "price": "$0.02/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/funding-arb/{asset}", "inputs": { "asset": { "type": "string", "enum": [ "btc", "eth", "sol", "bnb", "xrp", "doge", "ada", "avax", "link", "dot", "ltc", "trx", "bch", "atom", "near", "apt" ], "description": "Asset slug.", "required": true } }, "description": "Net-of-fees cross-venue funding arbitrage signal. Fetches real-time 8h-equivalent funding rates from 6 exchanges (Binance/OKX/Bybit/KuCoin/Bitget/Hyperliquid) and computes gross/net spread in bps between best-short and best-long venues. Returns actionability label (not_actionable/marginal/actionable), annualized_pct, spread_8h_normalized, venues_count, per-venue rates with funding_interval_hours, OI-weighted average, and dispersion stats. Outcome recorded to funding_arb_signals. All 16 assets.", "when_to_use": "Find cross-exchange funding arbitrage opportunities with net-of-fees spread and actionability label.", "key_outputs": [ "gross_spread_bps", "net_spread_bps", "spread_8h_normalized", "venues_count", "annualized_pct", "actionability", "best_short_venue", "best_long_venue", "per_venue_rates[{exchange, rate, oi, funding_interval_hours}]", "oi_weighted_avg" ] }, { "name": "get_forecast", "category": "forecast", "price": "$0.05/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/forecast/{asset}", "inputs": { "asset": { "type": "string", "enum": [ "btc", "eth", "sol" ], "description": "Asset slug (btc, eth, or sol).", "required": true }, "horizon": { "type": "string", "enum": [ "1h", "4h", "24h" ], "description": "Forecast horizon.", "required": true } }, "description": "Premium add-on. Returns ML price-direction forecast with probability, confidence, and range for BTC/ETH/SOL.", "when_to_use": "Need a directional ML price probability + range for BTC, ETH, or SOL over a specific time horizon (1h/4h/24h).", "key_outputs": [ "direction", "up_prob", "expected_close", "range_low", "range_high", "p10-p90 quantiles", "pred_volatility", "model_version" ] }, { "name": "get_forecast_doge", "category": "forecast", "price": "$0.05/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/forecast/doge", "inputs": { "horizon": { "type": "string", "enum": [ "1h", "4h", "24h" ], "description": "Forecast horizon.", "required": false } }, "description": "DOGE-USD directional forecast (1h/4h/24h). Kronos-base ML model (60-path Monte-Carlo), graduated from composite 2026-07-10. Measured on predictions actually served: 62% directional over 3,300+ scored DOGE forecasts (verify at /api/stats, beta_accuracy.per_asset). Returns up_prob, range, and accuracy_note.", "when_to_use": "Get a directional signal for DOGE-USD. Kronos-base ML model (60-path Monte-Carlo), graduated from composite 2026-07-10 — measured on served predictions: 62% directional over 3,300+ scored DOGE forecasts (verify at /api/stats, beta_accuracy.per_asset). $0.05/call.", "key_outputs": [ "up_prob", "range_low", "range_high", "beta", "model_type", "accuracy_note" ] }, { "name": "get_forecast_xrp", "category": "forecast", "price": "$0.05/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/forecast/xrp", "inputs": { "horizon": { "type": "string", "enum": [ "1h", "4h", "24h" ], "description": "Forecast horizon.", "required": false } }, "description": "XRP-USD composite directional forecast (1h/4h/24h). Composite model (EMA/RSI/MACD/ATR off Binance klines). Measured on predictions actually served: 49% directional over 500+ scored XRP forecasts (verify at /api/stats, beta_accuracy.per_asset). Returns up_prob, range, and accuracy_note.", "when_to_use": "Get a composite directional signal for XRP-USD. Composite model (EMA/RSI/MACD/ATR) — measured on served predictions: 49% directional over 500+ scored XRP forecasts (verify at /api/stats, beta_accuracy.per_asset). $0.05/call.", "key_outputs": [ "up_prob", "range_low", "range_high", "beta", "model_type", "accuracy_note" ] }, { "name": "get_forecast_bnb", "category": "forecast", "price": "$0.05/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/forecast/bnb", "inputs": { "horizon": { "type": "string", "enum": [ "1h", "4h", "24h" ], "description": "Forecast horizon.", "required": false } }, "description": "BNB-USD directional forecast (1h/4h/24h). Kronos-base ML model (60-path Monte-Carlo), graduated from composite 2026-07-10. Measured on predictions actually served: 52.5% directional over 3,700+ scored BNB forecasts (verify at /api/stats, beta_accuracy.per_asset). Returns up_prob, range, and accuracy_note.", "when_to_use": "Get a directional signal for BNB-USD. Kronos-base ML model (60-path Monte-Carlo), graduated from composite 2026-07-10 — measured on served predictions: 52.5% directional over 3,700+ scored BNB forecasts (verify at /api/stats, beta_accuracy.per_asset). $0.05/call.", "key_outputs": [ "up_prob", "range_low", "range_high", "beta", "model_type", "accuracy_note" ] }, { "name": "get_forecast_near", "category": "forecast", "price": "$0.05/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/forecast/near", "inputs": { "horizon": { "type": "string", "enum": [ "1h", "4h", "24h" ], "description": "Forecast horizon.", "required": false } }, "description": "NEAR-USD directional forecast (1h/4h/24h). Kronos-base ML model (60-path Monte-Carlo). Measured on predictions actually served: 49% directional, 72% in-range over 2,500+ scored NEAR forecasts (below the ~54% all-asset headline; verify at /api/stats, beta_accuracy.per_asset). Returns up_prob, range, and accuracy_note.", "when_to_use": "Get a directional signal for NEAR-USD. Kronos-base ML model (60-path Monte-Carlo) — measured on served predictions: 49% directional, 72% in-range over 2,500+ scored NEAR forecasts (verify at /api/stats, beta_accuracy.per_asset). $0.05/call.", "key_outputs": [ "up_prob", "range_low", "range_high", "beta", "model_type", "accuracy_note" ] }, { "name": "get_forecast_ada", "category": "forecast", "price": "$0.05/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/forecast/ada", "inputs": { "horizon": { "type": "string", "enum": [ "1h", "4h", "24h" ], "description": "Forecast horizon.", "required": false } }, "description": "ADA-USD directional forecast (1h/4h/24h). Kronos-base ML model (60-path Monte-Carlo). No serving record yet: ADA graduated to Kronos-base 2026-07-26 and has not accumulated served forecasts. We publish no accuracy figure for it rather than quote a number from a different model or population. Watch it accrue at /api/v1/forecast-ledger and /api/stats. Returns up_prob, range, and accuracy_note.", "when_to_use": "Get a directional signal for ADA-USD. Kronos-base ML model (60-path Monte-Carlo) — no serving record yet (graduated 2026-07-26); we publish no accuracy figure until it accrues — watch /api/v1/forecast-ledger. $0.05/call.", "key_outputs": [ "up_prob", "range_low", "range_high", "beta", "model_type", "accuracy_note" ] }, { "name": "get_forecast_path", "category": "other", "price": "$0.08/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/forecast-path/{asset}", "inputs": { "asset": { "type": "string", "enum": [ "btc", "eth", "sol" ], "description": "Asset slug (btc, eth, or sol).", "required": true } }, "description": "3-horizon quantile fan for BTC/ETH/SOL: p10-p90 quantiles, expected close, and forward volatility at 1h/4h/24h anchors, from 60-path Kronos-base Monte-Carlo runs (cached, refreshed ~20 min). Discrete per-horizon distributions, not an interpolated path.", "when_to_use": "3-horizon quantile fan for BTC/ETH/SOL: p10-p90 quantiles, expected close, and forward volatility at 1h/4h/24h anchors, from 60-path Kronos-base Monte-Carlo runs (cached, refreshed ~20 min). Discrete per-horizon distributions, not an interpolated path.", "key_outputs": [] }, { "name": "get_target_prob", "category": "other", "price": "$0.05/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/target-prob/{asset}", "inputs": { "asset": { "type": "string", "enum": [ "btc", "eth", "sol" ], "description": "Asset slug (btc, eth, or sol).", "required": true }, "target": { "type": "number", "description": "Target price to evaluate, e.g. 125000. Required, must be a finite number > 0.", "required": true }, "horizon": { "type": "string", "enum": [ "1h", "4h", "24h" ], "description": "Forecast horizon (default 24h).", "required": false } }, "description": "Empirical P(close above/below your target) at 1h, 4h or 24h for BTC/ETH/SOL, computed from the 60 terminal prices of each cached Kronos-base Monte-Carlo run (refreshed ~20 min). Resolution ~1/60 ≈ 1.7 percentage points — an empirical sample frequency, not a market-implied probability.", "when_to_use": "Empirical P(close above/below your target) at 1h, 4h or 24h for BTC/ETH/SOL, computed from the 60 terminal prices of each cached Kronos-base Monte-Carlo run (refreshed ~20 min). Resolution ~1/60 ≈ 1.7 percentage points — an empirical sample frequency, not a market-implied probability.", "key_outputs": [] }, { "name": "get_forward_vol", "category": "other", "price": "$0.03/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/forward-vol/{asset}", "inputs": { "asset": { "type": "string", "enum": [ "btc", "eth", "sol" ], "description": "Asset slug (btc, eth, or sol).", "required": true } }, "description": "Model-predicted forward volatility for BTC/ETH/SOL at 1h/4h/24h horizons, from Kronos-base 60-path Monte-Carlo dispersion (cached, refreshed ~20 min), alongside a realized-volatility comparison (Binance daily OHLC: close-to-close/Parkinson/Garman-Klass).", "when_to_use": "Model-predicted forward volatility for BTC/ETH/SOL at 1h/4h/24h horizons, from Kronos-base 60-path Monte-Carlo dispersion (cached, refreshed ~20 min), alongside a realized-volatility comparison (Binance daily OHLC: close-to-close/Parkinson/Garman-Klass).", "key_outputs": [] }, { "name": "get_forecast_ledger", "category": "forecast", "price": "$0.02/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/forecast-ledger", "inputs": { "asset": { "type": "string", "description": "Filter by asset slug or label (e.g. btc, BTC-USD). Optional.", "required": false }, "horizon": { "type": "string", "enum": [ "1h", "4h", "24h" ], "description": "Filter by horizon. Optional.", "required": false }, "limit": { "type": "integer", "description": "Page size (max 500, default 100). Optional.", "minimum": 1, "maximum": 500, "required": false }, "offset": { "type": "integer", "description": "Page offset (default 0). Optional.", "minimum": 0, "required": false } }, "description": "Returns paginated list of resolved forecasts with actual outcomes. Per-row: original ML prediction vs real result. Hit rate uses cache-source rows (matching /api/stats). Filterable by asset, horizon, date range, source.", "when_to_use": "Audit historical ML forecast accuracy, filter by asset/horizon, and verify track record.", "key_outputs": [ "rows[{asset, horizon, direction, up_prob, actual_result, correct}]", "hit_rate", "total", "offset" ] }, { "name": "get_market_pulse", "category": "other", "price": "$0.02/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/market-pulse", "inputs": { "assets": { "type": "string", "description": "Comma-separated asset slugs, max 5. Defaults to btc.", "required": false }, "since": { "type": "string", "description": "Opaque cursor from a previous call. Omit on the first call.", "required": false } }, "description": "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.", "when_to_use": "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.", "key_outputs": [] }, { "name": "get_trade_preflight", "category": "other", "price": "$0.05/call", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/trade-preflight", "inputs": { "asset": { "type": "string", "description": "Asset slug.", "required": false }, "side": { "type": "string", "description": "long | short | neutral. Orients factual context only.", "required": false }, "horizon": { "type": "string", "description": "1h | 4h | 24h.", "required": false } }, "description": "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.", "when_to_use": "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.", "key_outputs": [] }, { "name": "get_sample", "category": "forecast", "price": "FREE", "http_method": "GET", "endpoint": "https://kronossignals.com/api/v1/sample/{asset}", "inputs": { "asset": { "type": "string", "enum": [ "btc", "eth", "sol" ], "description": "Asset slug (btc, eth, or sol).", "required": true } }, "description": "Returns a free sample forecast for the given asset (no payment required).", "when_to_use": "Test the API or get a coarse directional signal without paying — rate-limited 10 req/min/IP.", "key_outputs": [ "direction", "confidence_bucket", "asset", "cached_at" ] } ], "free_endpoints": [ { "path": "/api/v1/sample/{asset}", "description": "Coarse directional signal (up/down + confidence bucket) from cached Kronos forecast. Rate-limited 10 req/min/IP. Assets: btc, eth, sol." }, { "path": "/api/v1/catalog", "description": "This file. Full machine-readable tool catalog. Always free." }, { "path": "/api/v1/track-record", "description": "FREE accuracy audit: overall hit_rate, total resolved forecasts (n), per-asset hit_rate (BTC/ETH/SOL), Brier score, and the last 20 resolved forecasts as row-level audit data. Lets an agent verify model accuracy before paying. Data from the same Supabase join used by the paid /api/v1/forecast-ledger. Full history with filtering available via /api/v1/forecast-ledger ($0.02/call)." }, { "path": "/api/stats", "description": "Aggregate service stats: total requests, paid calls, USD earned, unique payers, forecast hit rate." }, { "path": "/api/health", "description": "Liveness probe. Returns {ok:true, ts:}." }, { "path": "/api/methodology", "description": "Forecast scoring methodology and current live accuracy figures." } ], "as_of": "2026-08-24T20:52:06.892Z", "note": "This catalog is free (no payment required) and always current. Tool list is sourced from lib/tool-schemas.ts — only advertised, active endpoints appear here." }