{"uid":"cap_4M_18A2MKia8IYDHwiH-G","slug":"usenami-top-of-book-orderbook-single-venue-df65dbbc","name":"Usenami Top-of-Book Orderbook (Single Venue)","description":"Top-of-book for one crypto perpetual on one venue — best bid, best ask and the spread between them. Covers CEX and DEX perp venues: Binance, Bybit, OKX, Hyperliquid, Paradex, Drift and others.","url":"https://api.usenami.io/v1/orderbook/:venue/:symbol/top?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","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_0iWTa2j5EQOEQxA4qX3Fk","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 best bid, best ask, and spread for a single crypto perpetual on a specific CEX or DEX venue in real time.","exampleAgentPrompt":"What's the current best bid and ask — and the spread between them — for BTC-PERP on Hyperliquid right now?","exampleUseCases":[{"title":"Live spread monitoring for arbitrage","prompt":"What's the top-of-book spread for ETH-PERP on Binance right now? I want to see the best bid and ask so I can check if there's an arbitrage opportunity."},{"title":"Pre-trade best price check","prompt":"Before I enter a long on SOL-PERP on Bybit, can you pull the current best ask price and spread from the orderbook?"},{"title":"DEX perp liquidity snapshot","prompt":"What's the best bid and ask for BTC-PERP on Drift right now? I'm trying to understand how tight the DEX spread is compared to a CEX."}],"resultDescription":"Returns the top-of-book for the requested venue and symbol: the best bid price, best ask price, and the spread (ask minus bid) between them, reflecting real-time market conditions.","failureModes":["Unknown venue name returns an error — must use a supported venue slug (e.g. binance, bybit, hyperliquid, drift)","Invalid or unsupported symbol returns an error","Network or exchange connectivity issues may cause stale or missing data","Payment failure (x402 protocol) blocks the response if USDC is not available"],"whenToPreferThis":"Use this endpoint when you need a fast, low-cost, single-venue top-of-book snapshot for a specific crypto perpetual — ideal for pre-trade checks, spread monitoring, or real-time price feeds. If you need cross-venue spread comparison or sized-depth slippage at specific notional sizes, use the corresponding Usenami sibling endpoints instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T09:26:51.168Z","isFirstParty":false,"canonicalSlug":"usenami-top-of-book-orderbook-single-venue-df65dbbc"}