{"uid":"cap_mfIkz7uuJ2fXCrgEYGR1X","slug":"hyperliquid-on-chain-markets-data-bed59e13","name":"Hyperliquid On-Chain Markets Data","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/markets/onchain","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":"unknown","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_tJnx3iom6oKwUc2cI_qJa","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":"Returns on-chain market data for Hyperliquid perpetuals, including fills, position lifecycles, leaderboards, liquidation risk, and HIP-4 prediction market data derived from first-party node fills ledger.","exampleAgentPrompt":"Pull the latest on-chain market data from Hyperliquid for BTC perps, including recent fills and any active liquidation risk — I want to understand what's happening on-chain right now.","exampleUseCases":[{"title":"Monitor liquidation risk on Hyperliquid","prompt":"Check Hyperliquid's on-chain data for ETH perps and tell me which positions are at the highest liquidation risk right now — I want to know where the danger zones are."},{"title":"Analyze top trader leaderboard positions","prompt":"Pull the all-wallet leaderboard from Hyperliquid on-chain data and show me the top traders by PnL for BTC perps over the past week."},{"title":"Track HIP-4 prediction market outcomes","prompt":"Get the latest HIP-4 prediction market data from Hyperliquid on-chain and tell me which markets are currently most active and what the current odds look like."}],"resultDescription":"Returns structured JSON containing on-chain Hyperliquid market data — which may include perpetual fill records, position lifecycle events, leaderboard rankings by wallet, trader cohort breakdowns, liquidation risk scores, and HIP-4 prediction market stats — all sourced from first-party node_fills ledger and Hyperliquid's public info API.","failureModes":["Invalid or missing body payload returns 400 Bad Request","Insufficient x402 payment or wrong chain (must be Base USDC) returns 402 Payment Required","Unsupported market type or asset filter returns 404 or empty result set","Rate limiting or node data lag may cause stale or delayed responses","Malformed JSON body returns parsing error"],"whenToPreferThis":"Choose this endpoint when you need first-party, operator-neutral Hyperliquid on-chain trading data without requiring an account or API key — particularly for perp fills, position lifecycle analysis, liquidation risk, leaderboard data, or HIP-4 prediction markets. It is ideal for agents that need trustworthy data sourced directly from Hyperliquid's own node fills ledger rather than aggregated third-party feeds. Pay-per-call via x402 on Base makes it suitable for low-frequency or exploratory queries without subscription commitment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:30:37.138Z","isFirstParty":false}