hyperliquid-funding-mcp
v1.0.1
Published
Hyperliquid funding across all eleven venues at once, the carry spreads between them, and what builders really charge. MCP tools; paid ones settle per call in USDC over x402.
Maintainers
Readme
hyperliquid-funding-mcp
Hyperliquid funding across every venue at once, and the spreads between them.
Hyperliquid's API answers one venue per call, so the same asset's funding rate on the native exchange and on a builder-deployed venue cannot be compared without holding both. These tools hold all eleven, sampled every few minutes.
Tools
| Tool | What it answers | |
| --- | --- | --- |
| hyperliquid_carry_spreads | The widest funding spreads between venues, floored by open interest. Call before opening a carry. | 5¢ |
| hyperliquid_funding_board | Funding, open interest and premium for every perp, all eleven venues. | 1¢ |
| hyperliquid_asset | One asset across venues, with top-of-book imbalance — the part that says which side is crowded. | 1¢ |
| hyperliquid_builder_fees | What each builder actually charges, from their own published fills. | free |
A spread is a funding difference at one moment, not a guaranteed arbitrage: the venues may price the same underlying against different oracles and need not converge. Every answer that carries one says so.
Use it
{ "mcpServers": { "hyperliquid-funding": { "command": "npx", "args": ["-y", "hyperliquid-funding-mcp"] } } }With nothing else set the free tool works and the paid ones say what they need.
Paying per call
| Variable | What |
| --- | --- |
| PAY_WALLET_KEY | The agent's own key. Read from its own environment, used only to sign the payment authorisation locally, never sent anywhere. |
| PAY_CHAIN | Where that wallet's USDC is: arc (default), base, arbitrum or hyperEvm. The payment need not be on the chain the data is about. |
| PAY_MAX_USDC_PER_CALL | The most one call may cost. Default 0.05, which admits every tool here. The owner sets this. A price above it is refused before anything is signed. |
Payment is USDC over x402 through Circle Gateway, gas-free for the buyer.
You are never charged for an answer that was not produced. The service verifies the payment, produces the answer, and only then settles.
What has and has not been exercised
Audited on 18 September 2026 with Circle's own client and a real signature from
an unfunded wallet: on every route and on all four chains Circle verified the
signature, the answer was produced, and settlement was refused for one reason
only, insufficient_balance, with the answer withheld.
Hourly history since 17 August 2026 — funding, open interest and book imbalance, which Hyperliquid itself does not keep — is sold once rather than per call: https://gmtrenchor.memeogatchi.workers.dev/x402/hl/history (fifty busiest assets) and https://gmtrenchor.memeogatchi.workers.dev/x402/hl/history/full (every asset on every venue).
