{"uid":"cap_wE68-K7MFVedk0YPtRDKr","slug":"bykaranteli-positioning-history-aaa52ce5","name":"ByKaranteli Positioning 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/positioning-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, e.g. BTCUSDT"},"exchange":{"type":"string","description":"string, optional: binance | 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":"positioning-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_UGdq1UhO5WFeI5TSQ5QvL","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 historical positioning data including liquidations, funding rates, open interest, options gamma, ETF flows and CFTC positioning across multiple crypto derivatives venues","exampleAgentPrompt":"Pull me the last 500 positioning history records for BTCUSDT on Binance from ByKaranteli — I want to see funding rates, liquidations, and open interest in one dataset.","exampleUseCases":[{"title":"Funding rate arbitrage research","prompt":"Get me the funding rate history for BTCUSDT on Bybit over the past month — I want to see how rates have moved and spot any patterns I can trade against."},{"title":"Liquidation cascade post-mortem","prompt":"Pull the positioning history for ETHUSDT on Binance for last Tuesday — I want to see what the liquidation prints and open interest looked like during that big price drop."},{"title":"Multi-exchange positioning comparison","prompt":"Fetch up to 1000 rows of positioning history for BTCUSDT across OKX so I can compare their open interest and funding to what I'm seeing on Binance right now."}],"resultDescription":"A JSON object with an 'ok' boolean, a 'rows' array containing historical positioning records (liquidations, funding rates, open interest, gamma, ETF flows, CFTC data), a 'count' integer of returned records, and a 'dataset' field identifying the dataset as 'positioning-history'. Each row reflects snapshot data from up to six venues.","failureModes":["Empty rows array if no data matches the given symbol/exchange/date range filters","Exceeding the max limit of 20000 records may be capped or rejected","Invalid ISO date format in 'from'/'to' params may cause query failure","Unsupported exchange name returns no data or error","Payment failure (402) if x402 payment is not properly submitted"],"whenToPreferThis":"Choose this endpoint when you need multi-dimensional historical positioning data — combining liquidations, funding rates, open interest, and CFTC data — in a single call across Binance, Bybit, or OKX. Prefer it over raw liquidation endpoints when you need the aggregated, modeled view rather than individual liquidation events. Best for backtesting, market structure research, or building dashboards that need normalized cross-venue derivatives data without paying for expensive institutional feeds.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:40:47.870Z","isFirstParty":false}