{"uid":"cap_7dfMdgjoZdWxkvyZRxrtL","slug":"api-usenami-io-460380c5","name":"Nami Aggregated Order Book (Best Bid/Ask)","description":"Best bid/ask aggregated across all venues","url":"https://api.usenami.io/v1/orderbook/aggregate/BTC","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":"api.usenami.io"}},"response":{"symbol":"BTC","best_ask":{"size":7794417.12,"price":63855.72134,"venue":"source_54"},"best_bid":{"size":294982373.3,"price":63910.2,"venue":"KuCoin"}}},"exampleRequest":{"input":{"type":"GET","method":"api.usenami.io"}},"tags":["x402"],"displayCostAmount":"0.002","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.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_q92f06cbEks1dyWOKQ5Sb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the best bid and best ask prices aggregated across all perpetual trading venues for a given symbol","exampleAgentPrompt":"What's the best bid and ask price for BTC aggregated across all perp venues right now, and which exchange is offering each side?","exampleUseCases":null,"resultDescription":"Returns a JSON object with the symbol (e.g. BTC), best ask details (price, size, venue name), and best bid details (price, size, venue name) — all aggregated across 30+ perpetual trading venues at the moment of the call.","failureModes":["Unknown symbol returns 404 or empty result","Stale data if venues are temporarily unreachable","Rate limiting or payment failure (402) if x402 micropayment not attached","Missing venue data if a source is offline","Malformed request returns 400 bad request"],"whenToPreferThis":"Use this endpoint when you need the single best bid/ask price aggregated across all tracked perpetual venues for a symbol like BTC — ideal for pre-trade price discovery, execution routing, or checking the global market quote without querying each venue individually. Prefer over per-venue top-of-book endpoints when you want the market-wide best price rather than a specific exchange's quote.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:45:19.147Z","isFirstParty":false}