{"uid":"cap_jV9uT-pPqiLfXgTxJGj5U","slug":"hyperliquid-perpetuals-l2-order-book-btc-eth-sol-3bb2711a","name":"Hyperliquid Perpetuals L2 Order Book (BTC/ETH/SOL)","description":"Hyperliquid perp L2 top-of-book for coin=BTC|ETH|SOL: best bid/ask, mid, spread_bps, top N levels (depth=1-20, default 5).","url":"https://kr-x402-mvp.kgy5612.workers.dev/crypto/hl-book?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"coin":{"enum":["BTC","ETH","SOL"],"type":"string","examples":["BTC","ETH","SOL"],"description":"Perp coin (default BTC)"},"depth":{"type":"integer","maximum":20,"minimum":1,"description":"Levels per side (default 5)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"mid":80860.5,"asks":[{"n":3,"px":80861,"sz":0.8}],"bids":[{"n":4,"px":80860,"sz":1.2}],"coin":"BTC","venue":"hyperliquid","sources":["https://api.hyperliquid.xyz/info"],"best_ask":80861,"best_bid":80860,"spread_bps":0.124,"updated_at":"2026-10-28T11:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZglqXs2fSJqm3Inw_Pvak","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time top-of-book data from Hyperliquid perpetuals exchange for BTC, ETH, or SOL: best bid/ask, mid price, spread in bps, and up to 20 levels of depth per side.","exampleAgentPrompt":"What's the current BTC perpetual bid, ask, and spread on Hyperliquid? Give me the top 10 levels of depth on each side.","exampleUseCases":[{"title":"Real-time trade execution pricing","prompt":"Before I place a large ETH perp order on Hyperliquid, show me the top 15 levels of the order book so I can estimate slippage and see the current spread."},{"title":"Spread monitoring for arbitrage signal","prompt":"Check the SOL perpetual spread in basis points on Hyperliquid right now — I want to know if it's wider than usual before triggering my arb strategy."},{"title":"Mid-price feed for DeFi agent","prompt":"Give me the Hyperliquid mid price for BTC perps right now so my onchain agent can use it as a reference price for a position sizing calculation."}],"resultDescription":"A JSON object containing: coin symbol, venue (hyperliquid), best_bid, best_ask, mid price, spread_bps, arrays of bid and ask levels each with price (px), size (sz), and order count (n), updated_at timestamp, and source URL.","failureModes":["Unsupported coin symbol (only BTC, ETH, SOL accepted) returns validation error","Depth parameter outside 1-20 range returns error","Hyperliquid upstream API unavailable causes fetch failure","Stale or missing updated_at if upstream data is delayed","Payment failure via x402 if USDC balance on Base is insufficient"],"whenToPreferThis":"Choose this endpoint when you need real-time Hyperliquid perpetuals L2 order book data specifically — including spread in bps and multi-level depth — via a pay-per-call x402 micropayment model (no API key subscription required). Prefer this over generic exchange APIs when working with onchain AI agents that already handle USDC payments on Base, or when you need Hyperliquid-specific liquidity data rather than aggregated CEX quotes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:20.485Z","isFirstParty":false,"canonicalSlug":"hyperliquid-perpetuals-l2-order-book-btc-eth-sol-3bb2711a"}