{"uid":"cap_Cv2BorW0ISJ8RW_C4aoGz","slug":"bykaranteli-orderbook-history-c03c508c","name":"ByKaranteli Orderbook History","description":"Six-venue liquidation model with real liquidation prints overlaid, funding rates, open interest, options gamma, ETF flows and CFTC positioning. Free.","url":"https://bykaranteli.com/api/x402/orderbook-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 5000"},"symbol":{"type":"string","description":"string, optional, e.g. BTC"},"exchange":{"type":"string","description":"string, optional venue: binance | coinbase | kraken | bybit | okx"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"rows":[],"count":500,"dataset":"orderbook-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_2EuG-y9ceIHgzDRdJv1Kr","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 orderbook-derived data (liquidations, funding rates, open interest, and more) for crypto perpetual futures across major exchanges.","exampleAgentPrompt":"Pull me the last 500 rows of orderbook history for BTC on Binance from ByKaranteli — I want to see the liquidation and funding rate data from January 1st to January 31st 2025.","exampleUseCases":[{"title":"Crypto liquidation cascade research","prompt":"Fetch me the orderbook history for ETH on Bybit from March 1st to March 15th 2025, up to 1000 rows — I want to study the liquidation prints during that volatile period."},{"title":"Funding rate trend analysis","prompt":"Get me the last 2000 rows of BTC orderbook history across all venues from ByKaranteli so I can track how funding rates have been trending over the past month."},{"title":"Multi-exchange derivatives comparison","prompt":"Pull orderbook history for SOL from OKX between February 1st and February 28th 2025 — limit it to 500 rows — I need to compare open interest and liquidation data across that timeframe."}],"resultDescription":"Returns a JSON object with an 'ok' boolean status, a 'rows' array containing historical orderbook records (liquidations, funding rates, open interest, and related derivatives data), a 'count' integer indicating how many rows were returned, and a 'dataset' field identifying the data source as 'orderbook-history'.","failureModes":["Empty rows array if no data exists for the specified symbol/exchange/date range","Invalid exchange name returns an error or empty result","Date range too broad may be capped at 5000 rows limit","Invalid ISO date format for 'from'/'to' parameters may cause query failure","Symbol not supported on the specified exchange returns no rows","Payment failure (non-2xx) if x402 payment of 0.005 USDC is not completed"],"whenToPreferThis":"Choose this endpoint when you need structured historical time-series data combining orderbook-derived metrics (liquidations, funding, open interest) across major crypto venues in a single queryable API, especially when you need to filter by specific symbol, exchange, or date range with up to 5000 rows per call. Prefer this over raw liquidation endpoints when you want aggregated/modeled data rather than individual event prints.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:45:07.044Z","isFirstParty":false}