> 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/pricing.md).

# Pricing

### REST API

Currently, each request consumes 1 token, with the exceptions described below.

#### clearinghouseState

Each [clearinghouseState](/readme/rest-api/user-position-data/clearinghousestate.md) call costs **0.025 tokens per DEX**. [spotclearinghouseState](/readme/rest-api/user-position-data/spotclearinghousestate.md) is spot-only, so it costs a **flat 0.025 tokens** regardless of how many DEXes you request.

[batchClearinghouseStates](/readme/rest-api/user-position-data/batchclearinghousestates.md) costs 0.025 tokens per user per DEX, capped at **25 tokens** per request.

#### portfolioState

[portfolioState](/readme/rest-api/user-position-data/portfoliostate.md) combines perp + spot positions and a user's account abstraction status. It costs **0.05 tokens per DEX plus a flat 0.05 tokens** per request — so a single-DEX call is **0.1 tokens**, and an all-DEXes call is `0.05 × dex_count + 0.05`.

[batchPortfolioStates](/readme/rest-api/user-position-data/batchportfoliostates.md) uses the same rate per user, capped at **50 tokens** per request.

clearinghouseState (and other calls of this type) are usually used to retrieve user positions and show them on the frontend. For clarity, we have added this pricing table to showcase the price of **clearinghouseState call for main + XYZ DEXes** per user per month on different tiers at different update cadences.

| Cadence of updates | Tokens per user per month | Starter (per user per month) | Growth (per user per month) | Scale (per user per month) |
| ------------------ | ------------------------- | ---------------------------- | --------------------------- | -------------------------- |
| Every 1 second     | 129,600                   | $77.76                       | $51.84                      | $21.60                     |
| Every 3 seconds    | 43,200                    | $25.92                       | $17.28                      | $7.20                      |
| Every 5 seconds    | 25,920                    | $15.55                       | $10.37                      | $4.32                      |
| Every 10 seconds   | 12,960                    | $7.78                        | $5.18                       | $2.16                      |
| Every 30 seconds   | 4,320                     | $2.59                        | $1.73                       | $0.72                      |

#### activeAssetData, perpAnnotation

[activeAssetData](/readme/rest-api/user-position-data/activeassetdata.md) and [perpAnnotation](/readme/rest-api/metadata/perpannotation.md) cost 0.1 tokens.

###

### **Websockets**

Currently, each tier gives you a limit of connections and max total websocket subscriptions. The tier limits are described below.

<table><thead><tr><th width="84.01959228515625"></th><th width="164.9609375">Max Connections</th><th width="202.1195068359375">Max Total Subscriptions</th><th>Max msgs to Hydromancer per minute</th><th>Orderbooks streamed</th></tr></thead><tbody><tr><td><strong>Starter</strong></td><td>50</td><td>500</td><td>300</td><td>10</td></tr><tr><td><strong>Growth</strong></td><td>500</td><td>5000</td><td>3000</td><td>50</td></tr><tr><td><strong>Scale</strong></td><td>1000</td><td>10000</td><td>6000</td><td>100</td></tr></tbody></table>

**Note**: every address passed in subscription logic counts as 1 subscription for ones where you can pass multiple (applicable to userFills, userOrderUpdates and userNonFundingLedgerUpdates).

### Add-ons

Some endpoints are ***add-ons**,* as the access needs to be purchased separately.

* [allFills](/readme/websocket/allfills.md)
* Market data add-ons ([perpSnapshot](/readme/rest-api/market-data/perpsnapshot.md), [spotSnapshot](/readme/rest-api/market-data/spotsnapshot.md), [perpTwapSnapshot](/readme/rest-api/market-data/perptwapsnapshot.md), [accountValueSnapshot](/readme/rest-api/market-data/accountvaluesnapshot.md))

### Tiers

We have three basic tiers, Starter, Growth, and Scale. We also offer bespoke pricing for partners who require a lot of requests or need granular, custom Hyperliquid data.

<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>