{
  "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 16 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 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.",
      "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.001/call - Volume-weighted median spot across Binance/Coinbase/Kraken/OKX with 1% outlier rejection, cross-exchange spread %, and a confidence grade. The cheapest trustworthy reference price for 16 assets. Optional coins= batches up to 10 symbols in one call (adds quotes[] + unresolved[]; price per call unchanged).",
      "price_usd": 0.001,
      "endpoint": "https://kronossignals.com/api/v1/price/{asset}"
    },
    {
      "id": "get_snapshot",
      "name": "Get Snapshot",
      "description": "/api/v1/snapshot/{asset} - $0.04/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.04,
      "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.003/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 16 assets.",
      "price_usd": 0.003,
      "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_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.003/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.003,
      "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.001/call - Returns macro-level market indicators and cross-asset context.",
      "price_usd": 0.001,
      "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.01/call - 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.",
      "price_usd": 0.01,
      "endpoint": "https://kronossignals.com/api/v1/volatility/{asset}"
    },
    {
      "id": "get_ohlc",
      "name": "Get Ohlc",
      "description": "/api/v1/ohlc/{asset} - $0.001/call - Returns OHLC (open/high/low/close) candlestick data for the given asset.",
      "price_usd": 0.001,
      "endpoint": "https://kronossignals.com/api/v1/ohlc/{asset}"
    },
    {
      "id": "get_fear_greed",
      "name": "Get Fear Greed",
      "description": "/api/v1/fear-greed - $0.001/call - Returns the current crypto Fear & Greed Index value and classification.",
      "price_usd": 0.001,
      "endpoint": "https://kronossignals.com/api/v1/fear-greed"
    },
    {
      "id": "get_stablecoins",
      "name": "Get Stablecoins",
      "description": "/api/v1/stablecoins - $0.01/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.01,
      "endpoint": "https://kronossignals.com"
    },
    {
      "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.05/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 16 markets) in one call.",
      "price_usd": 0.05,
      "endpoint": "https://kronossignals.com"
    },
    {
      "id": "get_funding_arb",
      "name": "Get Funding Arb",
      "description": "/api/v1/funding-arb/{asset} - $0.003/call - 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.",
      "price_usd": 0.003,
      "endpoint": "https://kronossignals.com/api/v1/funding-arb/{asset}"
    },
    {
      "id": "get_forecast",
      "name": "Get Forecast",
      "description": "/api/v1/forecast/{asset} - $0.01/call - Premium add-on. Returns ML price-direction forecast with probability, confidence, and range for BTC/ETH/SOL.",
      "price_usd": 0.01,
      "endpoint": "https://kronossignals.com/api/v1/forecast/{asset}"
    },
    {
      "id": "get_forecast_doge",
      "name": "Get Forecast Doge",
      "description": "/api/v1/forecast/doge - $0.001/call - [BETA] DOGE-USD composite directional forecast (1h/4h/24h). Composite model (EMA/RSI/MACD/ATR off Binance klines). Directional accuracy not yet established — priced at beta tier. Returns up_prob, range, beta flag, and accuracy_note.",
      "price_usd": 0.001,
      "endpoint": "https://kronossignals.com"
    },
    {
      "id": "get_forecast_xrp",
      "name": "Get Forecast Xrp",
      "description": "/api/v1/forecast/xrp - $0.001/call - [BETA] XRP-USD composite directional forecast (1h/4h/24h). Composite model (EMA/RSI/MACD/ATR off Binance klines). Directional accuracy not yet established — priced at beta tier. Returns up_prob, range, beta flag, and accuracy_note.",
      "price_usd": 0.001,
      "endpoint": "https://kronossignals.com"
    },
    {
      "id": "get_forecast_bnb",
      "name": "Get Forecast Bnb",
      "description": "/api/v1/forecast/bnb - $0.001/call - [BETA] BNB-USD composite directional forecast (1h/4h/24h). Composite model (EMA/RSI/MACD/ATR off Binance klines). Directional accuracy not yet established — priced at beta tier. Returns up_prob, range, beta flag, and accuracy_note.",
      "price_usd": 0.001,
      "endpoint": "https://kronossignals.com"
    },
    {
      "id": "get_forecast_ledger",
      "name": "Get Forecast Ledger",
      "description": "/api/v1/forecast-ledger - $0.001/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.001,
      "endpoint": "https://kronossignals.com/api/v1/forecast-ledger"
    },
    {
      "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."
}