{"uid":"cap_hOPiOt7VkEVqc2X1g-MHf","slug":"hyperliquid-perps-market-data-d1a6e8e6","name":"Hyperliquid Perps Market Data","description":"Hyperliquid perpetuals market data: mark price, 24h change, hourly funding rate, open interest, volume and max leverage for any perp or the top markets, plus funding history for one coin.","url":"https://chain.tollkit.dev/chain/perps?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"enum":["volume","open_interest","funding_high","funding_low","change_24h"],"type":"string","default":"volume"},"coins":{"type":"array","items":{"type":"string"},"maxItems":20,"description":"Hyperliquid coin names, e.g. [\"BTC\", \"ETH\"]. Leave out for the top markets."},"limit":{"type":"integer","default":10,"maximum":20,"minimum":1},"funding_hours":{"type":"integer","maximum":168,"minimum":1,"description":"Hourly funding history for this many hours; needs exactly one coin."}}},"responseSchema":{"type":"json","example":{"source":"Hyperliquid info API (api.hyperliquid.xyz)","markets":[{"coin":"BTC","mid_price":81696,"mark_price":81692,"premium_pct":-0.0174,"max_leverage":40,"oracle_price":81711.2,"open_interest":39978.25728,"change_24h_pct":-1.4,"prev_day_price":82851,"volume_24h_usd":1911332316,"open_interest_usd":3265903794,"funding_hourly_pct":0.00125,"funding_annualized_pct":10.95},{"coin":"ETH","mid_price":2395.25,"mark_price":2395.5,"premium_pct":-0.0584,"max_leverage":25,"oracle_price":2396.7,"open_interest":1077867.046800002,"change_24h_pct":-1.57,"prev_day_price":2433.6,"volume_24h_usd":679086982,"open_interest_usd":2582030511,"funding_hourly_pct":0.000771,"funding_annualized_pct":6.76},{"coin":"SOL","mid_price":104.515,"mark_price":104.53,"premium_pct":-0.0574,"max_leverage":20,"oracle_price":104.58,"open_interest":5481889.080000001,"change_24h_pct":-1.27,"prev_day_price":105.87,"volume_24h_usd":136218624,"open_interest_usd":573021866,"funding_hourly_pct":0.000851,"funding_annualized_pct":7.46}],"read_at":"2026-10-20T07:22:33.282Z","not_found":[],"funding_note":"Hyperliquid pays funding every hour. funding_hourly_pct is the current hourly rate; when it is positive, longs pay shorts. funding_annualized_pct is that rate × 24 × 365, for comparison only."}},"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_jlm7f-h2zoIUD_k0rCv9-","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 mark price, 24h change, hourly funding rate, open interest, volume, and max leverage for Hyperliquid perpetuals markets, plus optional funding rate history for a single coin.","exampleAgentPrompt":"Show me the top 5 Hyperliquid perp markets sorted by open interest, and also pull the last 24 hours of hourly funding rate history for BTC.","exampleUseCases":[{"title":"Monitor high-funding arbitrage opportunities","prompt":"Which Hyperliquid perp markets have the highest funding rates right now? Show me the top 10 sorted by funding rate."},{"title":"Track BTC funding rate history","prompt":"Get me the hourly funding rate history for BTC on Hyperliquid for the last 72 hours so I can see how rates have been trending."},{"title":"Check specific coin market stats","prompt":"What are the current mark price, 24h change, open interest, and max leverage for ETH and SOL perps on Hyperliquid?"}],"resultDescription":"Returns a list of perpetual market objects, each containing mark price, 24-hour percentage change, hourly funding rate, open interest, trading volume, and max leverage. If funding_hours is specified for a single coin, also includes an array of hourly historical funding rate data points.","failureModes":["Invalid coin name returns no data or error for that symbol","Requesting funding_hours with more than one coin in the coins array returns an error","limit or funding_hours out of allowed range returns validation error","Hyperliquid API downtime causes upstream fetch failure","Empty result set if coin has no active perpetual market"],"whenToPreferThis":"Use this endpoint when you need real-time or recent market data specifically from Hyperliquid's perpetuals exchange, including funding rates, open interest, and volume rankings. Prefer this over generic crypto price APIs when the user is specifically interested in Hyperliquid perp mechanics like funding rates or leverage tiers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:31:20.555Z","isFirstParty":false,"canonicalSlug":"hyperliquid-perps-market-data-d1a6e8e6"}