{
  "schema_version": "v1",
  "name": "Kronos Crypto Intelligence Agent",
  "description": "Pay-per-call crypto derivatives intelligence API for autonomous agents and trading bots. ML price forecasts + perpetual swap signals for 17 crypto assets. USDC micropayments via x402 protocol on Base — no API key required.",
  "provider": {
    "name": "Kronos Signals",
    "url": "https://kronossignals.com"
  },
  "version": "1.0.0",
  "capabilities": [
    "streaming_false",
    "push_notifications_false",
    "state_transition_history_false"
  ],
  "authentication": {
    "schemes": [
      "x402"
    ],
    "network": "eip155:8453",
    "description": "Pay-per-call via x402 USDC micropayments on Base (EIP-3009). No API key or account required. Call any paid endpoint without X-PAYMENT header to receive HTTP 402 with payment instructions."
  },
  "endpoints": {
    "base_url": "https://kronossignals.com",
    "x402_discovery": "https://kronossignals.com/.well-known/x402",
    "openapi_3_0": "https://kronossignals.com/api/openapi.json",
    "openapi_3_1": "https://kronossignals.com/openapi.json",
    "mcp_package": "npx crypto-derivatives-mcp",
    "agent_card": "https://kronossignals.com/.well-known/agent-card.json",
    "llms_txt": "https://kronossignals.com/llms.txt",
    "agents_txt": "https://kronossignals.com/agents.txt",
    "stats": "https://kronossignals.com/api/stats",
    "forecast_ledger": "https://kronossignals.com/api/v1/forecast-ledger"
  },
  "skills": [
    {
      "id": "get_derivatives",
      "name": "Get Derivatives",
      "description": "/api/v1/signals/{asset} - $0.02/call - Perpetual swap derivatives across 17 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.",
      "price_usd": 0.02,
      "endpoint": "https://kronossignals.com/api/v1/signals/{asset}"
    },
    {
      "id": "get_funding_rate",
      "name": "Get Funding Rate",
      "description": "/api/v1/signals/{asset} - $0.02/call - Returns current and historical perpetual swap funding rate data for the given asset, including next_funding_time and funding_interval_hours.",
      "price_usd": 0.02,
      "endpoint": "https://kronossignals.com/api/v1/signals/{asset}"
    },
    {
      "id": "get_open_interest",
      "name": "Get Open Interest",
      "description": "/api/v1/signals/{asset} - $0.02/call - Returns open interest data and trends for the given asset's perpetual swap market.",
      "price_usd": 0.02,
      "endpoint": "https://kronossignals.com/api/v1/signals/{asset}"
    },
    {
      "id": "get_price",
      "name": "Get Price",
      "description": "/api/v1/price/{asset} - $0.02/call - 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).",
      "price_usd": 0.02,
      "endpoint": "https://kronossignals.com/api/v1/price/{asset}"
    },
    {
      "id": "get_snapshot",
      "name": "Get Snapshot",
      "description": "/api/v1/snapshot/{asset} - $0.08/call - Everything for one asset in a single call: price + derivatives + market regime + ML forecast + options IV + liquidations + CEX premium. The 'grab everything' entry call.",
      "price_usd": 0.08,
      "endpoint": "https://kronossignals.com/api/v1/snapshot/{asset}"
    },
    {
      "id": "get_market_overview",
      "name": "Get Market Overview",
      "description": "/api/v1/overview - $0.02/call - Market-wide derivatives snapshot across tracked assets: funding, open interest, mark price, and 24h volume in one call.",
      "price_usd": 0.02,
      "endpoint": "https://kronossignals.com/api/v1/overview"
    },
    {
      "id": "get_liquidations",
      "name": "Get Liquidations",
      "description": "/api/v1/liquidations/{asset} - $0.02/call - 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 17 assets.",
      "price_usd": 0.02,
      "endpoint": "https://kronossignals.com/api/v1/liquidations/{asset}"
    },
    {
      "id": "get_options_iv",
      "name": "Get Options Iv",
      "description": "/api/v1/options-iv/{asset} - $0.03/call - 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.",
      "price_usd": 0.03,
      "endpoint": "https://kronossignals.com/api/v1/options-iv/{asset}"
    },
    {
      "id": "get_implied_prob",
      "name": "Get Implied Prob",
      "description": "/api/v1/implied-prob/{asset} - $0.02/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. Defaults: a ±1-10% ladder around the forward, at the nearest Deribit expiry (08:00 UTC).",
      "price_usd": 0.02,
      "endpoint": "https://kronossignals.com/api/v1/implied-prob/{asset}"
    },
    {
      "id": "get_gex",
      "name": "Get Gex",
      "description": "/api/v1/gex/{asset} - $0.04/call - 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.",
      "price_usd": 0.04,
      "endpoint": "https://kronossignals.com/api/v1/gex/{asset}"
    },
    {
      "id": "get_funding_extremes",
      "name": "Get Funding Extremes",
      "description": "/api/v1/funding-extremes - $0.02/call - Returns assets with the highest and lowest perpetual swap funding rates, including next_funding_time and funding_interval_hours per asset.",
      "price_usd": 0.02,
      "endpoint": "https://kronossignals.com/api/v1/funding-extremes"
    },
    {
      "id": "get_scan",
      "name": "Get Scan",
      "description": "/api/v1/scan - $0.04/call - Scans multiple assets for signals and returns a ranked summary.",
      "price_usd": 0.04,
      "endpoint": "https://kronossignals.com/api/v1/scan"
    },
    {
      "id": "get_macro",
      "name": "Get Macro",
      "description": "/api/v1/macro - $0.02/call - Returns macro-level market indicators and cross-asset context.",
      "price_usd": 0.02,
      "endpoint": "https://kronossignals.com/api/v1/macro"
    },
    {
      "id": "get_cex_premium",
      "name": "Get Cex Premium",
      "description": "/api/v1/cex-premium/{asset} - $0.02/call - 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.",
      "price_usd": 0.02,
      "endpoint": "https://kronossignals.com/api/v1/cex-premium/{asset}"
    },
    {
      "id": "get_volatility",
      "name": "Get Volatility",
      "description": "/api/v1/volatility/{asset} - $0.02/call - 7-day, 30-day and 90-day annualized realized volatility (close-to-close, Parkinson and Garman-Klass estimators, closed daily candles, annualized by sqrt(252)) with percentile context and a vol-regime label. For risk sizing, position management, and options pricing.",
      "price_usd": 0.02,
      "endpoint": "https://kronossignals.com/api/v1/volatility/{asset}"
    },
    {
      "id": "get_ohlc",
      "name": "Get Ohlc",
      "description": "/api/v1/ohlc/{asset} - $0.02/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.",
      "price_usd": 0.02,
      "endpoint": "https://kronossignals.com/api/v1/ohlc/{asset}"
    },
    {
      "id": "get_fear_greed",
      "name": "Get Fear Greed",
      "description": "/api/v1/fear-greed - $0.03/call - Returns the current crypto Fear & Greed Index value and classification.",
      "price_usd": 0.03,
      "endpoint": "https://kronossignals.com/api/v1/fear-greed"
    },
    {
      "id": "get_stablecoins",
      "name": "Get Stablecoins",
      "description": "/api/v1/stablecoins - $0.02/call - 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.",
      "price_usd": 0.02,
      "endpoint": "https://kronossignals.com/api/v1/stablecoins"
    },
    {
      "id": "get_unlocks",
      "name": "Get Unlocks",
      "description": "/api/v1/unlocks - $0.02/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.",
      "price_usd": 0.02,
      "endpoint": "https://kronossignals.com/api/v1/unlocks"
    },
    {
      "id": "get_market_regime",
      "name": "Get Market Regime",
      "description": "/api/v1/alerts/{asset} - $0.02/call - Returns current market regime classification and alert signals for the given asset.",
      "price_usd": 0.02,
      "endpoint": "https://kronossignals.com/api/v1/alerts/{asset}"
    },
    {
      "id": "get_digest",
      "name": "Get Digest",
      "description": "/api/v1/digest/{asset} - $0.02/call - 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.",
      "price_usd": 0.02,
      "endpoint": "https://kronossignals.com/api/v1/digest/{asset}"
    },
    {
      "id": "get_briefing",
      "name": "Get Briefing",
      "description": "/api/v1/briefing - $0.10/call - 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 17 markets) in one call.",
      "price_usd": 0.1,
      "endpoint": "https://kronossignals.com/api/v1/briefing"
    },
    {
      "id": "get_funding_arb",
      "name": "Get Funding Arb",
      "description": "/api/v1/funding-arb/{asset} - $0.02/call - Net-of-fees cross-venue funding arbitrage signal. Queries up to 6 exchanges (Binance/OKX/Bybit/KuCoin/Bitget/Hyperliquid) for real-time 8h-equivalent funding rates 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 17 assets.",
      "price_usd": 0.02,
      "endpoint": "https://kronossignals.com/api/v1/funding-arb/{asset}"
    },
    {
      "id": "get_forecast",
      "name": "Get Forecast",
      "description": "/api/v1/forecast/{asset} - $0.05/call - Premium add-on. Returns ML price-direction forecast with probability, confidence, and range for BTC/ETH/SOL.",
      "price_usd": 0.05,
      "endpoint": "https://kronossignals.com/api/v1/forecast/{asset}"
    },
    {
      "id": "get_forecast_doge",
      "name": "Get Forecast Doge",
      "description": "/api/v1/forecast/doge - $0.05/call - DOGE-USD directional forecast (1h/4h/24h). Kronos-base ML model (60-path Monte-Carlo), graduated from composite 2026-07-10, run hourly with the composite heuristic when no recent run exists (model_type says which). Per-asset served accuracy is published live at /api/stats (beta_accuracy.per_asset). Returns up_prob, range, and accuracy_note.",
      "price_usd": 0.05,
      "endpoint": "https://kronossignals.com/api/v1/forecast/doge"
    },
    {
      "id": "get_forecast_xrp",
      "name": "Get Forecast Xrp",
      "description": "/api/v1/forecast/xrp - $0.05/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. Returns up_prob, range, and accuracy_note.",
      "price_usd": 0.05,
      "endpoint": "https://kronossignals.com/api/v1/forecast/xrp"
    },
    {
      "id": "get_forecast_bnb",
      "name": "Get Forecast Bnb",
      "description": "/api/v1/forecast/bnb - $0.05/call - BNB-USD directional forecast (1h/4h/24h). Kronos-base ML model (60-path Monte-Carlo), graduated from composite 2026-07-10, run hourly with the composite heuristic when no recent run exists (model_type says which). Per-asset served accuracy is published live at /api/stats (beta_accuracy.per_asset). Returns up_prob, range, and accuracy_note.",
      "price_usd": 0.05,
      "endpoint": "https://kronossignals.com/api/v1/forecast/bnb"
    },
    {
      "id": "get_forecast_near",
      "name": "Get Forecast Near",
      "description": "/api/v1/forecast/near - $0.05/call - NEAR-USD directional forecast (1h/4h/24h). Kronos-base ML model (60-path Monte-Carlo), run hourly with the composite heuristic when no recent run exists (model_type says which). Per-asset served accuracy is published live at /api/stats (beta_accuracy.per_asset). Returns up_prob, range, and accuracy_note.",
      "price_usd": 0.05,
      "endpoint": "https://kronossignals.com/api/v1/forecast/near"
    },
    {
      "id": "get_forecast_ada",
      "name": "Get Forecast Ada",
      "description": "/api/v1/forecast/ada - $0.05/call - ADA-USD directional forecast (1h/4h/24h). Kronos-base ML model (60-path Monte-Carlo), graduated 2026-07-26, run hourly with the composite heuristic when no recent run exists (model_type says which). Served accuracy is published live at /api/v1/forecast-ledger and /api/stats. Returns up_prob, range, and accuracy_note.",
      "price_usd": 0.05,
      "endpoint": "https://kronossignals.com/api/v1/forecast/ada"
    },
    {
      "id": "get_forecast_path",
      "name": "Get Forecast Path",
      "description": "/api/v1/forecast-path/{asset} - $0.08/call - 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.",
      "price_usd": 0.08,
      "endpoint": "https://kronossignals.com/api/v1/forecast-path/{asset}"
    },
    {
      "id": "get_target_prob",
      "name": "Get Target Prob",
      "description": "/api/v1/target-prob/{asset} - $0.05/call - 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.",
      "price_usd": 0.05,
      "endpoint": "https://kronossignals.com/api/v1/target-prob/{asset}"
    },
    {
      "id": "get_forward_vol",
      "name": "Get Forward Vol",
      "description": "/api/v1/forward-vol/{asset} - $0.03/call - 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).",
      "price_usd": 0.03,
      "endpoint": "https://kronossignals.com/api/v1/forward-vol/{asset}"
    },
    {
      "id": "get_forecast_ledger",
      "name": "Get Forecast Ledger",
      "description": "/api/v1/forecast-ledger - $0.02/call - 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.",
      "price_usd": 0.02,
      "endpoint": "https://kronossignals.com/api/v1/forecast-ledger"
    },
    {
      "id": "get_market_pulse",
      "name": "Get Market Pulse",
      "description": "/api/v1/market-pulse - $0.02/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.",
      "price_usd": 0.02,
      "endpoint": "https://kronossignals.com/api/v1/market-pulse"
    },
    {
      "id": "get_trade_preflight",
      "name": "Get Trade Preflight",
      "description": "/api/v1/trade-preflight - $0.05/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.",
      "price_usd": 0.05,
      "endpoint": "https://kronossignals.com/api/v1/trade-preflight"
    },
    {
      "id": "get_sample",
      "name": "Get Sample",
      "description": "/api/v1/sample/{asset} - FREE - Returns a free sample forecast for the given asset (no payment required).",
      "price_usd": 0,
      "endpoint": "https://kronossignals.com/api/v1/sample/{asset}"
    }
  ],
  "disclaimer": "All output is informational only and NOT financial advice. Probabilistic model outputs and heuristic signals. Past performance does not guarantee future results."
}