{"uid":"cap_C-atED-2gY8lYVdzbgpxV","slug":"bykaranteli-whale-trades-raw-data-ced176bb","name":"ByKaranteli Whale Trades Raw Data","description":"Every $1M+ aggressive market print recorded live from our own trade sockets, with side, price, quantity and notional, kept for 90 days, filterable by symbol, exchange and time. The free endpoint serves the live tape (newest 100 prints, no filters); this route is the recorded archive behind it.","url":"https://bykaranteli.com/api/x402/whale-trades-raw","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 10000"},"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":"whale-trades-raw"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0y_V-HBds5NubGD4tCdqY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns raw large-trade (whale) prints from crypto derivatives venues, filterable by symbol, exchange, and time range.","exampleAgentPrompt":"Pull the last 500 raw whale trades for BTCUSDT across all exchanges from ByKaranteli so I can see where the big money has been hitting the tape recently.","exampleUseCases":[{"title":"Quant backtesting whale flow signals","prompt":"Fetch up to 10000 raw whale trades for ETHUSDT from Binance between January 1 and January 31 so I can backtest a strategy based on large-order flow."},{"title":"Real-time whale activity dashboard","prompt":"Get the 200 most recent whale trades across all symbols and exchanges so I can display live large-order activity on my trading dashboard."},{"title":"Exchange-specific large trade analysis","prompt":"Pull the last 1000 raw whale trades on Bybit for SOLUSDT so I can see if institutional players are accumulating or distributing."}],"resultDescription":"A JSON object with an 'ok' boolean, a 'rows' array of raw whale trade records (each containing trade details such as symbol, exchange, size, side, and timestamp), a 'count' integer indicating how many records were returned, and a 'dataset' label confirming the data source.","failureModes":["Empty rows array if no trades match the given filters within the time range","Exceeding the 10000 row limit may truncate or error the response","Invalid symbol or exchange strings may return empty results without an explicit error","Malformed ISO timestamps in 'from'/'to' parameters may cause query failures","Service may return ok:false on internal data pipeline errors"],"whenToPreferThis":"Choose this endpoint when you need raw, unprocessed large-trade prints from crypto derivatives venues for quant research, backtesting, or building real-time dashboards. It covers up to six venues in a single call, supports flexible time-range and symbol filtering, and provides granular trade-level data rather than aggregated summaries. Prefer it over aggregated derivatives APIs when you need tick-level whale flow data at a low per-call cost.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:45:59.320Z","isFirstParty":false}