{"uid":"cap_fq7aWocNuadlAj0hW-mlh","slug":"usenami-cross-venue-aggregate-bbo-for-crypto-perpetuals-992f6d87","name":"Usenami Cross-Venue Aggregate BBO for Crypto Perpetuals","description":"Consolidated best bid and ask for one crypto perpetual across every tracked venue — the cross-venue BBO, and which venue holds each side. CEX and DEX perp venues in one quote.","url":"https://api.usenami.io/v1/orderbook/aggregate/:symbol?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zkssR760SBIHz1OTLVdpn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the consolidated best bid and offer (BBO) across all tracked CEX and DEX perpetual venues for a given crypto symbol, identifying which venue holds each side.","exampleAgentPrompt":"What's the best bid and ask for BTC-PERP right now across all tracked CEX and DEX venues, and which exchange is holding each side?","exampleUseCases":[{"title":"Best execution venue selection","prompt":"Before I enter a long on ETH-PERP, show me the best ask price available across all exchanges right now and tell me which venue I should go to for the cheapest fill."},{"title":"Cross-venue spread monitoring","prompt":"What's the current spread on SOL-PERP across all perpetual venues — give me the best bid and ask and which exchange holds each side so I can see how tight the market is."},{"title":"Arbitrage opportunity detection","prompt":"Check the aggregate BBO for BTC-PERP across all CEX and DEX perp markets — I want to see if the best bid venue and best ask venue are different so I can spot any cross-venue arb."}],"resultDescription":"A snapshot of the consolidated best bid price and best ask price for the requested perpetual symbol, along with the name of the venue holding the best bid and the venue holding the best ask, drawn from both CEX and DEX perpetual markets tracked by Usenami.","failureModes":["Unknown or unsupported symbol returns a 404 or error response","Symbol format mismatch (e.g. wrong delimiter) causes no data returned","Temporary venue connectivity issues may result in partial BBO with fewer venues covered","Rate limiting or payment failure returns 402 or 429 error","Stale data if a venue feed is lagging, resulting in outdated bid/ask prices"],"whenToPreferThis":"Choose this endpoint when you need a single, authoritative cross-venue best bid/offer for a crypto perpetual without manually querying each exchange. It is ideal when comparing CEX and DEX liquidity simultaneously, detecting arbitrage opportunities between venues, or routing an order to the best available price. Prefer over single-venue top-of-book endpoints (also available on Usenami) when the goal is market-wide price discovery rather than venue-specific depth.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T09:26:51.169Z","isFirstParty":false,"canonicalSlug":"usenami-cross-venue-aggregate-bbo-for-crypto-perpetuals-992f6d87"}