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-hyperliquid-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 Hyperliquid 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: Hyperliquid
paths:
  /hyperliquid/historical-volatility:
    get:
      operationId: getHyperliquidHistoricalVolatility
      summary: Compute Hyperliquid historical-volatility
      description: Computes a Hyperliquid candle-derived metric from public 1m candle snapshots.
      tags:
      - Hyperliquid
      parameters:
      - name: pair
        in: query
        required: true
        description: 'Hyperliquid market identifier. Alias: coin. Required for discovery probes so validation reaches the x402 challenge.'
        schema:
          type: string
          example: BTC
      - name: coin
        in: query
        required: false
        description: Backward-compatible alias for pair.
        schema:
          type: string
          example: BTC
      - name: window
        in: query
        required: false
        description: Lookback window.
        schema:
          type: string
          enum:
          - 30m
          - 1h
          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/HyperliquidMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /hyperliquid/realized-vol:
    get:
      operationId: getHyperliquidRealizedVol
      summary: Compute Hyperliquid realized-vol
      description: Computes a Hyperliquid candle-derived metric from public 1m candle snapshots.
      tags:
      - Hyperliquid
      parameters:
      - name: pair
        in: query
        required: true
        description: 'Hyperliquid market identifier. Alias: coin. Required for discovery probes so validation reaches the x402 challenge.'
        schema:
          type: string
          example: BTC
      - name: coin
        in: query
        required: false
        description: Backward-compatible alias for pair.
        schema:
          type: string
          example: BTC
      - name: window
        in: query
        required: false
        description: Lookback window.
        schema:
          type: string
          enum:
          - 30m
          - 1h
          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/HyperliquidMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /hyperliquid/momentum:
    get:
      operationId: getHyperliquidMomentum
      summary: Compute Hyperliquid momentum
      description: Computes a Hyperliquid candle-derived metric from public 1m candle snapshots.
      tags:
      - Hyperliquid
      parameters:
      - name: pair
        in: query
        required: true
        description: 'Hyperliquid market identifier. Alias: coin. Required for discovery probes so validation reaches the x402 challenge.'
        schema:
          type: string
          example: BTC
      - name: coin
        in: query
        required: false
        description: Backward-compatible alias for pair.
        schema:
          type: string
          example: BTC
      - name: window
        in: query
        required: false
        description: Lookback window.
        schema:
          type: string
          enum:
          - 30m
          - 1h
          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/HyperliquidMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /hyperliquid/reversal:
    get:
      operationId: getHyperliquidReversal
      summary: Compute Hyperliquid reversal
      description: Computes a Hyperliquid candle-derived metric from public 1m candle snapshots.
      tags:
      - Hyperliquid
      parameters:
      - name: pair
        in: query
        required: true
        description: 'Hyperliquid market identifier. Alias: coin. Required for discovery probes so validation reaches the x402 challenge.'
        schema:
          type: string
          example: BTC
      - name: coin
        in: query
        required: false
        description: Backward-compatible alias for pair.
        schema:
          type: string
          example: BTC
      - name: window
        in: query
        required: false
        description: Lookback window.
        schema:
          type: string
          enum:
          - 30m
          - 1h
          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/HyperliquidMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /hyperliquid/drawdown:
    get:
      operationId: getHyperliquidDrawdown
      summary: Compute Hyperliquid drawdown
      description: Computes a Hyperliquid candle-derived metric from public 1m candle snapshots.
      tags:
      - Hyperliquid
      parameters:
      - name: pair
        in: query
        required: true
        description: 'Hyperliquid market identifier. Alias: coin. Required for discovery probes so validation reaches the x402 challenge.'
        schema:
          type: string
          example: BTC
      - name: coin
        in: query
        required: false
        description: Backward-compatible alias for pair.
        schema:
          type: string
          example: BTC
      - name: window
        in: query
        required: false
        description: Lookback window.
        schema:
          type: string
          enum:
          - 30m
          - 1h
          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/HyperliquidMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /hyperliquid/downside-semivolatility:
    get:
      operationId: getHyperliquidDownsideSemivolatility
      summary: Compute Hyperliquid downside-semivolatility
      description: Computes a Hyperliquid candle-derived metric from public 1m candle snapshots.
      tags:
      - Hyperliquid
      parameters:
      - name: pair
        in: query
        required: true
        description: 'Hyperliquid market identifier. Alias: coin. Required for discovery probes so validation reaches the x402 challenge.'
        schema:
          type: string
          example: BTC
      - name: coin
        in: query
        required: false
        description: Backward-compatible alias for pair.
        schema:
          type: string
          example: BTC
      - name: window
        in: query
        required: false
        description: Lookback window.
        schema:
          type: string
          enum:
          - 30m
          - 1h
          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/HyperliquidMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /hyperliquid/vol-of-vol:
    get:
      operationId: getHyperliquidVolOfVol
      summary: Compute Hyperliquid vol-of-vol
      description: Computes a Hyperliquid candle-derived metric from public 1m candle snapshots.
      tags:
      - Hyperliquid
      parameters:
      - name: pair
        in: query
        required: true
        description: 'Hyperliquid market identifier. Alias: coin. Required for discovery probes so validation reaches the x402 challenge.'
        schema:
          type: string
          example: BTC
      - name: coin
        in: query
        required: false
        description: Backward-compatible alias for pair.
        schema:
          type: string
          example: BTC
      - name: window
        in: query
        required: false
        description: Lookback window.
        schema:
          type: string
          enum:
          - 30m
          - 1h
          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/HyperliquidMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /hyperliquid/beta:
    get:
      operationId: getHyperliquidBeta
      summary: Compute Hyperliquid beta
      description: Computes a Hyperliquid candle-derived metric from public 1m candle snapshots.
      tags:
      - Hyperliquid
      parameters:
      - name: pair
        in: query
        required: true
        description: 'Hyperliquid market identifier. Alias: coin. Required for discovery probes so validation reaches the x402 challenge.'
        schema:
          type: string
          example: xyz:SPCX
      - name: coin
        in: query
        required: false
        description: Backward-compatible alias for pair.
        schema:
          type: string
          example: xyz:SPCX
      - name: window
        in: query
        required: false
        description: Lookback window.
        schema:
          type: string
          enum:
          - 30m
          - 1h
          default: 30m
      - name: benchmark
        in: query
        required: false
        description: Benchmark market for beta.
        schema:
          type: string
          default: xyz:SP500
      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/HyperliquidMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /hyperliquid/participant-concentration:
    get:
      operationId: getHyperliquidParticipantConcentration
      summary: Compute Hyperliquid participant-concentration
      description: Computes aggregate participant, buyer, seller, maker, and taker concentration from DripMetrics' complete rolling Hyperliquid trade tape. Raw addresses are never returned.
      tags:
      - Hyperliquid
      parameters:
      - name: pair
        in: query
        required: true
        description: 'Hyperliquid market identifier. Alias: coin. Required for discovery probes so validation reaches the x402 challenge.'
        schema:
          type: string
          enum:
          - BTC
          - ETH
          - SOL
          - HYPE
          - xyz:CL
          - xyz:BRENTOIL
          - xyz:NATGAS
          - xyz:HO
          - xyz:GOLD
          - xyz:TSLA
          - xyz:NVDA
          - xyz:PLTR
          - xyz:SPCX
          - xyz:MU
          - xyz:SKHX
          - xyz:SKHY
          - xyz:SNDK
          - xyz:DRAM
          - xyz:INTC
          - xyz:AMD
          - xyz:CRCL
          - xyz:MSTR
          - xyz:SP500
          - xyz:XYZ100
          example: xyz:TSLA
      - name: coin
        in: query
        required: false
        description: Backward-compatible alias for pair.
        schema:
          type: string
          enum:
          - BTC
          - ETH
          - SOL
          - HYPE
          - xyz:CL
          - xyz:BRENTOIL
          - xyz:NATGAS
          - xyz:HO
          - xyz:GOLD
          - xyz:TSLA
          - xyz:NVDA
          - xyz:PLTR
          - xyz:SPCX
          - xyz:MU
          - xyz:SKHX
          - xyz:SKHY
          - xyz:SNDK
          - xyz:DRAM
          - xyz:INTC
          - xyz:AMD
          - xyz:CRCL
          - xyz:MSTR
          - xyz:SP500
          - xyz:XYZ100
          example: xyz:TSLA
      - name: window
        in: query
        required: false
        description: Lookback window.
        schema:
          type: string
          enum:
          - 30m
          - 1h
          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/HyperliquidParticipantConcentrationResult'
        '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
    HyperliquidConcentrationStats:
      type: object
      properties:
        uniqueAddresses:
          type: integer
          minimum: 1
        hhi:
          type: number
          minimum: 0
          maximum: 1
        effectiveCount:
          type: number
          minimum: 1
        top1Share:
          type: number
          minimum: 0
          maximum: 1
        top5Share:
          type: number
          minimum: 0
          maximum: 1
        top10Share:
          type: number
          minimum: 0
          maximum: 1
      required:
      - uniqueAddresses
      - hhi
      - effectiveCount
      - top1Share
      - top5Share
      - top10Share
      additionalProperties: false
    HyperliquidParticipantConcentrationResult:
      type: object
      properties:
        metric:
          type: string
          const: participant-concentration
        pair:
          type: string
        exchange:
          type: string
          const: hyperliquid
        window:
          type: string
          enum:
          - 30m
          - 1h
        value:
          type: number
          minimum: 0
          maximum: 1
        components:
          type: object
          properties:
            totalQuoteVolume:
              type: number
              minimum: 0
            addressObservations:
              type: integer
              minimum: 0
            participantVolumeAttribution:
              type: string
              const: buyer_and_seller_each_receive_full_match_quote_volume
            participant:
              $ref: '#/components/schemas/HyperliquidConcentrationStats'
            buyer:
              $ref: '#/components/schemas/HyperliquidConcentrationStats'
            seller:
              $ref: '#/components/schemas/HyperliquidConcentrationStats'
            maker:
              $ref: '#/components/schemas/HyperliquidConcentrationStats'
            taker:
              $ref: '#/components/schemas/HyperliquidConcentrationStats'
          required:
          - totalQuoteVolume
          - addressObservations
          - participantVolumeAttribution
          - participant
          - buyer
          - seller
          - maker
          - taker
          additionalProperties: false
        computedAt:
          type: string
          format: date-time
        tradeCount:
          type: integer
          minimum: 20
        firstTradeTime:
          type: string
          format: date-time
        lastTradeTime:
          type: string
          format: date-time
        coverage:
          type: object
          additionalProperties: true
      required:
      - metric
      - pair
      - exchange
      - window
      - value
      - components
      - computedAt
      - tradeCount
      - firstTradeTime
      - lastTradeTime
      - coverage
      additionalProperties: false
    HyperliquidMetricResult:
      type: object
      properties:
        metric:
          type: string
          enum:
          - historical-volatility
          - realized-vol
          - momentum
          - reversal
          - drawdown
          - downside-semivolatility
          - vol-of-vol
          - beta
        pair:
          type: string
        benchmark:
          type: string
        window:
          type: string
          enum:
          - 30m
          - 1h
        interval:
          type: string
          const: 1m
        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
      - window
      - interval
      - value
      - components
      - sampleSize
      - source
      - 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.