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

# REST API

> 54 endpoints for market data, user state, L4 order books, DeFi, and trading

## Base URL

```
https://hyper.polynode.dev/v2/
```

All endpoints require an API key via `x-api-key` header or `?key=` query parameter.

## Three tiers of speed

hypernode serves data from three sources, each with different performance characteristics:

<CardGroup cols={3}>
  <Card title="Cached" icon="bolt">
    15 endpoints. Data cached in memory, refreshed every 1-60 seconds. **12,000+ req/sec.** L4 order book, market metadata, DeFi rates.
  </Card>

  <Card title="Local node" icon="server">
    22 endpoints. Queries our local HyperLiquid node directly. **4ms latency.** User state, positions, open orders, fees.
  </Card>

  <Card title="External proxy" icon="globe">
    17 endpoints. Proxied to HyperLiquid API for data not available locally. L2 orderbook, candles, trade history.
  </Card>
</CardGroup>

## Exclusive features

| Feature                                            | Description                                      | Who has it            |
| -------------------------------------------------- | ------------------------------------------------ | --------------------- |
| [L4 Order Book](/rest/l4/overview)                 | Every individual order with wallet address       | **Only hypernode**    |
| [Priority Auction](/rest/defi/priority-auction)    | MEV data: gossip priority bidding                | **Only hypernode**    |
| [Borrow/Lend Rates](/rest/defi/borrow-lend)        | Real-time reserve states                         | From our local node   |
| [Perp Categories](/rest/discovery/perp-categories) | Asset classification (crypto/stocks/commodities) | From our local node   |
| [Prediction Markets](/rest/predictions/overview)   | HIP-4 outcome trading (testnet)                  | Convenience endpoints |

## Rate limits

| Tier       | REST req/sec | L4 req/sec | Price    |
| ---------- | ------------ | ---------- | -------- |
| free       | 2            | 0          | \$0      |
| starter    | 10           | 1          | \$50/mo  |
| growth     | 30           | 5          | \$200/mo |
| pro        | 100          | 20         | custom   |
| enterprise | 500          | 100        | \$750/mo |

## Authentication

Same API keys as the WebSocket stream. Keys are prefixed with `pn_live_`.

```bash theme={null}
# Via header
curl -H "x-api-key: pn_live_YOUR_KEY" "https://hyper.polynode.dev/v2/meta"

# Via query param
curl "https://hyper.polynode.dev/v2/meta?key=pn_live_YOUR_KEY"
```

[Sign up at polynode.dev](https://polynode.dev) to get an API key.