{"uid":"cap_NygYig-Qs8qvfLy3CIq8O","slug":"bykaranteli-minute-bars-with-taker-split-ddcbc969","name":"ByKaranteli Minute Bars With Taker Split","description":"Minute bars with the taker buy versus total quote volume split, pre-joined across venues and kept beyond exchange retention: the raw input behind order flow imbalance and VPIN work, in one query instead of paginating an exchange API per symbol per venue.","url":"https://bykaranteli.com/api/x402/spot-microstructure","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"],"type":"string"},"queryParams":{"type":"object","properties":{"to":{"type":"string","description":"iso, optional"},"from":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 20000"},"symbol":{"type":"string","description":"string, optional"},"exchange":{"type":"string","description":"string, optional"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"rows":[],"count":500,"dataset":"spot-microstructure"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RuzUirpUoWwA_nzhVPIk-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns per-minute OHLCV bars with taker-buy versus total quote volume split, pre-joined across venues and retained beyond exchange data retention limits, for order flow imbalance and VPIN analysis.","exampleAgentPrompt":"Pull the last 500 minute bars with taker buy versus total quote volume split for BTCUSDT across all venues from ByKaranteli's spot microstructure dataset, starting from 2024-06-01 through 2024-06-02.","exampleUseCases":[{"title":"Order flow imbalance signal research","prompt":"Grab minute bars with taker buy and total quote volume split for ETHUSDT from June 1 to June 7 2024, up to 500 rows, so I can compute order flow imbalance for a quant strategy I'm building."},{"title":"VPIN model input data collection","prompt":"I need the raw minute-level taker buy versus total quote volume data for SOLUSDT from January 15 to January 20 2025 — I'm building a VPIN toxicity model and need the pre-joined cross-venue data."},{"title":"Cross-venue spot microstructure comparison","prompt":"Fetch 300 minutes of spot microstructure bars for BTCUSDT on Binance from March 10 to March 11 2025, including the taker split, so I can compare order flow patterns across that session."}],"resultDescription":"A JSON object with ok status, a dataset label ('spot-microstructure'), a count of rows returned, and an array of rows each containing minute-level OHLCV data plus taker buy quote volume and total quote volume, enabling direct computation of taker buy ratio, order flow imbalance, and VPIN metrics.","failureModes":["Missing required 'symbol' parameter returns empty or error response","Date range too wide may be silently capped at the per-dataset row limit","Invalid exchange name may return zero rows without explicit error","Malformed date strings for 'from'/'to' may cause 400 or empty result","Limit exceeding dataset cap is silently truncated to maximum allowed rows"],"whenToPreferThis":"Choose this endpoint when you need minute-level spot market data with taker buy versus total quote volume split pre-joined across multiple venues, especially when the time window extends beyond what individual exchange APIs retain. It eliminates the need to paginate separate exchange APIs per symbol per venue and is the canonical raw input for order flow imbalance, VPIN, and market toxicity research on BTC, ETH, SOL, and other major spot pairs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:32:39.584Z","isFirstParty":false}