{
  "version": "1.0",
  "serviceName": "Kronos Crypto Data & Forecasts",
  "description": "Pay-per-call crypto intelligence API for autonomous agents and trading bots. 19 paid endpoints across 16 crypto assets (BTC/ETH/SOL/BNB/XRP/DOGE/ADA/AVAX/LINK/DOT/LTC/TRX/BCH/ATOM/NEAR/APT). ML forecasts, perpetual swap derivatives, options IV, liquidation cluster maps, macro context (VIX/SPX/DXY/gold), market regime alerts, and more. USDC micropayments on Base via x402 protocol. No API keys required.",
  "tags": [
    "bitcoin",
    "ethereum",
    "crypto",
    "derivatives",
    "forecast",
    "options",
    "macro",
    "finance",
    "x402",
    "ai-agents"
  ],
  "endpoints": [
    {
      "path": "/api/v1/forecast/{asset}",
      "method": "GET",
      "description": "ML directional price forecast (1h/4h/24h) for BTC/ETH/SOL. Returns up_prob, expected_close, range_low/high, p10-p90 quantiles, pred_volatility, confidence, model version.",
      "price": "$0.01",
      "currency": "USDC",
      "network": "eip155:8453",
      "payTo": "0x36038e1d712c5e39f35952164ec58ec2b96caee7",
      "params": {
        "asset": {
          "in": "path",
          "type": "string",
          "enum": [
            "btc",
            "eth",
            "sol"
          ],
          "description": "Asset slug (btc, eth, or sol)."
        },
        "horizon": {
          "in": "query",
          "type": "string",
          "enum": [
            "1h",
            "4h",
            "24h"
          ],
          "default": "1h",
          "description": "Forecast horizon."
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "asset": {
            "type": "string",
            "example": "BTC-USD"
          },
          "horizon": {
            "type": "string",
            "example": "1h"
          },
          "source": {
            "type": "string",
            "example": "Kronos-small"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "price": {
            "type": "object",
            "properties": {
              "close": {
                "type": "number"
              },
              "atr": {
                "type": "number"
              }
            }
          },
          "forecast": {
            "type": "object",
            "properties": {
              "up_prob": {
                "type": "number",
                "minimum": 0,
                "maximum": 1
              },
              "range_low": {
                "type": "number"
              },
              "range_high": {
                "type": "number"
              },
              "expected_close": {
                "type": "number",
                "nullable": true
              },
              "confidence": {
                "type": "number",
                "minimum": 0,
                "maximum": 1
              },
              "quantiles": {
                "type": "object",
                "nullable": true,
                "properties": {
                  "p10": {
                    "type": "number"
                  },
                  "p25": {
                    "type": "number"
                  },
                  "p50": {
                    "type": "number"
                  },
                  "p75": {
                    "type": "number"
                  },
                  "p90": {
                    "type": "number"
                  }
                }
              }
            }
          },
          "model": {
            "type": "string"
          },
          "disclaimer": {
            "type": "string"
          }
        }
      }
    },
    {
      "path": "/api/v1/signals/{asset}",
      "method": "GET",
      "description": "Perpetual swap derivatives intelligence for all 16 assets. Returns funding_rate, funding_rate_annualized, mark/index price, basis, OI, OI 1h change, funding trend, plain-language read.",
      "price": "$0.02",
      "currency": "USDC",
      "network": "eip155:8453",
      "payTo": "0x36038e1d712c5e39f35952164ec58ec2b96caee7",
      "params": {
        "asset": {
          "in": "path",
          "type": "string",
          "enum": [
            "btc",
            "eth",
            "sol",
            "bnb",
            "xrp",
            "doge",
            "ada",
            "avax",
            "link",
            "dot",
            "ltc",
            "trx",
            "bch",
            "atom",
            "near",
            "apt"
          ]
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "available": {
            "type": "boolean"
          },
          "asset": {
            "type": "string",
            "example": "BTC-USD"
          },
          "as_of": {
            "type": "string",
            "format": "date-time"
          },
          "funding_rate": {
            "type": "number",
            "nullable": true
          },
          "funding_rate_annualized": {
            "type": "number",
            "nullable": true
          },
          "mark_price": {
            "type": "number",
            "nullable": true
          },
          "index_price": {
            "type": "number",
            "nullable": true
          },
          "basis": {
            "type": "number",
            "nullable": true
          },
          "open_interest": {
            "type": "number",
            "nullable": true
          },
          "oi_change_1h": {
            "type": "object",
            "properties": {
              "abs": {
                "type": "number",
                "nullable": true
              },
              "pct": {
                "type": "number",
                "nullable": true
              }
            }
          },
          "funding_trend": {
            "type": "string",
            "enum": [
              "rising",
              "falling",
              "flat",
              "insufficient_data"
            ]
          },
          "read": {
            "type": "string"
          },
          "disclaimer": {
            "type": "string"
          }
        }
      }
    },
    {
      "path": "/api/v1/alerts/{asset}",
      "method": "GET",
      "description": "Market-regime alerts (squeeze, breakout, funding_extreme, oi_surge) in the last 2h, plus live derived funding + OI state. All 16 assets.",
      "price": "$0.02",
      "currency": "USDC",
      "network": "eip155:8453",
      "payTo": "0x36038e1d712c5e39f35952164ec58ec2b96caee7",
      "params": {
        "asset": {
          "in": "path",
          "type": "string",
          "enum": [
            "btc",
            "eth",
            "sol",
            "bnb",
            "xrp",
            "doge",
            "ada",
            "avax",
            "link",
            "dot",
            "ltc",
            "trx",
            "bch",
            "atom",
            "near",
            "apt"
          ]
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "available": {
            "type": "boolean"
          },
          "asset": {
            "type": "string"
          },
          "active_alerts": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "event_type": {
                  "type": "string"
                },
                "severity": {
                  "type": "string"
                },
                "detected_at": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          },
          "current_state": {
            "type": "object",
            "properties": {
              "funding_rate": {
                "type": "number",
                "nullable": true
              },
              "open_interest": {
                "type": "number",
                "nullable": true
              },
              "read": {
                "type": "string"
              }
            }
          },
          "as_of": {
            "type": "string",
            "format": "date-time"
          },
          "disclaimer": {
            "type": "string"
          }
        }
      }
    },
    {
      "path": "/api/v1/price/{asset}",
      "method": "GET",
      "description": "Volume-weighted median spot price from Binance, Coinbase, Kraken, OKX with 1% outlier rejection, cross-exchange spread %, and confidence grading. All 16 assets.",
      "price": "$0.001",
      "currency": "USDC",
      "network": "eip155:8453",
      "payTo": "0x36038e1d712c5e39f35952164ec58ec2b96caee7",
      "params": {
        "asset": {
          "in": "path",
          "type": "string",
          "enum": [
            "btc",
            "eth",
            "sol",
            "bnb",
            "xrp",
            "doge",
            "ada",
            "avax",
            "link",
            "dot",
            "ltc",
            "trx",
            "bch",
            "atom",
            "near",
            "apt"
          ]
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "asset": {
            "type": "string"
          },
          "price": {
            "type": "number"
          },
          "source": {
            "type": "string"
          },
          "confidence": {
            "type": "string",
            "enum": [
              "high",
              "medium",
              "low"
            ]
          },
          "as_of": {
            "type": "string",
            "format": "date-time"
          },
          "disclaimer": {
            "type": "string"
          }
        }
      }
    },
    {
      "path": "/api/v1/snapshot/{asset}",
      "method": "GET",
      "description": "Full asset bundle in one call: spot price + derivatives signals + regime alerts + ML forecast (BTC/ETH/SOL) + options IV summary (BTC/ETH) + liquidation squeeze bias + Coinbase premium. The 'grab everything' entry call. All 16 assets.",
      "price": "$0.04",
      "currency": "USDC",
      "network": "eip155:8453",
      "payTo": "0x36038e1d712c5e39f35952164ec58ec2b96caee7",
      "params": {
        "asset": {
          "in": "path",
          "type": "string",
          "enum": [
            "btc",
            "eth",
            "sol",
            "bnb",
            "xrp",
            "doge",
            "ada",
            "avax",
            "link",
            "dot",
            "ltc",
            "trx",
            "bch",
            "atom",
            "near",
            "apt"
          ]
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "asset": {
            "type": "string"
          },
          "price": {
            "type": "number",
            "nullable": true
          },
          "derivatives": {
            "type": "object",
            "properties": {
              "available": {
                "type": "boolean"
              }
            }
          },
          "regime": {
            "type": "object",
            "properties": {
              "available": {
                "type": "boolean"
              }
            }
          },
          "forecast": {
            "type": "object",
            "properties": {
              "available": {
                "type": "boolean"
              }
            }
          },
          "options_iv": {
            "type": "object",
            "properties": {
              "available": {
                "type": "boolean"
              },
              "atm_iv": {
                "type": "number",
                "nullable": true
              },
              "term_structure_shape": {
                "type": "string"
              }
            }
          },
          "liquidations": {
            "type": "object",
            "properties": {
              "available": {
                "type": "boolean"
              },
              "squeeze_bias": {
                "type": "string",
                "nullable": true
              }
            }
          },
          "cex_premium": {
            "type": "object",
            "properties": {
              "available": {
                "type": "boolean"
              },
              "premium_pct": {
                "type": "number",
                "nullable": true
              }
            }
          },
          "as_of": {
            "type": "string",
            "format": "date-time"
          },
          "disclaimer": {
            "type": "string"
          }
        }
      }
    },
    {
      "path": "/api/v1/scan",
      "method": "GET",
      "description": "Market-wide screener across all 16 assets in one call. Per-asset: funding rate, annualized rate, OI 1h change, basis, funding trend, funding_extreme flag, regime event count. Optional ?assets=btc,eth subset.",
      "price": "$0.04",
      "currency": "USDC",
      "network": "eip155:8453",
      "payTo": "0x36038e1d712c5e39f35952164ec58ec2b96caee7",
      "params": {
        "assets": {
          "in": "query",
          "type": "string",
          "description": "Comma-separated asset slugs to scan (optional; all 16 if omitted)."
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "as_of": {
            "type": "string",
            "format": "date-time"
          },
          "scanned": {
            "type": "integer"
          },
          "assets": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "disclaimer": {
            "type": "string"
          }
        }
      }
    },
    {
      "path": "/api/v1/macro",
      "method": "GET",
      "description": "TradFi macro context: VIX, DXY (Dollar Index), US 10-Year yield, S&P 500 (SPX), gold. Sources: stooq.com + Yahoo Finance. 15-min cache. BTC-SPX and BTC-DXY 30d Pearson correlations computed when source data is available (null on upstream failure — never fabricated).",
      "price": "$0.001",
      "currency": "USDC",
      "network": "eip155:8453",
      "payTo": "0x36038e1d712c5e39f35952164ec58ec2b96caee7",
      "params": {},
      "outputSchema": {
        "type": "object",
        "properties": {
          "as_of": {
            "type": "string",
            "format": "date-time"
          },
          "cached": {
            "type": "boolean"
          },
          "vix": {
            "type": "object",
            "properties": {
              "value": {
                "type": "number",
                "nullable": true
              },
              "source": {
                "type": "string",
                "nullable": true
              },
              "unavailable": {
                "type": "boolean"
              }
            }
          },
          "dxy": {
            "type": "object",
            "properties": {
              "value": {
                "type": "number",
                "nullable": true
              },
              "source": {
                "type": "string",
                "nullable": true
              },
              "unavailable": {
                "type": "boolean"
              }
            }
          },
          "us_10y_yield": {
            "type": "object",
            "properties": {
              "value": {
                "type": "number",
                "nullable": true
              },
              "source": {
                "type": "string",
                "nullable": true
              },
              "unavailable": {
                "type": "boolean"
              }
            }
          },
          "spx": {
            "type": "object",
            "properties": {
              "value": {
                "type": "number",
                "nullable": true
              },
              "source": {
                "type": "string",
                "nullable": true
              },
              "unavailable": {
                "type": "boolean"
              }
            }
          },
          "gold": {
            "type": "object",
            "properties": {
              "value": {
                "type": "number",
                "nullable": true
              },
              "source": {
                "type": "string",
                "nullable": true
              },
              "unavailable": {
                "type": "boolean"
              }
            }
          },
          "btc_spx_correlation": {
            "type": "number",
            "nullable": true
          },
          "btc_spx_correlation_available": {
            "type": "boolean"
          },
          "btc_dxy_correlation": {
            "type": "number",
            "nullable": true
          },
          "btc_dxy_correlation_available": {
            "type": "boolean"
          },
          "correlation_note": {
            "type": "string"
          },
          "disclaimer": {
            "type": "string"
          }
        }
      }
    },
    {
      "path": "/api/v1/funding-extremes",
      "method": "GET",
      "description": "All 16 perpetual futures markets ranked by absolute funding rate. Identifies crowded positions and squeeze risk across the market.",
      "price": "$0.02",
      "currency": "USDC",
      "network": "eip155:8453",
      "payTo": "0x36038e1d712c5e39f35952164ec58ec2b96caee7",
      "params": {},
      "outputSchema": {
        "type": "object",
        "properties": {
          "as_of": {
            "type": "string",
            "format": "date-time"
          },
          "ranked": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "rank": {
                  "type": "integer"
                },
                "asset": {
                  "type": "string"
                },
                "funding_rate": {
                  "type": "number",
                  "nullable": true
                }
              }
            }
          },
          "disclaimer": {
            "type": "string"
          }
        }
      }
    },
    {
      "path": "/api/v1/overview",
      "method": "GET",
      "description": "Market-wide derivatives snapshot for all 16 assets: funding rate, OI, mark price, 24h volume in one call. Replaces 16 separate signals calls.",
      "price": "$0.02",
      "currency": "USDC",
      "network": "eip155:8453",
      "payTo": "0x36038e1d712c5e39f35952164ec58ec2b96caee7",
      "params": {},
      "outputSchema": {
        "type": "object",
        "properties": {
          "as_of": {
            "type": "string",
            "format": "date-time"
          },
          "assets": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "available_count": {
            "type": "integer"
          },
          "disclaimer": {
            "type": "string"
          }
        }
      }
    },
    {
      "path": "/api/v1/fear-greed",
      "method": "GET",
      "description": "Crypto Fear & Greed Index (0-100) from alternative.me with value_classification (Extreme Fear/Fear/Neutral/Greed/Extreme Greed).",
      "price": "$0.001",
      "currency": "USDC",
      "network": "eip155:8453",
      "payTo": "0x36038e1d712c5e39f35952164ec58ec2b96caee7",
      "params": {},
      "outputSchema": {
        "type": "object",
        "properties": {
          "value": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100
          },
          "value_classification": {
            "type": "string"
          },
          "timestamp": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "as_of": {
            "type": "string",
            "format": "date-time"
          },
          "disclaimer": {
            "type": "string"
          }
        }
      }
    },
    {
      "path": "/api/v1/ohlc/{asset}",
      "method": "GET",
      "description": "OHLC candlestick data from Binance. Returns array of {t,o,h,l,c,v} candles. All 16 assets. Accepts ?interval=1h|4h|1d and ?limit=1-100 (default 24).",
      "price": "$0.001",
      "currency": "USDC",
      "network": "eip155:8453",
      "payTo": "0x36038e1d712c5e39f35952164ec58ec2b96caee7",
      "params": {
        "asset": {
          "in": "path",
          "type": "string",
          "enum": [
            "btc",
            "eth",
            "sol",
            "bnb",
            "xrp",
            "doge",
            "ada",
            "avax",
            "link",
            "dot",
            "ltc",
            "trx",
            "bch",
            "atom",
            "near",
            "apt"
          ]
        },
        "interval": {
          "in": "query",
          "type": "string",
          "enum": [
            "1h",
            "4h",
            "1d"
          ],
          "default": "1h"
        },
        "limit": {
          "in": "query",
          "type": "integer",
          "minimum": 1,
          "maximum": 100,
          "default": 24
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "asset": {
            "type": "string"
          },
          "interval": {
            "type": "string"
          },
          "candles": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "t": {
                  "type": "integer"
                },
                "o": {
                  "type": "number"
                },
                "h": {
                  "type": "number"
                },
                "l": {
                  "type": "number"
                },
                "c": {
                  "type": "number"
                },
                "v": {
                  "type": "number"
                }
              }
            }
          },
          "count": {
            "type": "integer"
          },
          "disclaimer": {
            "type": "string"
          }
        }
      }
    },
    {
      "path": "/api/v1/volatility/{asset}",
      "method": "GET",
      "description": "7-day and 30-day annualized realized volatility from Binance daily OHLC (log-return method, annualized by sqrt(365)). All 16 assets.",
      "price": "$0.01",
      "currency": "USDC",
      "network": "eip155:8453",
      "payTo": "0x36038e1d712c5e39f35952164ec58ec2b96caee7",
      "params": {
        "asset": {
          "in": "path",
          "type": "string",
          "enum": [
            "btc",
            "eth",
            "sol",
            "bnb",
            "xrp",
            "doge",
            "ada",
            "avax",
            "link",
            "dot",
            "ltc",
            "trx",
            "bch",
            "atom",
            "near",
            "apt"
          ]
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "asset": {
            "type": "string"
          },
          "vol_7d_annualized": {
            "type": "number",
            "nullable": true
          },
          "vol_30d_annualized": {
            "type": "number",
            "nullable": true
          },
          "as_of": {
            "type": "string",
            "format": "date-time"
          },
          "disclaimer": {
            "type": "string"
          }
        }
      }
    },
    {
      "path": "/api/v1/digest/{asset}",
      "method": "GET",
      "description": "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": "$0.02",
      "currency": "USDC",
      "network": "eip155:8453",
      "payTo": "0x36038e1d712c5e39f35952164ec58ec2b96caee7",
      "params": {
        "asset": {
          "in": "path",
          "type": "string",
          "enum": [
            "btc",
            "eth",
            "sol",
            "bnb",
            "xrp",
            "doge",
            "ada",
            "avax",
            "link",
            "dot",
            "ltc",
            "trx",
            "bch",
            "atom",
            "near",
            "apt"
          ]
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "asset": {
            "type": "string"
          },
          "as_of": {
            "type": "string",
            "format": "date-time"
          },
          "regime": {
            "type": "string"
          },
          "thesis": {
            "type": "string"
          },
          "confidence": {
            "type": "number",
            "nullable": true
          },
          "up_prob_calibrated": {
            "type": "number",
            "nullable": true
          },
          "drivers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "value": {},
                "interpretation": {
                  "type": "string"
                }
              }
            }
          },
          "caveats": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "disclaimer": {
            "type": "string"
          }
        }
      }
    },
    {
      "path": "/api/v1/liquidations/{asset}",
      "method": "GET",
      "description": "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. Honest model disclaimers. All 16 assets.",
      "price": "$0.02",
      "currency": "USDC",
      "network": "eip155:8453",
      "payTo": "0x36038e1d712c5e39f35952164ec58ec2b96caee7",
      "params": {
        "asset": {
          "in": "path",
          "type": "string",
          "enum": [
            "btc",
            "eth",
            "sol",
            "bnb",
            "xrp",
            "doge",
            "ada",
            "avax",
            "link",
            "dot",
            "ltc",
            "trx",
            "bch",
            "atom",
            "near",
            "apt"
          ]
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "available": {
            "type": "boolean"
          },
          "asset": {
            "type": "string"
          },
          "mark_price": {
            "type": "number",
            "nullable": true
          },
          "open_interest": {
            "type": "number",
            "nullable": true
          },
          "cluster_map": {
            "type": "object",
            "properties": {
              "squeeze_bias": {
                "type": "string",
                "enum": [
                  "long_squeeze_risk",
                  "short_squeeze_risk",
                  "balanced"
                ]
              },
              "long_clusters": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              },
              "short_clusters": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              },
              "nearest_long_liq_cluster": {
                "type": "object",
                "nullable": true
              },
              "nearest_short_liq_cluster": {
                "type": "object",
                "nullable": true
              }
            }
          },
          "recent_prints": {
            "type": "object",
            "properties": {
              "available": {
                "type": "boolean"
              }
            }
          },
          "disclaimer": {
            "type": "string"
          }
        }
      }
    },
    {
      "path": "/api/v1/options-iv/{asset}",
      "method": "GET",
      "description": "Implied volatility surface from Deribit (fallback OKX). ATM IV, IV rank/percentile (from iv_history), term structure (weekly/1m/3m), 25-delta risk reversal, 10-delta wing IVs, max-pain strike, vol regime. BTC and ETH only. 1-hour cache.",
      "price": "$0.03",
      "currency": "USDC",
      "network": "eip155:8453",
      "payTo": "0x36038e1d712c5e39f35952164ec58ec2b96caee7",
      "params": {
        "asset": {
          "in": "path",
          "type": "string",
          "enum": [
            "btc",
            "eth"
          ],
          "description": "Only btc and eth supported (Deribit liquidity)."
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "available": {
            "type": "boolean"
          },
          "asset": {
            "type": "string"
          },
          "data_source": {
            "type": "string",
            "enum": [
              "deribit",
              "okx"
            ]
          },
          "atm_iv": {
            "type": "number",
            "nullable": true
          },
          "iv_rank": {
            "type": "number",
            "nullable": true
          },
          "iv_percentile": {
            "type": "number",
            "nullable": true
          },
          "term_structure": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "label": {
                  "type": "string"
                },
                "expiry": {
                  "type": "string"
                },
                "days_to_expiry": {
                  "type": "integer"
                },
                "atm_iv": {
                  "type": "number",
                  "nullable": true
                }
              }
            }
          },
          "term_structure_shape": {
            "type": "string",
            "enum": [
              "contango",
              "backwardation",
              "flat",
              "insufficient_data"
            ]
          },
          "skew_25d": {
            "type": "number",
            "nullable": true
          },
          "max_pain_strike": {
            "type": "number",
            "nullable": true
          },
          "vol_regime": {
            "type": "string",
            "enum": [
              "compression",
              "normal",
              "event-risk",
              "expansion"
            ]
          },
          "as_of": {
            "type": "string",
            "format": "date-time"
          },
          "disclaimer": {
            "type": "string"
          }
        }
      }
    },
    {
      "path": "/api/v1/cex-premium/{asset}",
      "method": "GET",
      "description": "Coinbase price premium vs composite median (OKX + Kraken + Binance). Positive = US/institutional demand bias. 30d z-score and 24h percentile from cex_premium_history. Coinbase-listed assets only (BTC/ETH/SOL/XRP/DOGE/ADA/AVAX/LINK/DOT/LTC/BCH/ATOM/NEAR).",
      "price": "$0.02",
      "currency": "USDC",
      "network": "eip155:8453",
      "payTo": "0x36038e1d712c5e39f35952164ec58ec2b96caee7",
      "params": {
        "asset": {
          "in": "path",
          "type": "string",
          "enum": [
            "btc",
            "eth",
            "sol",
            "xrp",
            "doge",
            "ada",
            "avax",
            "link",
            "dot",
            "ltc",
            "bch",
            "atom",
            "near"
          ]
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "available": {
            "type": "boolean"
          },
          "asset": {
            "type": "string"
          },
          "coinbase_price": {
            "type": "number"
          },
          "composite_median": {
            "type": "number"
          },
          "premium_pct": {
            "type": "number"
          },
          "interpretation": {
            "type": "string"
          },
          "z_score_30d": {
            "type": "number",
            "nullable": true
          },
          "percentile_24h": {
            "type": "number",
            "nullable": true
          },
          "as_of": {
            "type": "string",
            "format": "date-time"
          },
          "disclaimer": {
            "type": "string"
          }
        }
      }
    },
    {
      "path": "/api/v1/forecast-ledger",
      "method": "GET",
      "description": "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": "$0.001",
      "currency": "USDC",
      "network": "eip155:8453",
      "payTo": "0x36038e1d712c5e39f35952164ec58ec2b96caee7",
      "params": {
        "asset": {
          "in": "query",
          "type": "string",
          "description": "Filter by asset slug or label (e.g. btc, BTC-USD). Optional."
        },
        "horizon": {
          "in": "query",
          "type": "string",
          "enum": [
            "1h",
            "4h",
            "24h"
          ],
          "description": "Filter by horizon. Optional."
        },
        "limit": {
          "in": "query",
          "type": "integer",
          "default": 100,
          "description": "Page size (max 500)."
        },
        "offset": {
          "in": "query",
          "type": "integer",
          "default": 0,
          "description": "Page offset."
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "summary": {
            "type": "object",
            "properties": {
              "total": {
                "type": "integer"
              },
              "hit_rate": {
                "type": "number",
                "nullable": true
              },
              "sample_note": {
                "type": "string"
              }
            }
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "forecast_id": {
                  "type": "string"
                },
                "made_at": {
                  "type": "string",
                  "format": "date-time"
                },
                "asset": {
                  "type": "string"
                },
                "horizon": {
                  "type": "string"
                },
                "up_prob": {
                  "type": "number"
                },
                "hit": {
                  "type": "boolean",
                  "nullable": true
                }
              }
            }
          },
          "pagination": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer"
              },
              "offset": {
                "type": "integer"
              },
              "total": {
                "type": "integer"
              }
            }
          },
          "disclaimer": {
            "type": "string"
          }
        }
      }
    },
    {
      "path": "/api/v1/gex/{asset}",
      "method": "GET",
      "description": "Gamma Exposure (GEX) strike ladder, gamma flip level, spot regime (above/below flip), max-pain per expiry (next ~3 weeklies + nearest monthly), expected-move cone (ATM-IV ±1σ for front expiry), and heuristic pin_risk score [0-1] from Deribit public options data. Black-Scholes gamma, r=0. 15-min cache. BTC and ETH only.",
      "price": "$0.04",
      "currency": "USDC",
      "network": "eip155:8453",
      "payTo": "0x36038e1d712c5e39f35952164ec58ec2b96caee7",
      "params": {
        "asset": {
          "in": "path",
          "type": "string",
          "enum": [
            "btc",
            "eth"
          ],
          "description": "Only btc and eth supported (Deribit liquid options markets)."
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "available": {
            "type": "boolean"
          },
          "asset": {
            "type": "string",
            "example": "BTC-USD"
          },
          "underlying_price": {
            "type": "number",
            "nullable": true
          },
          "data_source": {
            "type": "string",
            "enum": [
              "deribit"
            ]
          },
          "dealer_convention": {
            "type": "string"
          },
          "gex_units": {
            "type": "string"
          },
          "gex_ladder": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "strike": {
                  "type": "number"
                },
                "netGex": {
                  "type": "number"
                },
                "callGex": {
                  "type": "number"
                },
                "putGex": {
                  "type": "number"
                }
              }
            }
          },
          "gex_total": {
            "type": "number",
            "nullable": true
          },
          "gamma_flip_level": {
            "type": "number",
            "nullable": true
          },
          "spot_regime": {
            "type": "string",
            "enum": [
              "above_flip",
              "below_flip",
              "at_flip"
            ],
            "nullable": true
          },
          "spot_regime_note": {
            "type": "string"
          },
          "max_pain": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "expiry": {
                  "type": "string"
                },
                "dte": {
                  "type": "number"
                },
                "max_pain_strike": {
                  "type": "number",
                  "nullable": true
                },
                "label": {
                  "type": "string",
                  "enum": [
                    "weekly",
                    "monthly",
                    "quarterly"
                  ]
                }
              }
            }
          },
          "expected_move": {
            "type": "object",
            "nullable": true,
            "properties": {
              "expiry": {
                "type": "string"
              },
              "dte": {
                "type": "number"
              },
              "atm_iv": {
                "type": "number",
                "nullable": true
              },
              "spot": {
                "type": "number"
              },
              "upper": {
                "type": "number",
                "nullable": true
              },
              "lower": {
                "type": "number",
                "nullable": true
              }
            }
          },
          "pin_risk": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "expiry": {
                  "type": "string"
                },
                "dte": {
                  "type": "number"
                },
                "max_pain_strike": {
                  "type": "number",
                  "nullable": true
                },
                "spot_distance_pct": {
                  "type": "number",
                  "nullable": true
                },
                "gamma_concentration": {
                  "type": "number",
                  "nullable": true
                },
                "pin_risk_score": {
                  "type": "number",
                  "nullable": true
                },
                "note": {
                  "type": "string"
                }
              }
            }
          },
          "as_of": {
            "type": "string",
            "format": "date-time"
          },
          "disclaimers": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    },
    {
      "path": "/api/v1/funding-arb/{asset}",
      "method": "GET",
      "description": "Cross-venue funding arbitrage signal: real-time 8h-equivalent funding rates from 6 exchanges (Binance/OKX/Bybit/KuCoin/Bitget/Hyperliquid). Returns gross_spread_bps, net_spread_bps (after 20 bps round-trip fee), annualized_pct, actionability label, best short/long venues, per-venue rates, OI-weighted average, dispersion stats. All 16 assets.",
      "price": "$0.02",
      "currency": "USDC",
      "network": "eip155:8453",
      "payTo": "0x36038e1d712c5e39f35952164ec58ec2b96caee7",
      "params": {
        "asset": {
          "in": "path",
          "type": "string",
          "enum": [
            "btc",
            "eth",
            "sol",
            "bnb",
            "xrp",
            "doge",
            "ada",
            "avax",
            "link",
            "dot",
            "ltc",
            "trx",
            "bch",
            "atom",
            "near",
            "apt"
          ],
          "description": "Asset slug."
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "asset": {
            "type": "string",
            "example": "BTC-USD"
          },
          "short": {
            "type": "string",
            "example": "BTC"
          },
          "as_of": {
            "type": "string",
            "format": "date-time"
          },
          "best_short_venue": {
            "type": "string",
            "nullable": true
          },
          "best_long_venue": {
            "type": "string",
            "nullable": true
          },
          "best_short_rate8h": {
            "type": "number",
            "nullable": true
          },
          "best_long_rate8h": {
            "type": "number",
            "nullable": true
          },
          "gross_spread_bps": {
            "type": "number",
            "nullable": true
          },
          "net_spread_bps": {
            "type": "number",
            "nullable": true
          },
          "annualized_pct": {
            "type": "number",
            "nullable": true
          },
          "actionability": {
            "type": "string",
            "enum": [
              "not_actionable",
              "marginal",
              "actionable",
              "insufficient_data"
            ]
          },
          "round_trip_fee_bps": {
            "type": "number",
            "example": 20
          },
          "methodology": {
            "type": "string"
          },
          "caveats": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "per_venue": {
            "type": "object"
          },
          "dispersion": {
            "type": "object",
            "properties": {
              "max_min_spread": {
                "type": "number",
                "nullable": true
              },
              "stdev": {
                "type": "number",
                "nullable": true
              },
              "venues_reporting": {
                "type": "integer"
              }
            }
          },
          "oi_weighted_avg_8h": {
            "type": "number",
            "nullable": true
          },
          "simple_avg_8h": {
            "type": "number",
            "nullable": true
          }
        }
      }
    }
  ],
  "openapi": "/api/openapi.json",
  "openapi_31": "/openapi.json",
  "stats": "/api/stats",
  "mcp": "npx crypto-derivatives-mcp",
  "disclaimer": "Informational only, not financial advice. Probabilistic model output. No warranty. Use at your own risk.",
  "terms": "Informational only, not financial advice. Probabilistic model output. No warranty. Use at your own risk."
}