{"uid":"cap_xOP6rd5GB8jDt8zed4nYL","slug":"onesource-deepstate-ohlcv-candles-api-ac3abb78","name":"OneSource Deepstate OHLCV Candles API","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/candles/%7Bbook%7D","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","required":["tf"],"properties":{"tf":{"enum":["1m","5m","15m","30m","1h","4h","1d","1w"],"type":"string"},"to":{"type":"string"},"from":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"tf":{"type":"string"},"book_id":{"type":"string"},"candles":{"type":"array","items":{"type":"object","properties":{"t":{"type":"string"},"trades":{"type":"integer"},"low_raw":{"type":"string"},"high_raw":{"type":"string"},"open_raw":{"type":"string"},"close_raw":{"type":"string"},"open_bucket":{"type":"boolean"},"market_session":{"type":"string"},"volume_base_raw":{"type":"string"},"volume_quote_raw":{"type":"string"}}}},"book_slug":{"type":"string"},"base_token":{"type":"object","properties":{"symbol":{"type":"string"},"address":{"type":"string"},"decimals":{"type":"integer"}}},"book_label":{"type":"string"},"quote_token":{"type":"object","properties":{"symbol":{"type":"string"},"address":{"type":"string"},"decimals":{"type":"integer"}}}},"description":"Endpoint-specific response payload"}}}}},"responseSchema":{"type":"json","example":{"tf":"1h","book_id":"0xdf941c235503a5d2e67aee5dea00f2965f99421c0d034bd77f924c05c66bf399","candles":[{"t":"2026-09-02T14:00:00Z","trades":14,"low_raw":"215.70112004","high_raw":"220.47999716","open_raw":"216.43128523","close_raw":"216.47999901","open_bucket":false,"market_session":"regular","volume_base_raw":"1904773188220000000000","volume_quote_raw":"412330119842"}],"book_slug":"NVDA-USDG","base_token":{"symbol":"NVDA","address":"0xd0601CE157Db5bdC3162BbaC2a2C8aF5320D9EEC","decimals":18},"book_label":"NVDA/USDG","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_0NUYUqooyUHRK94AwiGZO","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 OHLCV candlestick data for a Deepstate on-chain order book at a specified timeframe and optional date range","exampleAgentPrompt":"Pull the 1-hour OHLCV candles for the NVDA-USDG book on Deepstate from September 1 to September 3, 2026 — I want open, high, low, close, and volume for each candle.","exampleUseCases":[{"title":"Tokenized stock price chart","prompt":"Get me the daily candles for the NVDA-USDG Deepstate order book over the last 30 days — I want to see open, high, low, close, and volume so I can build a price chart."},{"title":"Intraday trading strategy backtest","prompt":"Fetch 5-minute OHLCV candles for the NVDA-USDG book on Deepstate from September 1 to September 2, 2026 — I need the full trade count and volume data for each candle to backtest an intraday strategy."},{"title":"On-chain market session analysis","prompt":"Can you pull the 4-hour candles for the NVDA-USDG Deepstate book for the past week? I want to compare price action across regular vs. other market sessions."}],"resultDescription":"A JSON object containing the book identifier, book slug, label, base and quote token metadata (symbol, address, decimals), the requested timeframe, and an array of candle objects each with timestamp, open/high/low/close raw prices, base and quote volume, trade count, whether it opened a new bucket, and the market session label.","failureModes":["Missing required 'book' path parameter returns an error or 404","Missing required 'tf' query parameter returns a validation error","Invalid timeframe enum value (e.g. '2h') returns a 400 bad request","Unknown or invalid book slug/address returns empty candles array or 404","Date range with no trading activity returns empty candles array","Payment not provided or insufficient results in 402 Payment Required","Network or RPC timeout returns 503 or gateway error"],"whenToPreferThis":"Use this endpoint when you need structured OHLCV candlestick data for Deepstate on-chain order books (including tokenized assets like stocks paired with stablecoins). It is the right choice for charting, backtesting, or market analysis on Deepstate markets specifically, and supports flexible timeframes from 1-minute to weekly. Prefer it over generic DEX data APIs when you need Deepstate-specific book metadata (base/quote token addresses, market session labels) and consistent raw price formatting.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:44:42.683Z","isFirstParty":false}