{"uid":"cap_GC8VXB6vNu4_OV1j-RJJz","slug":"api-usenami-io-096ceca0","name":"Nami Top-of-Book for Venue/Symbol","description":"Top-of-book for a specific venue and symbol","url":"https://api.usenami.io/v1/orderbook/hyperliquid/BTC/top","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"},"method":{"type":"string"}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"GET","method":"orderbook"}},"response":{"ts":"2026-06-03T04:32:10.459914Z","venue":"hyperliquid","symbol":"BTC","ask_size":7141026.5,"bid_size":4606310.07,"ask_price":66300,"bid_price":66299}},"exampleRequest":{"input":{"type":"GET","method":"orderbook"}},"tags":["x402"],"displayCostAmount":"0.001000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.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_TTgpW9RI5UDQnC60pdr6X","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 the current best bid and ask prices and sizes (top-of-book) for a specific trading venue and symbol","exampleAgentPrompt":"What's the current best bid and ask for BTC on Hyperliquid right now — show me prices and sizes at the top of the book?","exampleUseCases":null,"resultDescription":"Returns a JSON object with the venue name, symbol, timestamp, best bid price, best ask price, bid size, and ask size at the top of the orderbook for the requested venue/symbol pair.","failureModes":["Unknown venue or symbol returns 404 or empty response","Network timeout if the venue feed is temporarily unavailable","Stale data if venue feed latency spikes","Malformed input type/method fields return 400 validation error","Rate limit exceeded returns 429"],"whenToPreferThis":"Use this endpoint when you need a fast, real-time snapshot of the current best bid/ask for a specific venue and symbol (e.g. BTC on Hyperliquid) rather than aggregated cross-venue quotes or depth-of-book data. Prefer this over the aggregated best bid/ask endpoint when venue-specific execution or arbitrage analysis is the goal.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:30:26.169Z","isFirstParty":false}