{"uid":"cap_Vf1m6ChSOSCo4hrmroFPK","slug":"api-internal-usenami-io-80807f93","name":"Nami Top-of-Book – Hyperliquid BTC","description":"Top-of-book for a specific venue and symbol","url":"https://api-internal.usenami.io/v1/orderbook/hyperliquid/BTC/top?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","description":"Empty input object; all parameters (venue, symbol) are encoded in the URL path"}}},"responseSchema":{"type":"object","required":["venue","symbol","bid_price","bid_size","ask_price","ask_size","ts"],"properties":{"ts":{"type":"string"},"venue":{"type":"string"},"symbol":{"type":"string"},"ask_size":{"type":"number"},"bid_size":{"type":"number"},"ask_price":{"type":"number"},"bid_price":{"type":"number"}}},"example":{"request":{"input":{}},"response":{"ts":"2026-05-30T00:23:05.789756Z","venue":"hyperliquid","symbol":"BTC","ask_size":6449282.07,"bid_size":6336139.92,"ask_price":73468,"bid_price":73467}},"exampleRequest":{"input":{}},"tags":["x402"],"displayCostAmount":"0.001000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.75","successRate":"1.00","reviews":1,"stars":"4.0","state":"rated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001000/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_uYGOb5IgdUITx-jwXW5xk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current top-of-book (best bid and ask) for BTC on the Hyperliquid venue","exampleAgentPrompt":"What's the current top-of-book for BTC on Hyperliquid — give me the best bid and ask right now?","exampleUseCases":[{"title":"Real-time execution price monitoring","prompt":"Check the current best bid and ask for BTC on Hyperliquid so I can decide whether to place a market order right now or wait for a better spread."},{"title":"Algorithmic trading spread analysis","prompt":"I need the top-of-book snapshot for BTC on Hyperliquid every few seconds — is the spread tight enough to execute my algorithm, or should I hold off?"},{"title":"Cross-venue price comparison strategy","prompt":"Pull the current bid and ask prices for BTC on Hyperliquid so I can compare them against other venues and find the best execution opportunity."}],"resultDescription":"A snapshot of the top-of-book for BTC on Hyperliquid, including the current best bid price, best ask price, and implied spread at the moment of the query.","failureModes":["Symbol not found or unsupported — returns 404 or empty response","Venue (Hyperliquid) temporarily unavailable — returns 503 or timeout","Stale or delayed data if upstream feed is lagging","Rate limit exceeded — returns 429","Invalid input schema — returns 400 with schema validation error"],"whenToPreferThis":"Use this endpoint when you need the current best bid/ask specifically for BTC on the Hyperliquid venue. Prefer this over aggregated endpoints when you need venue-specific execution price discovery rather than cross-venue best prices. Ideal for real-time trading decision support, spread monitoring, or pre-trade price checks on Hyperliquid.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-06-10T11:33:27.267Z","lastSuccessfullyRanAt":"2026-06-10T11:33:27.267Z","lastHealthCheckAt":"2026-10-12T21:28:28.788Z","isFirstParty":false,"canonicalSlug":"api-internal-usenami-io-80807f93"}