currentDepth

Get real-time cumulative orderbook depth at multiple BPS levels for all markets.

New endpoint - this endpoint is not a part of original Hyperliquid API and is added by us for builder convenience.

⚠️ This is an add-on endpoint - access has to be purchased separately.

Overview

The currentDepth endpoint returns a real-time snapshot of cumulative orderbook depth at wide BPS levels (10, 25, 50, 100, 200, 500) for all markets. Depth is computed from the full L4 orderbook with no minimum liquidity filter.

Key details:

• Refreshed every second (same cadence as foundational data snapshots)

• Returns all markets in a single batch response

• Depth values are cumulative (e.g., 50 bps includes all liquidity within 50 bps)

• Grouped by DEX, filterable with optional dex parameter

• Values are in USD

• Includes timestampMs for data freshness verification

Request

Endpoint: POST /info

Field	Type	Description
type	string	Must be "currentDepth"
dex	string	Filter by DEX (e.g., "hyperliquid", "hyna") (optional)

cURL

# All markets, all DEXes
curl -X POST https://api.hydromancer.xyz/info \
  -H "Authorization: Bearer $HYDROMANCER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "currentDepth"}'

# Filter by DEX
curl -X POST https://api.hydromancer.xyz/info \
  -H "Authorization: Bearer $HYDROMANCER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "currentDepth", "dex": "hyperliquid"}'

Python

import requests
import os

response = requests.post(
    'https://api.hydromancer.xyz/info',
    json={
        'type': 'currentDepth',
        'dex': 'hyperliquid'  # optional
    },
    headers={
        'Authorization': f'Bearer {os.environ.get("HYDROMANCER_API_KEY")}',
        'Content-Type': 'application/json'
    }
)

print(response.json())

Javascript

import axios from 'axios';

try {
    const response = await axios.post('https://api.hydromancer.xyz/info', {
        type: 'currentDepth',
        dex: 'hyperliquid'  // optional
    }, {
        headers: {
            'Authorization': `Bearer ${process.env.HYDROMANCER_API_KEY}`,
            'Content-Type': 'application/json'
        }
    });

    console.log(response.data);
} catch (error) {
    console.error('Error:', error.message);
}

Response

{
  "timestampMs": 1712930000000,
  "data": [
    {
      "coin": "BTC",
      "dex": "hyperliquid",
      "levels": [
        { "bps": 10, "bidDepthUsd": 4523891.23, "askDepthUsd": 3891234.56 },
        { "bps": 25, "bidDepthUsd": 12345678.90, "askDepthUsd": 11234567.89 },
        { "bps": 50, "bidDepthUsd": 28456789.01, "askDepthUsd": 26789012.34 },
        { "bps": 100, "bidDepthUsd": 45678901.23, "askDepthUsd": 43210987.65 },
        { "bps": 200, "bidDepthUsd": 67890123.45, "askDepthUsd": 65432109.87 },
        { "bps": 500, "bidDepthUsd": 89012345.67, "askDepthUsd": 87654321.09 }
      ]
    },
    {
      "coin": "ETH",
      "dex": "hyperliquid",
      "levels": [
        { "bps": 10, "bidDepthUsd": 1234567.89, "askDepthUsd": 1123456.78 },
        { "bps": 25, "bidDepthUsd": 3456789.01, "askDepthUsd": 3234567.89 },
        { "bps": 50, "bidDepthUsd": 6789012.34, "askDepthUsd": 6543210.98 },
        { "bps": 100, "bidDepthUsd": 12345678.90, "askDepthUsd": 11234567.89 },
        { "bps": 200, "bidDepthUsd": 18901234.56, "askDepthUsd": 17890123.45 },
        { "bps": 500, "bidDepthUsd": 23456789.01, "askDepthUsd": 22345678.90 }
      ]
    }
  ]
}

Response Fields

Field	Description
timestampMs	Epoch milliseconds when the depth snapshot was computed
data	Array of per-market depth entries
data[].coin	Base coin symbol (e.g., "BTC", "ETH")
data[].dex	DEX name (e.g., "hyperliquid", "hyna")
data[].levels	Array of depth levels, one per BPS threshold
data[].levels[].bps	BPS threshold (10, 25, 50, 100, 200, 500)
data[].levels[].bidDepthUsd	Cumulative bid depth within this BPS level, in USD
data[].levels[].askDepthUsd	Cumulative ask depth within this BPS level, in USD

Comparison with marketLiquidity

Feature	currentDepth	marketLiquidity
BPS levels	10, 25, 50, 100, 200, 500	2, 5, 10, 25, 25-500
Granularity	Real-time snapshot	Time series (24h retention)
Values	USD	Market asset units
Scope	All markets in one call	Single market per call
History	Current only	Up to 24h with time filtering

Rate limits

• 5 points per request

Common errors

• 403: Permission denied - check API key

• 429: Rate limit exceeded

• 500: Internal error - depth data may not yet be published