{"uid":"cap_mdCOXZZUl5QsD2BXzogNH","slug":"onesource-deepstate-on-chain-trades-feed-88405963","name":"OneSource Deepstate On-Chain Trades Feed","description":"Two data families for AI agents: live Ethereum mainnet, Sepolia testnet, and Robinhood Chain RPC reads, plus Deepstate on-chain market data (order books, trades, candles, and analytics). Pay per call or use batch/session mode: USDC on Base via x402, or pathUSD/USDC.e on Tempo via MPP. No API key required to start; a flat-rate monthly subscription is also available.","url":"https://api.onesource.io/deepstate/v1/trades/%7Bbook%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"trades":[{"side":"bid","price":216.47999901,"book_id":"0xdf941c235503a5d2e67aee5dea00f2965f99421c0d034bd77f924c05c66bf399","finality":"head","gas_used":412903,"order_id":"0x2ace85d500000000000000000000000000000000db5ac90000000000fffbb01b","price_raw":"216.47999901","timestamp":1788362840,"base_token":"0xd0601CE157Db5bdC3162BbaC2a2C8aF5320D9EEC","block_hash":"0x2d4f6a8c0e2b4d6f8a0c2e4b6d8f0a2c4e6b8d0f2a4c6e8b0d2f4a6c8e0b2d4f","book_label":"NVDA/USDG","attribution":"exact","match_event":"BidMatched","quote_token":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","block_number":52685331,"fee_recipient":"0xbfb7b3Ff3D498a559b946B836d26F0E168f273D5","is_bid_token0":false,"maker_address":"0x884a1B2c3D4e5F60718293a4B5c6D7e8F90A1b2C","taker_address":"0x2b4d6f8a0c2e4b6d8f0a2c4e6b8d0f2a4c6e8b0d","fee_amount_raw":"1598069","market_session":"regular","base_amount_raw":"7381992258086111446","gas_used_for_l1":287441,"quote_amount_raw":"1598069869","transaction_hash":"0xa1c3e5b7d9f02a4c6e8b0d2f4a6c8e0b2d4f6a8c0e2b4d6f8a0c2e4b6d8f0a2c","price_net_of_fee_raw":"216.26352901","effective_gas_price_raw":"485000000"}],"book_id":"0xdf941c235503a5d2e67aee5dea00f2965f99421c0d034bd77f924c05c66bf399","book_slug":"NVDA-USDG","base_token":{"symbol":"NVDA","address":"0xd0601CE157Db5bdC3162BbaC2a2C8aF5320D9EEC","decimals":18},"book_label":"NVDA/USDG","next_before":52685331,"quote_token":{"symbol":"USDG","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","decimals":6}}},"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_GDlV_Z0OnwJSXh0gn0_0S","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 recent matched trades (fills) for a specific on-chain order book on the Deepstate decentralized exchange, including price, amounts, sides, and block-level metadata.","exampleAgentPrompt":"Pull the latest trades from the NVDA/USDG Deepstate order book — I want to see recent fills including price, side, and amounts.","exampleUseCases":[{"title":"Monitor tokenized equity trade activity","prompt":"Show me the most recent trades on the NVDA/USDG Deepstate book, including what price they matched at and whether they were bids or asks."},{"title":"On-chain price discovery for arbitrage bot","prompt":"Fetch the last executed trade prices for the NVDA/USDG book on Deepstate so I can compare against off-chain prices and spot any arbitrage gaps."},{"title":"Audit fill history for a specific book address","prompt":"I need the recent matched trades for the Deepstate book at address 0xdf941c235503a5d2e67aee5dea00f2965f99421c0d034bd77f924c05c66bf399, including transaction hashes and block numbers for verification."}],"resultDescription":"A JSON object containing an array of trade records for the specified book. Each trade includes: side (bid/ask), price, price net of fee, base and quote token amounts (raw and human-readable), order ID, transaction hash, block hash and number, finality status (head/finalized), gas used, fee amount and recipient, maker and taker addresses, market session, and match event type. Also returns book metadata: book ID, slug, label, base token (symbol/address/decimals), and quote token (symbol/address/decimals), plus a cursor (next_before) for pagination.","failureModes":["Invalid or unknown book identifier returns empty trades array or 404","Malformed book address causes a 400 bad request","No trades in the requested block range returns empty trades array","Payment failure (x402/MPP) results in 402 Payment Required with no data","Rate limiting or session expiry returns 429 or 402","Network congestion on Robinhood Chain may cause stale or delayed data"],"whenToPreferThis":"Use this endpoint when you need granular, on-chain trade execution data (fills) for a specific Deepstate order book — including exact prices, counterparty addresses, block-level provenance, and fee details. Prefer this over order book snapshot endpoints when you need historical fill sequences rather than current open orders, and over general Ethereum RPC endpoints when you need structured DEX trade data rather than raw transaction decoding.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:48:02.992Z","isFirstParty":false}