{"uid":"cap_205L2n7aO29kIkVLfNtdC","slug":"obol-order-book-top-78c61ebd","name":"Obol Order Book Top","description":"Obol sells verified blockchain data over x402, settled in USDC on Base.","url":"https://obol.danieldutoit.net/v1/markets/orderbook-top?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"base":"BTC","found":true,"quote":"USD","coverage":{"match_type":"exact_exchange_timestamp_base_and_quote","maximum_results":1},"exchange":"COINBASE","snapshot":{"best_ask":{"price":63402.2,"volume":0.054},"best_bid":{"price":63402.1,"volume":0.364},"observed_at":"2026-08-13T00:05:00.000Z","spread_percent":0.0001577234823429269},"timestamp":"1786579500","disclaimer":"Historical exchange observation for informational use; not investment advice."}},"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":"unknown","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_V7eBwpdTF7ODexch5kB5q","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 top-of-book (best bid and best ask) snapshot from a cryptocurrency exchange order book for a given trading pair.","exampleAgentPrompt":"What's the current top of book for BTC/USD on Coinbase — give me the best bid, best ask, and spread right now using Obol's verified order book data.","exampleUseCases":[{"title":"Real-time spread monitoring for arbitrage","prompt":"Check the best bid and ask for BTC/USD on Coinbase right now and tell me what the spread is — I want to see if there's an arb opportunity."},{"title":"Historical order book research","prompt":"What was the top of book for BTC/USD on Coinbase at timestamp 1786579500? I need the best bid, best ask, and spread for that exact moment."},{"title":"Pre-trade price sanity check","prompt":"Before I execute a trade, can you pull the current best ask for ETH/USD on Coinbase so I know what price I should expect to pay?"}],"resultDescription":"A JSON object containing the best bid (price and volume) and best ask (price and volume) for the requested trading pair, along with the spread as a percentage, the exchange name, the base and quote currencies, the observed timestamp, a match type describing coverage quality, and a disclaimer noting the data is historical and informational.","failureModes":["Trading pair not found on the requested exchange returns found: false","Invalid or unsupported exchange name results in no data","Timestamp out of available historical range returns no snapshot","Network or payment failure via x402 protocol returns a payment-required error","Malformed query parameters cause a 4xx response"],"whenToPreferThis":"Choose this endpoint when you need verified, structured order book top-of-book data (best bid/ask + spread) for major crypto pairs from a specific exchange, especially when you require a micropayment-native API settled in USDC on Base via x402 without API key management. Prefer this over free, unverified market data sources when data provenance and payment-per-call economics matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T12:39:22.359Z","isFirstParty":false,"canonicalSlug":"obol-order-book-top-78c61ebd"}