Loop budget
Budget the heavy loop first
History, order flow, and deep-book pulls move the bill. Price those before the convenience routes.
Credits & Quotas
Price the expensive routes before you size polling, replay, or backfills.
Endpoint cost map
Price the heavy routes first. That is where the real budget moves.
- Low-cost routes
- Freshness, instruments, current state
- Heavy routes
- History, order flow, L3/L4 depth
- WebSocket
- 1 credit per message
| Endpoint | Scope | Credits |
|---|---|---|
| GET /v1/*/instruments, /*/current, /*/freshness/:symbol | Hyperliquid | 1 |
| GET /v1/hyperliquid/orderbook/:symbol | Hyperliquid | 1 |
| GET /v1/lighter/orderbook/:symbol | Lighter.xyz | 2 |
| GET /v1/hyperliquid/hip3/orderbook/:symbol (Pro+) | HIP-3 | 1 |
| GET /v1/hyperliquid/orderbook/:symbol/history | Hyperliquid | 5 |
| GET /v1/hyperliquid/hip3/orderbook/:symbol/history (Pro+) | HIP-3 | 5 |
| GET /v1/lighter/orderbook/:symbol/history | Lighter.xyz | 10 |
| GET /v1/*/trades/:symbol | Hyperliquid | 2 |
| GET /v1/*/funding/:symbol | Hyperliquid | 2 |
| GET /v1/*/openinterest/:symbol | Hyperliquid | 2 |
| GET /v1/*/summary/:symbol | Hyperliquid | 2 |
| GET /v1/*/prices/:symbol | Hyperliquid | 2 |
| GET /v1/*/candles/:symbol | Hyperliquid | 3 |
| GET /v1/hyperliquid/liquidations/:symbol | Hyperliquid | 3 |
| GET /v1/hyperliquid/liquidations/:symbol/volume | Hyperliquid | 3 |
| GET /v1/*/orders/:symbol/history (Pro+) | Hyperliquid | 3 |
| GET /v1/*/orders/:symbol/flow (Pro+) | Hyperliquid | 5 |
| GET /v1/*/orders/:symbol/tpsl (Pro+) | Hyperliquid | 3 |
| GET /v1/*/orderbook/:symbol/l4 (Pro+) | Hyperliquid | 10 |
| GET /v1/*/orderbook/:symbol/l4/diffs (Pro+) | Hyperliquid | 3 |
| GET /v1/*/orderbook/:symbol/l4/history (Build+) | Hyperliquid | 3 |
| GET /v1/lighter/l3orderbook/:symbol (Pro+) | Lighter.xyz | 5 |
| GET /v1/lighter/l3orderbook/:symbol/history (Pro+) | Lighter.xyz | 10 |
| GET /v1/data-quality/coverage/:exchange/:symbol | Data Quality | 5 |
| GET /v1/data-quality/* (other) | Data Quality | 1 |
| WebSocket message | WebSocket | 1 |
Budgeting rules
Budget the heaviest loop first, then add the convenience routes around it.
Venue premium
Treat Lighter history as its own line item
Lighter order book history costs 10 credits per request, so it should not share the same budget model as Hyperliquid.
Reality check
Model the mix before you ship it
A loop with 1,000 order books and 500 history pulls is already 3,500 credits. Do the math before you automate.
Where the budget changes
These are the exceptions that usually change the budget after the first pass.
Lighter.xyz
High detail, higher credit cost
Checkpoint-to-tick reconstruction stays plan-gated, and order book history remains the expensive outlier.
HIP-3
Builder-perp breadth is plan-gated
Free still includes km:US500. Build+ opens the wider builder-perp family under the Hyperliquid namespace.
WebSocket
Streaming is usually cheaper than polling
Messages bill at 1 credit each, so live transport often beats frequent REST loops once the client is running.
What to confirm after pricing
Once the cost is clear, lock throughput and response shape.