hlrisk - Hyperliquid Liquidation Risk
Free, read-only MCP tools for real-time Hyperliquid BTC/ETH liquidation risk: notional at risk if price moves +/-1%/3%/5%, the position closest to liquidation, funding rate, and recent backstop liquidations. The full pay-per-call x402 API (USDC on Base) is at hlrisk.paidapis.net.
Hosted MCP Server
npx add-mcp 'https://hlrisk.paidapis.net/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
hlrisk
Pay-per-call x402 APIs. USDC on Base. No accounts, no API keys, no subscriptions.
Flagship: Liquidation Risk Index
Real-time Hyperliquid BTC/ETH perpetual futures liquidation risk index, built from real on-chain position data (not a statistical estimate): notional at risk if leveraged price moves ±1%/3%/5%, the position closest to actually being liquidated, and current funding rate.
Endpoints
| Path | Price | Description |
|---|---|---|
/api/hl-liquidation-risk | $0.03 | Liquidation proximity index (flagship) |
/api/hl-liquidations | $0.02 | Rare backstop-liquidation events (last hour) |
/api/gas-price | $0.005 | Current Ethereum mainnet gas price |
/api/relay/block-number | $0.003 | Ethereum block number (relayed) |
/api/subscribe | $0.002 | Unlocks subscriber content for 5 min |
/api/transfer | $0.001–$5.00 | Direct USDC transfer, caller-specified amount |
/api/premium-data | $0.01 | Example endpoint |
How to call it
Standard x402 flow — request the endpoint, get a 402 with payment details, sign and resend with an x402-aware client. No pre-registration.
curl https://hlrisk.paidapis.net/api/hl-liquidation-risk
# -> 402 Payment Required, with payment details in the response
Machine-readable spec
/openapi.json — full OpenAPI spec with pricing (x-payment-info) per route.
/.well-known/x402 — legacy discovery manifest.
/llms.txt — agent-readable endpoint index.