{"uid":"cap_Q9taiEptvaaCVOMkysFDz","slug":"crypto-order-book-snapshot-fd31ea52","name":"Crypto Order Book Snapshot","description":"Call when an agent needs a spot order-book snapshot with best bid, best ask, mid, spread, and spread in bps. depth defaults to 20 and is at most 100. Tries Coinbase Exchange, Kraken, OKX, then Binance. Send JSON {\"symbol\":\"BTC-USD\",\"depth\":2}. Exact $0.005 USDC on Base. Try unpaid POST /v1/sandbox/crypto-orderbook first.","url":"https://agentshelf.syntexa.ch/v1/crypto-orderbook?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"depth":{"type":"integer","default":20,"maximum":100,"minimum":1,"examples":[2],"description":"Bid and ask levels to return. Example: 2. Default 20. At most 100."},"symbol":{"type":"string","examples":["BTC-USD"],"maxLength":24,"minLength":5,"description":"Spot symbol. Example: BTC-USD or BTCUSDT. XBT is read as BTC. A slash is accepted. The response symbol is BASE-QUOTE."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vmdriJ6_VvxtdlnPEUmQb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a spot order-book snapshot with best bid, best ask, mid-price, spread, and spread in basis points for a given trading pair, aggregated from Coinbase Exchange, Kraken, OKX, and Binance.","exampleAgentPrompt":"Can you pull a live order book snapshot for BTC-USD showing the top 5 bid and ask levels — I need the best bid, best ask, mid price, and spread in basis points?","exampleUseCases":[{"title":"Pre-trade spread check for algo bot","prompt":"Before I place a large ETH-USD order, can you grab the order book snapshot for ETH-USD with depth 10 so I can see the current spread in bps and best bid/ask?"},{"title":"Real-time arbitrage monitoring","prompt":"Get me the current order book snapshot for SOL-USDT with depth 20 — I want to see the mid price and spread to check if there's an arbitrage opportunity right now."},{"title":"Market liquidity depth analysis","prompt":"Can you fetch the order book for BTC-USD at maximum depth of 100 levels so I can analyze the liquidity distribution on both the bid and ask sides?"}],"resultDescription":"A JSON object containing the normalized symbol (BASE-QUOTE format), best bid price, best ask price, mid-price, spread (in price units), spread in basis points, and arrays of bid and ask levels up to the requested depth. The source exchange that provided the data is also indicated.","failureModes":["Unsupported or unrecognized symbol returns an error — ensure symbol is a valid spot pair on at least one of the four supported exchanges","Depth exceeding 100 is rejected with a validation error","All four exchanges (Coinbase, Kraken, OKX, Binance) unavailable results in a 503 or error response","Payment not provided or incorrect amount results in a 402 Payment Required response","Malformed symbol format (too short, too long) rejected by schema validation"],"whenToPreferThis":"Choose this endpoint when you need a fast, multi-exchange-aggregated order book snapshot for spot crypto markets with best bid/ask, mid, spread, and spread in bps all in one call. It is ideal when you do not have direct exchange API keys, want automatic exchange fallback across Coinbase, Kraken, OKX, and Binance, and need a normalized symbol format. Prefer alternatives if you need full historical order book data, streaming WebSocket updates, or derivatives/futures markets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T12:37:27.811Z","isFirstParty":false,"canonicalSlug":"crypto-order-book-snapshot-fd31ea52"}