{"uid":"cap_svpzqnAPzrtzp29ayavq3","slug":"hyperliquid-data-mcp-dispatch-25de2a41","name":"Hyperliquid-data MCP Dispatch","description":"First-party Hyperliquid trading intelligence: perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and HIP-4 prediction markets - computed from our own node_fills ledger plus the Hyperliquid public info API (no third-party data source). Free discovery (/healthz, /v1/stats, /.well-known/x402, /v1/openapi.json) and free sample routes (/v1/markets/overview, /v1/assets); all other API calls are $0.001 USDC per request via x402 on Base (no account, no API key).","url":"https://hyperliquid-data.v1337.org/v1/mcp/dispatch","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","description":"Operator-defined JSON payload. Probe the upstream or consult the operator's /openapi.json for the concrete shape.","additionalProperties":true},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_48Ja_JYXI4JD6UM3OXzuU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Dispatches queries to Hyperliquid trading intelligence endpoints covering perp fills, position lifecycles, leaderboards, liquidation risk, and HIP-4 prediction markets via a unified MCP POST interface.","exampleAgentPrompt":"Pull the top 20 traders from the Hyperliquid all-wallet leaderboard and show me their PnL, fill counts, and liquidation exposure — use the leaderboard MCP method with a POST body targeting the rankings endpoint.","exampleUseCases":[{"title":"Monitor liquidation risk for active traders","prompt":"Check the liquidation risk scores for the top 50 traders on Hyperliquid right now and flag anyone with exposure above 80% — I need to know who's close to getting liquidated."},{"title":"Analyze recent fills for a wallet address","prompt":"Pull the last 100 perpetual fills for this wallet address and break down which assets they've been trading, their average position sizes, and whether they're net long or short overall."},{"title":"Track HIP-4 prediction market activity","prompt":"Show me the current state of the HIP-4 prediction markets on Hyperliquid — what's the latest market data, volume, and which predictions are most actively traded right now?"}],"resultDescription":"A JSON response containing the requested Hyperliquid trading intelligence data — which may include arrays of perp fill records, position lifecycle events, leaderboard entries with PnL and rank, trader cohort breakdowns, liquidation risk scores, or HIP-4 prediction market state, depending on the MCP method dispatched.","failureModes":["402 Payment Required if x402 USDC micropayment on Base is not attached or insufficient","400 Bad Request if the MCP method name or body shape is invalid","404 if the requested asset or wallet is not found in the node_fills ledger","500 Internal Server Error if the upstream Hyperliquid info API is unavailable","Empty result set if wallet has no fills or positions in the requested timeframe"],"whenToPreferThis":"Choose this endpoint when you need first-party, node-level Hyperliquid data (not aggregated third-party data) covering perp fills, position lifecycles, leaderboards, liquidation risk, or HIP-4 prediction markets. It is especially valuable when you need trader cohort analysis or all-wallet leaderboard rankings not available through the standard Hyperliquid public API alone. At $0.001 USDC per call via x402, it is cost-effective for frequent programmatic queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T23:28:33.205Z","isFirstParty":false}