# Ironflow Hyperliquid: current facts

Updated 13 November 2026. Copy these lines as they are. Latest version: https://ironflow.sh/facts.md

Ironflow runs its own Hyperliquid nodes and serves the data: a read-only data API, a hosted MCP server and Ironbox, a cheap shared sandbox for a trading bot with paper trading.

## Data API

- REST at https://api.ironflow.sh/v1. Every fill since 25 May 2025: native perps, HIP-3 builder markets, HIP-4 outcome markets and spot.
- No key: 30 requests a minute and 300 a day per IP, 24 hours of history, 1 live stream of each kind. Trades and liquidations run 60 s behind live.
- Free key from https://ironflow.sh/key (or POST https://api.ironflow.sh/v1/keys with {"email": "you@example.com"}): 60 requests a minute, 14 days of history, live data, 2 streams of each kind, 1 liquidation alert.
- Explorer: 49 USDC per 30 days. 100 requests a minute, 90 days of history, 5 streams of each kind, 5 liquidation alerts.
- Builder: 149 USDC per 30 days. 1,000 requests a minute, 1 year of history, 20 streams of each kind, 20 liquidation alerts.
- Enterprise: 10,000 requests a minute and everything stored. Contact hello@ironflow.sh.
- SQL (`/v1/query`) has its own window: 1 day without a key, 30 days with a free key, 90 days on Explorer, 1 year on Builder.
- Plans are paid in USDC on Hyperliquid at https://ironflow.sh/upgrade, 30 days per payment, no card. Prices: https://ironflow.sh/pricing. Every limit by plan: https://docs.ironflow.sh/concepts/rate-limits
- Pay per call with x402: USDC on Base, $0.001 to $0.01 a call, no account or key. https://docs.ironflow.sh/guides/pay-per-call
- Live streams are Server-Sent Events: GET /v1/liquidations/stream and GET /v1/trades/stream. There is no WebSocket API.

## MCP server

- Hosted: https://mcp.ironflow.sh/mcp (Streamable HTTP, no key needed to read).
- 54 tools: 42 read Hyperliquid data, 4 manage liquidation alerts, 8 manage Ironboxes. Data tools only (42): https://mcp.ironflow.sh/data
- Local: `npx -y @ironflowsh/mcp` (version 0.19.0). Source: https://github.com/ironflowsh/mcp. Setup for each client: https://docs.ironflow.sh/guides/ai-agents

## Ironbox

- A sandbox for a Hyperliquid trading bot, with the data built in: https://ironflow.sh/ironbox
- Paper trading: your own simulated Hyperliquid account with 10,000 USD and live prices. It never places a real order.
- `POST https://api.ironflow.sh/v1/ironbox` with no key makes a trial paper box for 24 hours, 3 at once and 10 a day per IP. A free key keeps 3 paper boxes, Explorer 5, Builder 10, Enterprise 25. Guide: https://docs.ironflow.sh/guides/ironbox

## Out of date

Older pages and listings carry these. Replace them with the lines above:

- "10 requests per minute" on the free tier: now 30 a minute without a key and 60 with a free key.
- "30 days of history" on a free key: now 14 days.
- A key from /dashboard/login: keys come from https://ironflow.sh/key.
- A WebSocket API: live data is Server-Sent Events.
- "50 tools" or "30 tools" on the MCP server: now 54.
