> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperdash.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hyperdash Data API

> Hyperliquid market, account, liquidation, and analytics data from Hyperdash's own nodes, metered in credits.

The Hyperdash Data API serves live Hyperliquid market and account state from our own nodes, and history from a verified history store. Every endpoint is read-only and returns JSON by default. Every response reports its cost in credits.

| | |
| - | - |
| Base URL | `https://data.hyperdash.com` (all paths start with `/v1`) |
| Streams | `wss://data.hyperdash.com/v1/stream` |
| MCP server | `https://data.hyperdash.com/mcp` |
| OpenAPI spec | `https://data.hyperdash.com/openapi.json` |
| Docs for models | `https://data.hyperdash.com/llms.txt` |
| Console | `https://console.hyperdash.com` |

## What you can query

* **Markets.** Perp, spot, and HIP-3 markets with live mark, oracle, and mid prices, funding, open interest, order books (including the order-level L4 book), and candles from 1 minute to 1 month.
* **Accounts.** Live positions, margin, open orders, balances, fees, and sub-accounts for any wallet, plus fill, funding, ledger, and trade history, and batch reads across many wallets.
* **Liquidations.** Every liquidation event with history from Mar 22 2025, plus summaries, cascades, and maps of liquidation and stop levels.
* **Analytics.** Leaderboards, cohort positioning and flows, trader statistics, network revenue and fees, staking, lending, prediction market outcomes, and priority fee flow.
* **Streams.** WebSocket channels for trades, liquidations, fills, orders, books, and more, billed per event you acknowledge.

The full list of 192 endpoints, plus the async job endpoints, is in the [API reference](https://docs.hyperdash.com/data-api/reference/markets/candles-for-one-market-1m-…-1m.md). Every endpoint is in beta.

## How it works

1. **Workspaces and projects.** You sign in to the console, create a workspace, and pick a plan. Keys belong to a project inside the workspace, so usage is attributed to the key, the project, and the workspace.
2. **Keys.** Every request carries an API key. Live keys read production data and are billed; test keys return sample data for free. See [API keys](https://docs.hyperdash.com/data-api/authentication.md).
3. **Credits.** Each request costs a whole number of credits based on the work behind it and the rows it returns. Your plan includes a monthly allowance and you can buy more. See [Credits](https://docs.hyperdash.com/data-api/credits.md).
4. **Guardrails.** Per-request caps, per-key budgets, rate limits, and plan entitlements are checked before a query runs, so no request overshoots a limit.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.