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-book-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 book 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 book
paths:
  /hyperliquid-book/coverage:
    get:
      operationId: getHyperliquidBookCoverage
      summary: List retained Hyperliquid completed-minute book coverage
      tags:
      - Hyperliquid book
      security: []
      responses:
        '200':
          description: Published dates, exact boundaries, market panel, and cadence.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HyperliquidBookCoverage'
  /hyperliquid-book/bbo:
    get:
      operationId: getHyperliquidBookBbo
      summary: Read Hyperliquid completed-minute bbo
      description: Returns completed-minute midpoint, spread, microprice, top-level imbalance, and displayed top-level sizes from time-weighted Hyperliquid BBO observations. The immutable artifact SHA-256, v2 schema, exact interval, market identity, and metric-specific coverage are validated before payment. Publication is currently daily, so use the free coverage endpoint to discover retained intervals; this is not a live quote endpoint.
      tags:
      - Hyperliquid book
      parameters:
      - name: pair
        in: query
        required: true
        description: 'Exact Hyperliquid market identity. The xyz: namespace is significant.'
        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: BTC
      - name: intervalEnd
        in: query
        required: true
        description: Required exclusive UTC minute end from /hyperliquid-book/coverage. Accepts ISO UTC timestamps with or without .000 milliseconds.
        schema:
          type: string
          format: date-time
          example: '2026-10-23T00:00:00.000Z'
      security:
      - x402: []
      x-payment-info:
        price:
          fixed:
            mode: fixed
            currency: USD
            amount: '0.01'
        protocols:
        - x402: {}
      x-dripmetrics-paid: true
      x-x402:
        priceUsd: '0.01'
        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/HyperliquidBookMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /hyperliquid-book/depth:
    get:
      operationId: getHyperliquidBookDepth
      summary: Read Hyperliquid completed-minute depth
      description: Returns completed-minute time-weighted bid/ask base quantity, USD notional, total USD depth, and imbalance for a fixed level count or fully observed midpoint-relative band. The immutable artifact SHA-256, v2 schema, exact interval, market identity, and metric-specific coverage are validated before payment. Publication is currently daily, so use the free coverage endpoint to discover retained intervals; this is not a live quote endpoint.
      tags:
      - Hyperliquid book
      parameters:
      - name: pair
        in: query
        required: true
        description: 'Exact Hyperliquid market identity. The xyz: namespace is significant.'
        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: BTC
      - name: intervalEnd
        in: query
        required: true
        description: Required exclusive UTC minute end from /hyperliquid-book/coverage. Accepts ISO UTC timestamps with or without .000 milliseconds.
        schema:
          type: string
          format: date-time
          example: '2026-10-23T00:00:00.000Z'
      - name: depthLevels
        in: query
        required: false
        description: Time-weighted depth over the first N visible levels. Mutually exclusive with bpsDistance.
        schema:
          type: integer
          enum:
          - 1
          - 5
          - 10
          - 20
          default: 10
      - name: bpsDistance
        in: query
        required: false
        description: Time-weighted midpoint-relative depth band. Mutually exclusive with depthLevels.
        schema:
          type: integer
          enum:
          - 1
          - 5
          - 10
      security:
      - x402: []
      x-payment-info:
        price:
          fixed:
            mode: fixed
            currency: USD
            amount: '0.01'
        protocols:
        - x402: {}
      x-dripmetrics-paid: true
      x-x402:
        priceUsd: '0.01'
        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/HyperliquidBookMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /hyperliquid-book/execution-impact:
    get:
      operationId: getHyperliquidBookExecutionImpact
      summary: Read Hyperliquid completed-minute execution-impact
      description: Returns closing visible-book VWAP and slippage for a fixed order side and USD notional. Requests exceeding the visible 20-level book fail before payment. The immutable artifact SHA-256, v2 schema, exact interval, market identity, and metric-specific coverage are validated before payment. Publication is currently daily, so use the free coverage endpoint to discover retained intervals; this is not a live quote endpoint.
      tags:
      - Hyperliquid book
      parameters:
      - name: pair
        in: query
        required: true
        description: 'Exact Hyperliquid market identity. The xyz: namespace is significant.'
        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: BTC
      - name: intervalEnd
        in: query
        required: true
        description: Required exclusive UTC minute end from /hyperliquid-book/coverage. Accepts ISO UTC timestamps with or without .000 milliseconds.
        schema:
          type: string
          format: date-time
          example: '2026-10-23T00:00:00.000Z'
      - name: side
        in: query
        required: true
        description: Hypothetical aggressive order side.
        schema:
          type: string
          enum:
          - buy
          - sell
      - name: notionalUsd
        in: query
        required: true
        description: Stored closing-book execution notional in USD.
        schema:
          type: number
          enum:
          - 1000
          - 10000
          - 100000
      security:
      - x402: []
      x-payment-info:
        price:
          fixed:
            mode: fixed
            currency: USD
            amount: '0.01'
        protocols:
        - x402: {}
      x-dripmetrics-paid: true
      x-x402:
        priceUsd: '0.01'
        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/HyperliquidBookMetricResult'
        '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
    HyperliquidBookCoverage:
      type: object
      properties:
        venue:
          type: string
          const: hyperliquid
        dataset:
          type: string
        processingVersion:
          type: string
          const: hyperliquid-book-minute-v2
        interval:
          type: string
          const: 1m
        intervalEndSemantics:
          type: string
          const: exclusive
        markets:
          type: array
          items:
            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
        metrics:
          type: array
          items:
            type: string
            enum:
            - bbo
            - depth
            - execution-impact
        publishedDates:
          type: array
          items:
            type: string
            format: date
        earliestIntervalEnd:
          type:
          - string
          - 'null'
          format: date-time
        latestIntervalEnd:
          type:
          - string
          - 'null'
          format: date-time
        completedDayCount:
          type: integer
          minimum: 0
        publicationCadence:
          type: string
          const: daily
        generatedAt:
          type: string
          format: date-time
      required:
      - venue
      - dataset
      - processingVersion
      - interval
      - intervalEndSemantics
      - markets
      - metrics
      - publishedDates
      - earliestIntervalEnd
      - latestIntervalEnd
      - completedDayCount
      - publicationCadence
      - generatedAt
      additionalProperties: false
    HyperliquidBookMetricResult:
      type: object
      properties:
        metric:
          type: string
          enum:
          - bbo
          - depth
          - execution-impact
        methodologyVersion:
          type: string
          const: hyperliquid-book-minute-v2
        pair:
          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
        exchange:
          type: string
          const: hyperliquid
        interval:
          type: string
          const: 1m
        intervalStart:
          type: string
          format: date-time
        intervalEnd:
          type: string
          format: date-time
        intervalEndSemantics:
          type: string
          const: exclusive
        value:
          type: number
        units:
          type: object
          additionalProperties:
            type: string
        components:
          type: object
          additionalProperties: true
        sampleSize:
          type: object
          additionalProperties: true
        quality:
          type: object
          additionalProperties: true
        source:
          type: object
          additionalProperties: true
      required:
      - metric
      - methodologyVersion
      - pair
      - exchange
      - interval
      - intervalStart
      - intervalEnd
      - intervalEndSemantics
      - value
      - units
      - components
      - sampleSize
      - quality
      - source
      additionalProperties: false
  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.