list_metrics

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.

Parameters1

family

string

optional

Optional family filter, e.g. "Exchange metrics" or "BTC options".

Raw schema

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

describe_metric

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

Parameters1

id

string

required

Metric id from list_metrics, e.g. "metrics/vpin" or "options/gex".

Raw schema

{
  "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#"
}

get_payment_requirements

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.

Parameters3

id	string	required	Metric id from list_metrics.
params	object	optional	Query parameters for GET metrics (see describe_metric).
body	object	optional	JSON body for POST metrics (portfolio VaR, spread greeks).

Raw schema

{
  "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#"
}

get_metric

Paid via x402 (up to $0.05 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.

Parameters2

id	string	required	Metric id from list_metrics, e.g. "metrics/vpin".
params	object	optional	Query parameters, e.g. {"pair": "BTC-USD", "window": "1h"}. See describe_metric.

Raw schema

{
  "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#"
}

compute_portfolio_var

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.

Parameters8

assets	array	required	Asset symbols, e.g. ["BTC", "ETH"].
weights	array	optional	Portfolio weights (with portfolioValueUsd).
quantities	array	optional	Asset quantities (alternative to weights).
portfolioValueUsd	number	optional	Total portfolio value in USD.
window	string	optional	Price history window (default 180d).
confidence	number	optional	Confidence level (default 0.95).
horizon	string	optional	Risk horizon, e.g. "1d" (default).
methods	string	optional	empirical, normal, or both (default).

Raw schema

{
  "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#"
}

compute_spread_greeks

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.

Parameters1

legs

array

required

Spread legs.

Raw schema

{
  "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#"
}

DripMetrics

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

list_metrics

describe_metric

get_payment_requirements

get_metric

compute_portfolio_var

compute_spread_greeks

Install

Remote endpoint