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

# Hyperliquid

> Query Hyperliquid account, market, order, and orderbook data through Allium's rate-limit-free proxy.

Allium's Hyperliquid tools take the same requests as Hyperliquid's own `info` API and run them through a proxy, so Hyperliquid's per-IP rate limits do not apply.

## Available tools

| Tool | Description |
| :- | :- |
| `get_realtime_hyperliquid_info` | Account, market, and exchange information by request `type` |
| `get_realtime_hyperliquid_fills` | Fills for a user address |
| `get_realtime_hyperliquid_order_history` | Order history for a user address |
| `get_realtime_hyperliquid_order_status` | Status of one order by `oid` |
| `get_realtime_hyperliquid_orderbook_snapshot` | Complete orderbook snapshot for all pairs |
| `get_realtime_hyperliquid_asset_contexts` | `metaAndAssetCtxs` with history: mark, oracle and mid prices, funding and open interest per coin |

<Info>
  These tools are part of the Realtime API but only cover Hyperliquid. For Hyperliquid's on-chain historical data, query the [Hyperliquid schemas](/historical-data/supported-blockchains/hyperliquid/overview) with SQL.
</Info>

## Info requests

`get_realtime_hyperliquid_info` takes any supported Hyperliquid info request: `type` selects the request, and the other fields depend on that type.

```json theme={null}
{
  "name": "get_realtime_hyperliquid_info",
  "arguments": {
    "type": "clearinghouseState",
    "user": "0x0000000000000000000000000000000000000000"
  }
}
```

Read the full list of supported request types first:

```json theme={null}
{
  "name": "browse_docs",
  "arguments": { "path": "api/developer/hyperliquid/info.md" }
}
```

## Fills, order history, and order status

Each of these request types has its own tool with an explicit argument schema.

<Tabs>
  <Tab title="Fills">
    ```json theme={null}
    {
      "name": "get_realtime_hyperliquid_fills",
      "arguments": {
        "type": "userFillsByTime",
        "user": "0x0000000000000000000000000000000000000000",
        "startTime": 1767225600000,
        "endTime": 1769904000000,
        "aggregateByTime": true
      }
    }
    ```

    `type` and `user` are required. Timestamps are Hyperliquid-style epoch milliseconds.

    `startTime` and `endTime` apply only when `type` is `userFillsByTime`. `aggregateByTime` and `twapMode` apply to that type and to `userFills`.
  </Tab>

  <Tab title="Order history">
    ```json theme={null}
    {
      "name": "get_realtime_hyperliquid_order_history",
      "arguments": {
        "type": "historicalOrders",
        "user": "0x0000000000000000000000000000000000000000",
        "startTime": 1767225600000
      }
    }
    ```
  </Tab>

  <Tab title="Order status">
    ```json theme={null}
    {
      "name": "get_realtime_hyperliquid_order_status",
      "arguments": {
        "type": "orderStatus",
        "user": "0x0000000000000000000000000000000000000000",
        "oid": 123456789
      }
    }
    ```

    All three fields are required.
  </Tab>
</Tabs>

## Orderbook snapshot

`get_realtime_hyperliquid_orderbook_snapshot` takes no arguments and returns every pair at once.

```json theme={null}
{ "name": "get_realtime_hyperliquid_orderbook_snapshot", "arguments": {} }
```

<Warning>
  The response can be large. Have your agent filter it down to the pairs it needs before keeping it in context.
</Warning>

## Documentation paths

Each tool's description carries its `browse_docs` path: the authoritative reference for parameters and response shape.

| Tool | Docs path |
| :- | :- |
| `get_realtime_hyperliquid_info` | `api/developer/hyperliquid/info.md` |
| `get_realtime_hyperliquid_fills` | `api/developer/hyperliquid/fills.md` |
| `get_realtime_hyperliquid_order_history` | `api/developer/hyperliquid/order-history.md` |
| `get_realtime_hyperliquid_order_status` | `api/developer/hyperliquid/order-status.md` |
| `get_realtime_hyperliquid_orderbook_snapshot` | `api/developer/hyperliquid/orderbook-snapshot.md` |
| `get_realtime_hyperliquid_asset_contexts` | `api/developer/hyperliquid/asset-contexts.md` |

<Warning>
  Five of these tools were renamed in September 2026. The old `realtime_*` names no longer run: calling them will return an error. `get_realtime_hyperliquid_asset_contexts` is new and never had an old name. See [Renamed tools](/ai/mcp/tools-reference/realtime#renamed-tools).
</Warning>

## Related resources

<CardGroup cols={2}>
  <Card title="Hyperliquid API" icon="bolt" href="/api/developer/hyperliquid/overview">
    The REST endpoints behind these tools
  </Card>

  <Card title="Hyperliquid data" icon="database" href="/historical-data/supported-blockchains/hyperliquid/overview">
    Historical Hyperliquid schemas for SQL
  </Card>

  <Card title="Realtime data" icon="bolt" href="/ai/mcp/tools-reference/realtime">
    Prices, balances, holdings, and tokens
  </Card>

  <Card title="Billing & limits" icon="receipt" href="/ai/mcp/tools-reference/billing-and-limits">
    These tools consume Developer Units
  </Card>
</CardGroup>