{"uid":"cap__g1Dh1Ylu3LLjsbFOO1My","slug":"bykaranteli-venue-markets-history-71d4089c","name":"ByKaranteli Venue Markets History","description":"Ten-minute snapshots of price, 24h volume, open interest and 8h-equivalent funding per venue and symbol across 56 feeds on 43 exchanges (24 perpetual, 32 spot), recorded since 2026-08-21: the raw rows behind the exchange coverage table, total-OI and DEX-share metrics.","url":"https://bykaranteli.com/api/x402/venue-markets-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"],"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, venue id e.g. binance|bybit|hyperliquid"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"rows":[],"count":500,"dataset":"venue-markets-history"}},"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_i5-4TRcqCpcuWIsOzzQle","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":"Retrieves historical crypto derivatives data including liquidations, funding rates, open interest, options gamma, ETF flows, and CFTC positioning across six major venues.","exampleAgentPrompt":"Pull the last 500 rows of venue market history for BTCUSDT on Binance from the ByKaranteli derivatives dataset, including liquidation prints and funding rates, from January 1 to January 31 2025.","exampleUseCases":[{"title":"Liquidation cascade post-mortem analysis","prompt":"Pull all liquidation data for ETHUSDT across Bybit and Hyperliquid for the period from March 10 to March 15 2025 — I want to see the real liquidation prints to understand what triggered the cascade."},{"title":"Funding rate sentiment tracker","prompt":"Get me the funding rate history for BTCUSDT on Binance for the past 30 days, up to 1000 rows, so I can chart whether perpetual traders are net long or short over time."},{"title":"Multi-venue open interest comparison","prompt":"Fetch up to 5000 rows of venue market history for SOLUSDT across all supported venues between February 1 and February 28 2025 — I need to compare open interest trends across exchanges."}],"resultDescription":"Returns a JSON object with an 'ok' boolean, a 'rows' array of historical venue market records (liquidations, funding rates, open interest, gamma, ETF flows, CFTC data), a 'count' of returned rows, and the dataset name 'venue-markets-history'. Rows can be filtered by symbol, exchange, and date range, up to a maximum of 20,000 records per call.","failureModes":["Empty rows array if no data matches the given symbol/exchange/date filters","Invalid exchange venue ID returns no results or error","Date range with no available data returns count:0","Exceeding limit of 20000 may be capped or rejected","Malformed ISO date strings in from/to params may cause query failure","Payment failure (402) if USDC payment not included"],"whenToPreferThis":"Choose this endpoint when you need historical multi-venue crypto derivatives data — especially liquidation prints, funding rates, open interest, or CFTC positioning — with flexible filtering by symbol, exchange, and date range. Prefer this over generic market data APIs when the use case involves derivatives-specific metrics like liquidation cascades, funding sentiment, or options gamma across major venues including Binance, Bybit, and Hyperliquid.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:47:58.188Z","isFirstParty":false}