> For the complete documentation index, see [llms.txt](https://docs.hydromancer.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hydromancer.xyz/readme.md).

# Hydromancer - The Hyperliquid Data Layer

Hydromancer is data infrastructure for Hyperliquid. We provide real-time APIs, WebSocket streams, and analytics — so you can ship unique features faster with better data.

{% hint style="info" %}
**TL;DR**: Hydromancer is a data provider dedicated to Hyperliquid. It offers REST and WebSocket APIs with order-level and market-wide data that Hyperliquid's native API doesn't expose, streams delivered faster than the native API, and free historical data. 100+ teams on Hyperliquid use the Hydromancer stack.
{% endhint %}

### Hydromancer at a glance

Hydromancer has the broadest endpoint coverage for Hyperliquid, on a stack built for both app builders and institutions: low-latency streams, replay after disconnects and SLA-backed infrastructure. Pricing is predictable, with data streaming plans and flat-priced add-ons for market-wide data that are never metered per call, row or message.

<details>

<summary>🌐 <strong>Coverage</strong></summary>

* Hyperliquid only: perps on the main DEX and on HIP-3 DEXes, spot markets, and HIP-4 outcome markets.
* A REST API for queries and history, and a WebSocket API for real-time streams. Testnet APIs are included on every tier.

</details>

<details>

<summary>🔍 <strong>Data the native Hyperliquid API doesn't provide</strong></summary>

* **L4 orderbooks**: every resting order with the address of the user who placed it, as a [snapshot](https://docs.hydromancer.xyz/readme/rest-api/market-data/l4book.md) and as a [per-block update stream](https://docs.hydromancer.xyz/readme/websocket/orderbook-streaming/l4bookupdates.md).
* **Market-wide streams** across all users: every [fill](https://docs.hydromancer.xyz/readme/websocket/trades-data/allfills.md), [liquidation](https://docs.hydromancer.xyz/readme/websocket/trades-data/liquidationfills.md), [deposit, withdrawal and transfer](https://docs.hydromancer.xyz/readme/websocket/funding-and-deposits-data/allusernonfundingledgerevents.md), [leverage change](https://docs.hydromancer.xyz/readme/websocket/leverage-and-margin-updates/allleverageupdates.md), [TWAP status](https://docs.hydromancer.xyz/readme/websocket/twap-data/alltwapstatusupdates.md) and [TP/SL trigger order](https://docs.hydromancer.xyz/readme/websocket/tp-sl-streaming/tpslupdates.md).
* **Positioning snapshots**: the open positions of every trader ([perpSnapshots](https://docs.hydromancer.xyz/readme/rest-api/market-data/perpsnapshot.md)), spot holdings ([spotSnapshots](https://docs.hydromancer.xyz/readme/rest-api/market-data/spotsnapshot.md)) and account values ([accountValueSnapshots](https://docs.hydromancer.xyz/readme/rest-api/market-data/accountvaluesnapshot.md)).
* **Builder data**: fills, orders, funding and ledger events for a builder code and the users who approved its fee, over [REST](https://docs.hydromancer.xyz/readme/rest-api/historical-data/builderfillsbytime.md) and [WebSocket](https://docs.hydromancer.xyz/readme/websocket/builder-data.md).
* **Trader performance**: realized PnL summaries and leaderboards ([user performance](https://docs.hydromancer.xyz/readme/rest-api/user-performance.md)).
* **Liquidity analytics** per market: [current depth](https://docs.hydromancer.xyz/readme/rest-api/market-data/currentdepth.md), [liquidity history](https://docs.hydromancer.xyz/readme/rest-api/market-data/marketliquidityhistory.md) and [slippage history](https://docs.hydromancer.xyz/readme/rest-api/market-data/slippagehistory.md).

</details>

<details>

<summary>🛡️ <strong>Reliability</strong></summary>

* WebSocket sessions survive disconnects. Reconnect with your `sessionId` and `cursor`: subscriptions are restored automatically and missed data is replayed (up to 15 minutes for most channels, 3 minutes for L4 updates). `hasGap` tells you when history is incomplete. See [Session Management and Reconnection](https://docs.hydromancer.xyz/readme/websocket/session-management-and-reconnection.md).
* Every live message carries a `seq` for gap detection and a `cursor` for resuming.
* The [Python SDK](https://github.com/hydromancerxyz/hydromancer-sdk) handles L4 and TP/SL book sync and recovery for you.
* Incidents are published as [public incident reports](https://docs.hydromancer.xyz/readme/incidents.md).
* Teams running their own nodes can use [Peering](https://docs.hydromancer.xyz/peering.md), with a 99.99% uptime SLA.

</details>

<details>

<summary>📏 <strong>Limits</strong></summary>

* REST: a per-minute weight budget of 5,000 (Starter), 20,000 (Growth) or 50,000 (Scale). See [Rate Limits and User Limits](https://docs.hydromancer.xyz/readme/rest-api/rate-limits-and-user-limits.md).
* WebSocket: up to 1,000 connections and 10,000 subscriptions on Scale, with per-coin caps per feed (for example, 200 coins of L4 updates on Scale). Feeds that cover every market are add-ons. See [WebSocket limits](https://docs.hydromancer.xyz/readme/websocket/rate-limits-user-limits-and-heartbeats.md).

</details>

<details>

<summary>💵 <strong>Pricing model</strong></summary>

* Plans: Starter $300, Growth $1,200 and Scale $2,500 per month, each with a monthly token allowance for REST calls. Enterprise pricing is custom.
* Add-ons for market-wide data are a **flat monthly price for access**. They are not billed per call, per row, per message or per GB. See [Pricing](https://docs.hydromancer.xyz/readme/pricing.md).
* Historical data is free through [Reservoir](https://docs.hydromancer.xyz/reservoir.md), under CC BY 4.0, with no API key required.

</details>

<details>

<summary>🤖 <strong>For AI agents</strong></summary>

* The full documentation index is at [llms.txt](https://docs.hydromancer.xyz/llms.txt).
* Any page is available as markdown by appending `.md` to its URL.

</details>

### Who builds on Hydromancer

Hydromancer stack is optimized for demanding teams requiring granular data, low latency real-time streams, and better developer experience.

<details>

<summary>🛠 <strong>App builders</strong></summary>

You're building a trading interface, portfolio tracker, analytics dashboard, or DeFi product on Hyperliquid. You need real-time data that's fast, reliable, and easy to integrate.

**Why Hydromancer:**

* **Unique endpoints** — Hydromancer rebuilt and extended the schema with endpoints that don't exist natively, so you write less code and ship faster. Based on feedback from 30+ builders.
* **Real-time data** — Hydromancer provides WebSocket streams for orderbooks, trades, account updates, and more. They run at lower latency than native Hyperliquid connections.

</details>

<details>

<summary><strong>🧪 HIP-3 or HIP-4 deployers</strong></summary>

You are deploying markets on HIP-3 or HIP-4 and need to monitor your markets' liquidity, user activity, and show the traction of your DEX to the wider audience.

**Why Hydromancer:**

* **Granular data and metrics** - liquidity metrics with sub-second granularity, real-time market maker tracking, and chain replay capabilities.
* **Purpose-built infrastructure** - Hydromancer's product offering is shaped by deployer requirements and designed to drive impact to your HIP-3 DEX performance. Battle-tested, mission-critical features.

</details>

<details>

<summary><strong>⚡ Market Makers &#x26; Quantitative Firms</strong></summary>

You need the fastest possible view of what's happening on Hyperliquid — orderbook updates, trades, liquidations, all of it.

**Why Hydromancer:**

* **Faster than native** — Hydromancer's orderbook streaming is faster than what Hyperliquid provides natively.
* **Full market streaming** — Subscribe to orderbook-only feeds or everything happening on Hyperliquid, depending on your needs.

</details>

#### Supporting the ecosystem

Building a public good? Just getting started as an app builder? Hydromancer provides access for public goods and early-stage teams.

Please reach out to learn more at [Hydromancer for early-stage teams](https://docs.hydromancer.xyz/readme/hydromancer-for-early-stage-teams.md). We approve 3 teams a month to the early-stage builder program.

### **Pricing**

<table><thead><tr><th>Starter</th><th>Growth</th><th width="187">Scale</th><th>Enterprise</th></tr></thead><tbody><tr><td>$<strong>300</strong> per month</td><td>$<strong>1200</strong> per month</td><td>$<strong>2500</strong> per month</td><td><strong>Custom pricing</strong></td></tr><tr><td><strong>500k</strong> tokens</td><td>3m tokens</td><td>15m tokens</td><td>Unlimited API calls</td></tr><tr><td><strong>$60</strong> per 100k tokens overage</td><td>$25 per 100k tokens overage</td><td>$10 per 100k tokens overage</td><td>Unlimited addresses monitoring</td></tr><tr><td>For recently launched apps</td><td>Best plan for scaling teams</td><td>For data-rich, large apps</td><td></td></tr><tr><td>Testnet APIs</td><td>Testnet APIs</td><td>Testnet APIs</td><td></td></tr><tr><td><strong>10</strong> orderbook streams</td><td><strong>50</strong> orderbook streams</td><td><strong>100</strong> orderbook streams</td><td></td></tr></tbody></table>

Market-wide data, such as every orderbook or every fill, is available as flat-priced add-ons. See [Pricing](https://docs.hydromancer.xyz/readme/pricing.md) for the full list.
