{"uid":"cap_ZwOi6gmig-TCgVA2tvP_F","slug":"market-intelligence-api-ohlcv-candles-with-trade-flow-fadf2ae4","name":"Market Intelligence API – OHLCV Candles with Trade Flow","description":"Send a symbol (ETHUSD, BTCUSD, NVDA, TSLA, SPY, ...), get OHLCV candles (1m, 5m, 15m or 1h) with volume split into aggressive buys and sells, buy pressure, VWAP and trade count per candle, from on-chain trade flow.","url":"https://api.marketintelligenceapi.com/api/v1/intelligence/candles/ETHUSD?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["symbol"],"properties":{"symbol":{"type":"string","examples":["ETHUSD"],"description":"Asset symbol, e.g. ETHUSD, BTCUSD, NVDA, TSLA, XAUUSD"}},"additionalProperties":false},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","default":60,"maximum":500,"description":"Maximum number of results to return"},"interval":{"enum":["1m","5m","15m","1h"],"type":"string","default":"1m","description":"Candle interval, e.g. 1m, 5m, 15m or 1h"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"description":"Example JSON response returned by this endpoint"}},"additionalProperties":true}},"additionalProperties":false},"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_lEheuOOVHGOqV-iAfFF7L","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 candles (1m, 5m, 15m, or 1h) for a given symbol enriched with aggressive buy/sell volume split, buy pressure, VWAP, and trade count per candle derived from on-chain trade flow.","exampleAgentPrompt":"Pull 5-minute OHLCV candles for ETHUSD with the aggressive buy/sell volume split, buy pressure, VWAP, and trade count so I can see who's driving price action right now.","exampleUseCases":[{"title":"Crypto momentum trade signal check","prompt":"Give me the last 15-minute candles for BTCUSD with aggressive buy and sell volume, buy pressure, and VWAP — I want to see if buyers are really in control before I enter a position."},{"title":"Tokenized stock intraday flow analysis","prompt":"Fetch 1-hour OHLCV candles for NVDA with the buy/sell volume split and trade count — I need to understand whether the recent move was driven by aggressive buyers or sellers."},{"title":"Real-time ETH scalping dashboard","prompt":"Stream 1-minute candles for ETHUSD with VWAP, buy pressure, and aggressive buy vs sell volume so my trading bot can decide whether to go long or short on the next tick."}],"resultDescription":"A list of OHLCV candles for the requested symbol and interval, each enriched with: open, high, low, close, total volume, aggressive buy volume, aggressive sell volume, buy pressure (ratio), VWAP, and trade count — all sourced from on-chain trade flow data.","failureModes":["Invalid or unsupported symbol returns an error or empty response","Unsupported interval value causes a validation error","Payment failure (x402) if USDC balance is insufficient","Rate limiting or throttling if too many calls are made in a short window","Network timeout if the on-chain data source is temporarily unavailable"],"whenToPreferThis":"Choose this endpoint when you need candle data enriched with microstructure signals — specifically aggressive buy/sell volume decomposition, buy pressure, and VWAP — rather than plain OHLCV. Ideal for trading agents that need to distinguish directional aggression from passive flow, or for strategies that rely on volume imbalance as a signal. Prefer over generic market data APIs when on-chain trade flow fidelity matters for crypto or tokenized equity symbols.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:44:04.201Z","isFirstParty":false,"canonicalSlug":"market-intelligence-api-ohlcv-candles-with-trade-flow-fadf2ae4"}