DripMetrics AI Portfolio risk API

openapi: 3.2.0
info:
  title: DripMetrics Portfolio risk 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: Portfolio risk
paths:
  /metrics/portfolio/var:
    post:
      operationId: postPortfolioVar
      summary: Compute portfolio Value-at-Risk
      description: Computes empirical and/or normal parametric VaR for a submitted crypto portfolio. Invalid, unsupported, failed, or insufficient-data requests fail before payment.
      tags:
      - Portfolio risk
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PortfolioVarRequest'
            example:
              assets:
              - BTC
              - ETH
              weights:
              - 0.6
              - 0.4
              portfolioValueUsd: 100000
              window: 90d
              confidence: 0.95
              horizon: 1d
              methods: both
            examples:
              weights:
                value:
                  assets:
                  - BTC
                  - ETH
                  - SOL
                  weights:
                  - 0.5
                  - 0.3
                  - 0.2
                  portfolioValueUsd: 100000
                  window: 180d
                  confidence: 0.95
                  horizon: 1d
                  methods: both
      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/PortfolioVarResult'
        '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
    PortfolioVarRequest:
      type: object
      properties:
        assets:
          type: array
          items:
            type: string
          minItems: 1
        weights:
          type: array
          items:
            type: number
        quantities:
          type: array
          items:
            type: number
        portfolioValueUsd:
          type: number
          exclusiveMinimum: 0
        window:
          type: string
          enum:
          - 90d
          - 180d
          default: 180d
        confidence:
          type: number
          minimum: 0.5
          maximum: 0.999
          default: 0.95
        horizon:
          type: string
          default: 1d
          example: 1d
        methods:
          type: string
          enum:
          - empirical
          - normal
          - both
          default: both
      required:
      - assets
      oneOf:
      - required:
        - weights
        - portfolioValueUsd
      - required:
        - quantities
      additionalProperties: false
    PortfolioVarResult:
      type: object
      properties:
        metric:
          type: string
          const: portfolio-var
        assets:
          type: array
          items:
            type: string
        weights:
          type: array
          items:
            type: number
        quantities:
          type: array
          items:
            type: number
        portfolioValueUsd:
          type: number
        window:
          type: string
          enum:
          - 90d
          - 180d
        confidence:
          type: number
        horizon:
          type: string
        value:
          type: object
          additionalProperties:
            type: number
        components:
          type: object
          additionalProperties: true
        componentRisk:
          type: object
          additionalProperties: true
        computedAt:
          type: string
          format: date-time
      required:
      - metric
      - assets
      - weights
      - portfolioValueUsd
      - window
      - confidence
      - horizon
      - value
      - components
      - computedAt
      additionalProperties: true
  responses:
    UpstreamUnavailable:
      description: Upstream data source unavailable or insufficient.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    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
    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.