{"uid":"cap_DRmUY9Db-oaazTQR6Rqgl","slug":"onesource-deepstate-depth-history-06fa6602","name":"OneSource Deepstate Depth History","description":"Deepstate, the on-chain order-book exchange on Robinhood Chain. Depth heatmap - resting order size by price level over time for a market.","url":"https://api.onesource.io/deepstate/v1/analytics/depth-history","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"},"queryParams":{"type":"object","required":["book"],"properties":{"to":{"type":"string"},"res":{"enum":["1h","1d"],"type":"string"},"book":{"type":"string"},"from":{"type":"string"},"side":{"enum":["bid","ask"],"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"to":{"type":"string"},"from":{"type":"string"},"points":{"type":"array","items":{"type":"object","properties":{"side":{"type":"string"},"bucket":{"type":"string"},"finality":{"type":"string"},"size_raw":{"type":"string"},"price_raw":{"type":"string"},"order_count":{"type":"integer"},"block_number":{"type":"integer"},"market_session":{"type":"string"},"denominated_order_count":{"type":"integer"}}}},"book_id":{"type":"string"},"coverage":{"type":"object","properties":{"order_count":{"type":"integer"},"denominated_order_count":{"type":"integer"}}},"book_slug":{"type":"string"},"book_label":{"type":"string"},"resolution":{"type":"string"},"size_token":{"type":"object","properties":{"symbol":{"type":"string"},"address":{"type":"string"},"decimals":{"type":"integer"}}}},"description":"Endpoint-specific response payload"}}}}},"responseSchema":{"type":"json","example":{"to":"2026-09-02T16:00:00Z","from":"2026-09-02T15:00:00Z","points":[{"side":"bid","bucket":"2026-09-02T15:00:00Z","finality":"safe","size_raw":"5213000000","price_raw":"216.480000000000000000","order_count":4,"block_number":52661600,"market_session":"regular","denominated_order_count":4},{"side":"ask","bucket":"2026-09-02T15:00:00Z","finality":"safe","price_raw":"220.480000000000000000","order_count":3,"block_number":52661600,"market_session":"regular","denominated_order_count":0}],"book_id":"0xdf941c235503a5d2e67aee5dea00f2965f99421c0d034bd77f924c05c66bf399","coverage":{"order_count":253,"denominated_order_count":129},"book_slug":"NVDA-USDG","book_label":"NVDA/USDG","resolution":"1h","size_token":{"symbol":"USDG","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","decimals":6}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_eE_1kjHZixocC7h-dPkLW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a time-series heatmap of resting order sizes by price level for a given order book market, with configurable time range and resolution","exampleAgentPrompt":"Show me the hourly bid-side depth history for the ETH-USDC order book on Deepstate from 2024-11-01 to 2024-11-07 so I can see how resting liquidity was distributed across price levels.","exampleUseCases":[{"title":"Liquidity concentration analysis for trading strategy","prompt":"Pull the daily ask-side depth history for the BTC-USDC book on Deepstate for the past 30 days — I want to see which price levels had the most resting sell orders so I can identify resistance zones."},{"title":"Market microstructure research heatmap","prompt":"Get me hourly order book depth snapshots for both bids on the ETH-USDC Deepstate market from 2024-10-01 to 2024-10-31 so I can build a heatmap of where liquidity was concentrated over the month."},{"title":"Real-time order book depth monitoring for alerts","prompt":"Fetch the latest 1-hour resolution depth history for the SOL-USDC book on Deepstate through today — I need the resting order sizes at each price level to check if there's been any big change in bid-side liquidity in the last 24 hours."}],"resultDescription":"Returns a time-indexed array of depth data points, each containing the price bucket, side (bid/ask), resting order size (raw and denominated), order count, block number, market session, and finality status. Also includes book metadata (ID, slug, label), the queried time range, resolution, and coverage statistics (total order and denominated order counts). Size token metadata (symbol, address, decimals) is included for unit interpretation.","failureModes":["Missing required 'book' parameter returns a validation error","Invalid resolution value (not '1h' or '1d') returns an enum validation error","Invalid side value (not 'bid' or 'ask') returns an enum validation error","Unknown or unsupported book ID returns empty results or a 404","Time range too broad for the selected resolution may result in large payloads or truncation","Payment failure or missing x402 payment header returns a 402 Payment Required response","Future 'to' date beyond chain head returns no data or partial results"],"whenToPreferThis":"Choose this endpoint when you need historical order book depth data over time for a specific Deepstate market — particularly for building heatmaps, identifying liquidity clusters, analyzing price-level support/resistance, or monitoring how resting order distribution has evolved. This is the right choice for time-series depth analysis rather than a point-in-time snapshot. Prefer this over live order book endpoints when you need a look-back window of hours or days at 1h or 1d resolution.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:32:58.583Z","isFirstParty":false}