{"uid":"cap_FIzHNraSybaN7vnmjU5JR","slug":"onesource-deepstate-trade-tape-f760cb71","name":"OneSource Deepstate Trade Tape","description":"Deepstate, the on-chain order-book exchange on Robinhood Chain. Trade tape for a market, newest first.","url":"https://api.onesource.io/deepstate/v1/trades/: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":{"limit":{"type":"integer","maximum":500,"minimum":1},"before":{"type":"integer","minimum":0}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"trades":{"type":"array","items":{"type":"object","properties":{"side":{"type":"string"},"price":{"type":"number"},"book_id":{"type":"string"},"finality":{"type":"string"},"gas_used":{"type":"integer"},"order_id":{"type":"string"},"price_raw":{"type":"string"},"timestamp":{"type":"integer"},"base_token":{"type":"string"},"block_hash":{"type":"string"},"book_label":{"type":"string"},"attribution":{"type":"string"},"match_event":{"type":"string"},"quote_token":{"type":"string"},"block_number":{"type":"integer"},"fee_recipient":{"type":"string"},"is_bid_token0":{"type":"boolean"},"maker_address":{"type":"string"},"taker_address":{"type":"string"},"fee_amount_raw":{"type":"string"},"market_session":{"type":"string"},"base_amount_raw":{"type":"string"},"gas_used_for_l1":{"type":"integer"},"quote_amount_raw":{"type":"string"},"transaction_hash":{"type":"string"},"price_net_of_fee_raw":{"type":"string"},"effective_gas_price_raw":{"type":"string"}}}},"book_id":{"type":"string"},"book_slug":{"type":"string"},"base_token":{"type":"object","properties":{"symbol":{"type":"string"},"address":{"type":"string"},"decimals":{"type":"integer"}}},"book_label":{"type":"string"},"next_before":{"type":"integer"},"quote_token":{"type":"object","properties":{"symbol":{"type":"string"},"address":{"type":"string"},"decimals":{"type":"integer"}}}},"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_kCNNLu4UQUakKFwELCxNc","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 the on-chain trade history (tape) for a specific Deepstate order book market, sorted newest first, with full execution details per trade.","exampleAgentPrompt":"Pull the last 50 trades from the Deepstate ETH-USDC book so I can see recent fill prices, who was maker vs taker, and the transaction hashes.","exampleUseCases":[{"title":"Monitor live fill activity on a market","prompt":"Show me the 100 most recent trades on the Deepstate WBTC-USDC order book, including prices and both sides of each fill."},{"title":"Paginate back through historical trades","prompt":"Get me the next batch of trades on the ETH-USDC Deepstate book before block 19500000, up to 200 at a time, so I can reconstruct the full trade history."},{"title":"Analyze maker and taker activity","prompt":"Fetch the latest 500 trades from the Deepstate USDC-DAI book and tell me which addresses are the most active takers and what prices they paid."}],"resultDescription":"Returns a paginated list of trade objects for the specified book, each containing: execution side (bid/ask), price (decimal and raw), base and quote token amounts, maker and taker addresses, transaction hash, block number and hash, timestamp, gas used, fee amount and recipient, market session label, finality status, and attribution. Also returns book metadata (id, slug, label, base/quote token info) and a next_before cursor for pagination.","failureModes":["Invalid or unknown book identifier returns an error or empty result","limit out of range (must be 1–500) returns a validation error","before value of 0 or invalid integer causes a bad request","Payment not attached (x402 protocol) causes a 402 Payment Required response","Network or RPC timeout yields a 5xx error","Book with no trades returns an empty trades array"],"whenToPreferThis":"Use this endpoint when you need granular, on-chain trade execution data for a specific Deepstate order book, including maker/taker addresses, raw token amounts, gas costs, and transaction hashes. It is the authoritative source for Deepstate market tape and supports cursor-based pagination for historical analysis. Prefer it over general Ethereum log queries when you want pre-parsed, human-readable trade records rather than raw event logs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:43:18.108Z","isFirstParty":false}