find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/dripmetrics-ai:dripmetrics-ai-btc-options-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: DripMetrics BTC options API
  version: 1.0.0
  description: DripMetricsAI provides on-demand crypto market microstructure, risk, prediction-market, Hyperliquid, and on-chain metrics. Paid endpoints use x402 (USDC on Base or USDG on Robinhood Chain) and return structured JSON without subscriptions or API keys. Also available over MCP (Streamable HTTP) at https://mcp.dripmetrics.ai/mcp with free discovery tools.
  x-mcp: https://mcp.dripmetrics.ai/mcp
  x-guidance: 'Use /openapi.json for discovery. Routes with x-payment-info are x402-paid resources: first call the endpoint without PAYMENT-SIGNATURE to receive a 402 challenge, then retry with a valid x402 v2 PAYMENT-SIGNATURE. Routes with security: [] are public discovery or health routes and should not be probed for payment.'
  contact:
    email: drip@dripmetrics.ai
    url: https://dripmetrics.ai/
servers:
- url: https://api.dripmetrics.ai
tags:
- name: BTC options
paths:
  /options/vrp:
    get:
      operationId: getOptionsVrp
      summary: Compute BTC options vrp
      description: Computes a BTC option-derived metric combining the public Deribit option chain with DripMetrics' trade-level realized calculations. Invalid or unsupported requests fail before payment.
      tags:
      - BTC options
      parameters:
      - name: window
        in: query
        required: false
        description: Lookback window for the realized (trade tape) leg.
        schema:
          type: string
          enum:
          - 30m
          - 1h
          - 2h
          - 3h
          default: 30m
      security:
      - x402: []
      x-payment-info:
        price:
          fixed:
            mode: fixed
            currency: USD
            amount: '0.05'
        protocols:
        - x402: {}
      x-dripmetrics-paid: true
      x-x402:
        priceUsd: '0.05'
        asset: USDC
        network: eip155:8453
        scheme: exact
        paymentOptions:
        - network: eip155:8453
          asset: USDC
          scheme: exact
        - network: eip155:4663
          asset: USDG
          scheme: exact
      responses:
        '200':
          description: Successful paid response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OptionsMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /options/expected-move:
    get:
      operationId: getOptionsExpectedMove
      summary: Compute BTC options expected-move
      description: Computes a BTC option-derived metric combining the public Deribit option chain with DripMetrics' trade-level realized calculations. Invalid or unsupported requests fail before payment.
      tags:
      - BTC options
      parameters:
      - name: window
        in: query
        required: false
        description: Lookback window for the realized (trade tape) leg.
        schema:
          type: string
          enum:
          - 30m
          - 1h
          - 2h
          - 3h
          default: 30m
      security:
      - x402: []
      x-payment-info:
        price:
          fixed:
            mode: fixed
            currency: USD
            amount: '0.05'
        protocols:
        - x402: {}
      x-dripmetrics-paid: true
      x-x402:
        priceUsd: '0.05'
        asset: USDC
        network: eip155:8453
        scheme: exact
        paymentOptions:
        - network: eip155:8453
          asset: USDC
          scheme: exact
        - network: eip155:4663
          asset: USDG
          scheme: exact
      responses:
        '200':
          description: Successful paid response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OptionsMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /options/crash-premium:
    get:
      operationId: getOptionsCrashPremium
      summary: Compute BTC options crash-premium
      description: Computes a BTC option-derived metric combining the public Deribit option chain with DripMetrics' trade-level realized calculations. Invalid or unsupported requests fail before payment.
      tags:
      - BTC options
      parameters:
      - name: window
        in: query
        required: false
        description: Lookback window for the realized (trade tape) leg.
        schema:
          type: string
          enum:
          - 30m
          - 1h
          - 2h
          - 3h
          default: 30m
      security:
      - x402: []
      x-payment-info:
        price:
          fixed:
            mode: fixed
            currency: USD
            amount: '0.05'
        protocols:
        - x402: {}
      x-dripmetrics-paid: true
      x-x402:
        priceUsd: '0.05'
        asset: USDC
        network: eip155:8453
        scheme: exact
        paymentOptions:
        - network: eip155:8453
          asset: USDC
          scheme: exact
        - network: eip155:4663
          asset: USDG
          scheme: exact
      responses:
        '200':
          description: Successful paid response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OptionsMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /options/gex:
    get:
      operationId: getOptionsGex
      summary: Compute BTC options gex
      description: Computes a BTC option-derived metric combining the public Deribit option chain with DripMetrics' trade-level realized calculations. Invalid or unsupported requests fail before payment.
      tags:
      - BTC options
      security:
      - x402: []
      x-payment-info:
        price:
          fixed:
            mode: fixed
            currency: USD
            amount: '0.05'
        protocols:
        - x402: {}
      x-dripmetrics-paid: true
      x-x402:
        priceUsd: '0.05'
        asset: USDC
        network: eip155:8453
        scheme: exact
        paymentOptions:
        - network: eip155:8453
          asset: USDC
          scheme: exact
        - network: eip155:4663
          asset: USDG
          scheme: exact
      responses:
        '200':
          description: Successful paid response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OptionsMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /options/spread-greeks:
    post:
      operationId: postOptionsSpreadGreeks
      summary: Compute net Black-76 greeks and a scenario P&L grid for a BTC option spread
      description: Nets Black-76 greeks across up to 6 Deribit BTC option legs on a consistent basis and returns a spot-times-vol scenario P&L grid. Invalid legs or unknown instruments fail before payment.
      tags:
      - BTC options
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SpreadGreeksRequest'
            example:
              legs:
              - instrument: BTC-27MAR70-120000-C
                qty: 1
              - instrument: BTC-27MAR70-140000-C
                qty: -1
      security:
      - x402: []
      x-payment-info:
        price:
          fixed:
            mode: fixed
            currency: USD
            amount: '0.05'
        protocols:
        - x402: {}
      x-dripmetrics-paid: true
      x-x402:
        priceUsd: '0.05'
        asset: USDC
        network: eip155:8453
        scheme: exact
        paymentOptions:
        - network: eip155:8453
          asset: USDC
          scheme: exact
        - network: eip155:4663
          asset: USDG
          scheme: exact
      responses:
        '200':
          description: Successful paid response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SpreadGreeksResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
        metric:
          type: string
        components:
          type: object
          additionalProperties: true
      required:
      - error
      additionalProperties: true
    SpreadGreeksRequest:
      type: object
      properties:
        legs:
          type: array
          minItems: 1
          maxItems: 6
          items:
            type: object
            properties:
              instrument:
                type: string
                description: Deribit BTC option instrument name, e.g. BTC-27MAR70-120000-C.
              qty:
                type: number
                description: Signed quantity in 1 BTC contracts; negative = short.
            required:
            - instrument
            - qty
            additionalProperties: false
      required:
      - legs
      additionalProperties: false
    OptionsMetricResult:
      type: object
      properties:
        metric:
          type: string
          enum:
          - vrp
          - expected-move
          - crash-premium
          - gex
        pair:
          type: string
          const: BTC
        window:
          type: string
          enum:
          - 30m
          - 1h
          - 2h
          - 3h
        value:
          type:
          - number
          - 'null'
        components:
          type: object
          additionalProperties: true
        sampleSize:
          type: object
          additionalProperties: true
        source:
          type: object
          additionalProperties: true
        computedAt:
          type: string
          format: date-time
      required:
      - metric
      - pair
      - value
      - components
      - sampleSize
      - source
      - computedAt
      additionalProperties: true
    SpreadGreeksResult:
      type: object
      properties:
        metric:
          type: string
          const: spread-greeks
        pair:
          type: string
          const: BTC
        value:
          type:
          - number
          - 'null'
        components:
          type: object
          additionalProperties: true
        legs:
          type: array
          items:
            type: object
            additionalProperties: true
        greeks:
          type: object
          additionalProperties:
            type: number
        scenarioGrid:
          type: object
          additionalProperties: true
        sampleSize:
          type: object
          additionalProperties: true
        source:
          type: object
          additionalProperties: true
        computedAt:
          type: string
          format: date-time
      required:
      - metric
      - pair
      - value
      - greeks
      - scenarioGrid
      - computedAt
      additionalProperties: true
  responses:
    PaymentRequired:
      description: x402 payment required. Programmatic clients should read payment requirements and retry with a valid PAYMENT-SIGNATURE header.
      headers:
        PAYMENT-REQUIRED:
          description: Base64-encoded x402 v2 payment requirements.
          schema:
            type: string
        PAYMENT-RESPONSE:
          description: Base64-encoded x402 payment response after verification or settlement.
          schema:
            type: string
      content:
        application/json:
          schema:
            type: object
            additionalProperties: true
    UpstreamUnavailable:
      description: Upstream data source unavailable or insufficient.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    MetricNotComputable:
      description: Metric could not be computed from available data.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    BadRequest:
      description: Invalid request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    x402:
      type: apiKey
      in: header
      name: PAYMENT-SIGNATURE
      description: x402 v2 payment signature header supplied after reading the 402 PAYMENT-REQUIRED response.