{"uid":"cap_vM-ef6LvVl5oDxxVgwEZ2","slug":"onesource-deepstate-order-book-snapshot-8b82cd1f","name":"OneSource Deepstate Order Book Snapshot","description":"Deepstate, the on-chain order-book exchange on Robinhood Chain. Order-book snapshot for a market, bids descending and asks ascending, with live resting size per level.","url":"https://api.onesource.io/deepstate/v1/book/:book","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","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","required":["book"],"properties":{"book":{"type":"string"}}},"queryParams":{"type":"object","properties":{"depth":{"type":"integer","maximum":500,"minimum":1}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asks":{"type":"array","items":{"type":"object","properties":{"side":{"type":"string"},"size":{"type":"number"},"maker":{"type":"string"},"price":{"type":"number"},"order_id":{"type":"string"},"size_raw":{"type":"string"},"nonce_raw":{"type":"integer"},"price_raw":{"type":"string"},"rest_index":{"type":"integer"},"sequence_raw":{"type":"string"},"is_bid_token0":{"type":"boolean"},"price_key_raw":{"type":"string"},"queue_position":{"type":"integer"},"rested_at_block":{"type":"integer"}}}},"bids":{"type":"array","items":{"type":"object","properties":{"side":{"type":"string"},"size":{"type":"number"},"maker":{"type":"string"},"price":{"type":"number"},"order_id":{"type":"string"},"size_raw":{"type":"string"},"nonce_raw":{"type":"integer"},"price_raw":{"type":"string"},"rest_index":{"type":"integer"},"sequence_raw":{"type":"string"},"is_bid_token0":{"type":"boolean"},"price_key_raw":{"type":"string"},"queue_position":{"type":"integer"},"rested_at_block":{"type":"integer"}}}},"book_id":{"type":"string"},"summary":{"type":"object","properties":{"book_id":{"type":"string"},"mid_raw":{"type":"string"},"finality":{"type":"string"},"ask_count":{"type":"integer"},"bid_count":{"type":"integer"},"book_label":{"type":"string"},"spread_bps":{"type":"number"},"spread_raw":{"type":"string"},"order_count":{"type":"integer"},"best_ask_raw":{"type":"string"},"best_bid_raw":{"type":"string"},"block_number":{"type":"integer"},"top_ask_maker":{"type":"string"},"top_bid_maker":{"type":"string"},"market_session":{"type":"string"},"top_ask_order_id":{"type":"string"},"top_bid_order_id":{"type":"string"},"ask_depth_quote_raw":{"type":"string"},"bid_depth_quote_raw":{"type":"string"},"base_fee_per_gas_raw":{"type":"string"},"last_trade_price_raw":{"type":"string"},"ask_depth_1pct_quote_raw":{"type":"string"},"bid_depth_1pct_quote_raw":{"type":"string"}}},"finality":{"type":"string"},"book_slug":{"type":"string"},"base_token":{"type":"object","properties":{"symbol":{"type":"string"},"address":{"type":"string"},"decimals":{"type":"integer"}}},"block_hash":{"type":"string"},"book_label":{"type":"string"},"quote_token":{"type":"object","properties":{"symbol":{"type":"string"},"address":{"type":"string"},"decimals":{"type":"integer"}}},"block_number":{"type":"integer"},"market_session":{"type":"string"}},"description":"Endpoint-specific response payload"}}}}},"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_IvbyCdEKqzosprLc4MxND","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 full order-book snapshot for a named market, with bids sorted descending and asks sorted ascending, including summary statistics like spread and mid price","exampleAgentPrompt":"Pull the current order book snapshot for the ETH-USDC book on OneSource — show me the top 50 levels of bids and asks with the spread and mid price.","exampleUseCases":[{"title":"Real-time spread monitoring for a trading bot","prompt":"Check the current spread in basis points for the ETH-USDC order book — I want to know if it's tight enough to place a limit order right now."},{"title":"Liquidity depth analysis before a large trade","prompt":"Get me the top 100 levels of bids and asks for the WBTC-USDC book so I can estimate slippage before I execute a large buy."},{"title":"On-chain maker activity inspection","prompt":"Fetch the full order book for the OP-ETH market and show me the maker addresses and queue positions for the top resting bids."}],"resultDescription":"A JSON object containing two arrays — bids (price-descending) and asks (price-ascending) — each with fields for price, size, maker address, order_id, raw on-chain values (price_raw, size_raw, sequence_raw), rest_index, queue_position, rested_at_block, and is_bid_token0; plus a summary object with book_id, book_label, best_bid, best_ask, spread_bps, spread_raw, mid_raw, bid_count, ask_count, order_count, and finality status.","failureModes":["Unknown book identifier returns 404 or empty result","depth parameter out of range (must be 1–500) returns 400 validation error","Market temporarily unavailable or chain sync lag returns stale or empty snapshot","Network timeout if the on-chain node is slow to respond","Insufficient USDC balance or failed x402 payment results in 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need a real-time, fully ordered on-chain order book snapshot with raw blockchain-level detail (sequence numbers, block height, maker addresses, queue positions) for a specific named market. Prefer it over generic DEX aggregators when you need the authoritative on-chain state rather than aggregated or estimated liquidity, or when downstream logic requires raw values for verification or trade construction.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:44:55.679Z","isFirstParty":false}