DripMetrics

Free. Lists every DripMetrics metric endpoint with its id, family, HTTP method, USD price, and summary. Use describe_metric for parameter details and get_metric (or the compute_* tools for POST endpoints) to fetch values. Paid fetches use x402 (USDC on Base); discovery is free.

{
  "type": "object",
  "properties": {
    "family": {
      "type": "string",
      "enum": [
        "Aerodrome",
        "BTC options",
        "Exchange metrics",
        "Hyperliquid",
        "Kraken xStocks",
        "Market summary",
        "On-chain",
        "Orderbook",
        "Polymarket",
        "Portfolio risk"
      ],
      "description": "Optional family filter, e.g. \"Exchange metrics\" or \"BTC options\"."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free. Returns full details for one metric id from list_metrics: parameters, request/response schemas, price, and how to fetch it.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Metric id from list_metrics, e.g. \"metrics/vpin\" or \"options/gex\"."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free. Dry-runs a metric request without payment and returns the exact x402 challenge the API issues (accepted networks, asset, amount, payTo). Invalid parameters fail here before any payment.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Metric id from list_metrics."
    },
    "params": {
      "type": "object",
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      },
      "description": "Query parameters for GET metrics (see describe_metric)."
    },
    "body": {
      "type": "object",
      "additionalProperties": {},
      "description": "JSON body for POST metrics (portfolio VaR, spread greeks)."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Paid via x402 (up to $0.25 per request; exact price per metric in list_metrics). Fetches any GET metric by id with query parameters. Without payment this returns the x402 challenge in _meta["x402/error"]; x402-capable clients (e.g. withX402Client) sign it and retry with _meta["x402/payment"] automatically. Invalid requests fail before payment.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Metric id from list_metrics, e.g. \"metrics/vpin\"."
    },
    "params": {
      "type": "object",
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      },
      "description": "Query parameters, e.g. {\"pair\": \"BTC-USD\", \"window\": \"1h\"}. See describe_metric."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Paid via x402 ($0.05 per request). Computes empirical and/or normal parametric VaR for a crypto portfolio. Provide either weights + portfolioValueUsd, or quantities. Invalid portfolios fail before payment.

{
  "type": "object",
  "properties": {
    "assets": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "description": "Asset symbols, e.g. [\"BTC\", \"ETH\"]."
    },
    "weights": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Portfolio weights (with portfolioValueUsd)."
    },
    "quantities": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Asset quantities (alternative to weights)."
    },
    "portfolioValueUsd": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Total portfolio value in USD."
    },
    "window": {
      "type": "string",
      "enum": [
        "90d",
        "180d"
      ],
      "description": "Price history window (default 180d)."
    },
    "confidence": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 0.999,
      "description": "Confidence level (default 0.95)."
    },
    "horizon": {
      "type": "string",
      "description": "Risk horizon, e.g. \"1d\" (default)."
    },
    "methods": {
      "type": "string",
      "enum": [
        "empirical",
        "normal",
        "both"
      ],
      "description": "empirical, normal, or both (default)."
    }
  },
  "required": [
    "assets"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Paid via x402 ($0.05 per request). Nets Black-76 greeks across up to 6 Deribit BTC option legs and returns a spot×vol scenario P&L grid. Invalid legs or unknown instruments fail before payment.

{
  "type": "object",
  "properties": {
    "legs": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "instrument": {
            "type": "string",
            "description": "Deribit BTC option instrument, e.g. \"BTC-26SEP26-120000-C\"."
          },
          "qty": {
            "type": "number",
            "description": "Signed quantity in 1 BTC contracts; negative = short."
          }
        },
        "required": [
          "instrument",
          "qty"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 6,
      "description": "Spread legs."
    }
  },
  "required": [
    "legs"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}