{"service":"ByKaranteli x402 API","settlement":"USDC, settled per call via the x402 protocol","networks":[{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","chain":"Solana mainnet","pay_to":"4JgPtoBWkQyG3QffVJC3bfgk7SCQrz9bx2SAEUTSVqzK"},{"network":"eip155:8453","chain":"Base mainnet","pay_to":"0x0db4c96d8b14f431f3bb8ce1a33f07d2c696a62c"}],"docs":"https://bykaranteli.com/developers","endpoints":[{"url":"https://bykaranteli.com/api/x402/liqmap-levels","price_usd":0.005,"description":"Full multi-exchange liquidation map snapshot for a Binance USDT-M perp: modeled leverage clusters, real forceOrder levels, top magnets, funding, OI and orderbook context.","query":{"symbol":{"type":"string","description":"Ticker covered by LiqMap, e.g. BTC, ETH or SOL, with or without the USDT suffix (default BTC); the list is at https://bykaranteli.com/liqmap"},"timeframe":{"type":"string","description":"Lookback window for the position model: 1h, 4h, 12h, 24h, 3d, 1w or 30d (default 24h)"},"leverage":{"type":"string","description":"Leverage group, default all: all, low (5x and 10x), medium (25x) or high (50x and 100x)"},"exchange":{"type":"string","description":"One venue's model instead of the multi-venue merge, default all: all, binance, bybit, okx, gate, htx or hyperliquid"}}},{"url":"https://bykaranteli.com/api/x402/options-flow","price_usd":0.005,"description":"BTC or ETH options tape depth from our own recorded Deribit and OKX flow: the daily premium-flow history plus the full big-print list with strike, expiry, direction, premium, implied volatility and venue.","query":{"currency":{"type":"string","description":"BTC or ETH (default BTC)"}}},{"url":"https://bykaranteli.com/api/x402/flow-vpin","price_usd":0.002,"description":"Order flow toxicity (VPIN) history for BTC, ETH and SOL: 90-day daily VPIN track with closes plus the last 500 volume buckets.","query":{}},{"url":"https://bykaranteli.com/api/x402/cot-history","price_usd":0.005,"description":"CFTC Commitments of Traders weekly history for crypto futures with the columns the free CSV does not carry: dealer long and short books and week-over-week change in open interest, alongside every participant class. The free download covers hedge fund, institutional, other reportable and small trader positions.","query":{"from":{"type":"string","description":"date, optional"},"to":{"type":"string","description":"date, optional"},"limit":{"type":"number","description":"number, optional, max 3000"}}},{"url":"https://bykaranteli.com/api/x402/liquidations-raw","price_usd":0.01,"description":"Individual liquidation events recorded from our own exchange sockets across Binance, Bybit, OKX, Gate, HTX, dYdX, Aster, Lighter and Kraken Futures, plus Deribit's hourly delayed flag: side, price, quantity, notional, venue and millisecond timestamp. Coverage per venue: /api/public/liquidations. History from 2026-07-30 (rolling window; rows before that date do not exist).","query":{"symbol":{"type":"string","description":"string, optional"},"exchange":{"type":"string","description":"string, optional"},"from":{"type":"string","description":"iso, optional"},"to":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 20000"}}},{"url":"https://bykaranteli.com/api/x402/liquidation-leaderboard-history","price_usd":0.005,"description":"Per-day ranking of the largest single liquidation prints across Binance, Bybit, OKX, Gate, HTX, dYdX, Aster, Lighter and Kraken Futures: up to 100 ranks per finalized UTC day since the event store began, with symbol, venue, side (SELL = a long was liquidated), price, quantity, notional and millisecond event time, filterable by symbol and venue. The free CSV carries the top 10 per day; the free page and API rank only the last 24 hours to 30 days.","query":{"symbol":{"type":"string","description":"string, optional"},"exchange":{"type":"string","description":"string, optional"},"from":{"type":"string","description":"date, optional"},"to":{"type":"string","description":"date, optional"},"limit":{"type":"number","description":"number, optional, max 10000"}}},{"url":"https://bykaranteli.com/api/x402/networks-history","price_usd":0.005,"description":"Every recorded version of each asset and network row on every venue we record (20+ exchanges): deposit flag, withdrawal flag, withdrawal fee and minimum, with valid_from and valid_to, so withdrawal suspensions can be dated and their duration measured. The free endpoint serves only the current table.","query":{"symbol":{"type":"string","description":"string, optional asset, e.g. USDT"},"exchange":{"type":"string","description":"string, optional venue id: kucoin | gate | htx | bitget ..."},"from":{"type":"string","description":"iso, optional, valid_from lower bound"},"to":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 20000"}}},{"url":"https://bykaranteli.com/api/x402/leverage-tiers-history","price_usd":0.005,"description":"Every recorded version of each perpetual's leverage ladder on every venue whose ladders we read: tier, notional floor and cap, maximum leverage and maintenance margin, with valid_from and valid_to so leverage cuts can be dated. The free endpoint serves only the current ladder.","query":{"symbol":{"type":"string","description":"string, optional base asset, e.g. BTC"},"exchange":{"type":"string","description":"string, optional venue id: bybit | okx | gate | htx | bitget | mexc ..."},"from":{"type":"string","description":"iso, optional, valid_from lower bound"},"to":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 20000"}}},{"url":"https://bykaranteli.com/api/x402/oi-history","price_usd":0.005,"description":"Five minute open interest history for the major perpetuals in base units and USD, normalised across symbols and retained on our side, so one query replaces per-symbol paginated pulls against exchange endpoints.","query":{"symbol":{"type":"string","description":"string, optional"},"from":{"type":"string","description":"iso, optional"},"to":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 20000"}}},{"url":"https://bykaranteli.com/api/x402/tradfi-oi-history","price_usd":0.005,"description":"Five minute open interest history for the top-40 Binance TradFi perpetuals (US, HK, KR and CN equities, commodities, indices) in base units and USD, recorded on our side from 2026-09-02; the free /api/public/tradfi board only carries the live value.","query":{"symbol":{"type":"string","description":"string, optional, e.g. TSLAUSDT"},"from":{"type":"string","description":"iso, optional"},"to":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 20000"}}},{"url":"https://bykaranteli.com/api/x402/tradfi-funding-history","price_usd":0.005,"description":"Settled funding rate history of the top-40 Binance TradFi perpetuals at per-settlement granularity, recorded from 2026-09-02; the free board only carries the last settled rate.","query":{"symbol":{"type":"string","description":"string, optional, e.g. TSLAUSDT"},"from":{"type":"string","description":"iso, optional"},"to":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 20000"}}},{"url":"https://bykaranteli.com/api/x402/indicators-events","price_usd":0.005,"description":"Every day since 2012 on which a Bitcoin cycle indicator crossed a canonical band (Pi Cycle top cross and reset, Mayer Multiple 2.4 and 0.8, Puell Multiple 4 and 0.5, 200-week MA, 2-year MA x5, golden ratio 1.6/2/3/5, profitable days 95% and 50%), with the BTC close on the day and the forward 7, 30, 90, 180 and 365-day returns that followed. Computed over recorded daily closes (Bitstamp 2012-2017, Binance since); the free endpoint carries the levels without the event tape or forward returns.","query":{"symbol":{"type":"string","description":"string, optional: indicator key pi_cycle|mayer|puell|ma200w|ma2y|golden_ratio|profitable_days"},"from":{"type":"string","description":"iso, optional"},"to":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, default 1000, max 5000"}}},{"url":"https://bykaranteli.com/api/x402/rsi-history","price_usd":0.002,"description":"Hourly Wilder RSI(14) history for the top-400 Binance crypto perpetuals by volume plus every TradFi perp on 15m, 1h, 4h, 12h, 1d, 3d, 1w and 1M intervals, recorded on our side from 2026-09-02; the free /api/public/rsi board only carries the live values.","query":{"symbol":{"type":"string","description":"string, optional, e.g. BTCUSDT"},"exchange":{"type":"string","description":"string, optional: interval filter, e.g. 4h"},"from":{"type":"string","description":"iso, optional"},"to":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 20000"}}},{"url":"https://bykaranteli.com/api/x402/hl-whale-events","price_usd":0.005,"description":"Every recorded position change of the 300 largest Hyperliquid accounts by equity (opened, closed, increased, reduced, flipped) with size before and after, notional changed, entry and liquidation price and leverage, scanned every 5 minutes on our side from 2026-09-02; the free /api/public/hyperliquid-whales returns the live board and only the last 200 events.","query":{"symbol":{"type":"string","description":"string, optional coin, e.g. BTC"},"exchange":{"type":"string","description":"string, optional kind filter: opened | closed | increased | reduced | flipped"},"from":{"type":"string","description":"iso, optional"},"to":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 20000"}}},{"url":"https://bykaranteli.com/api/x402/positioning-history","price_usd":0.005,"description":"Hourly long/short account and position ratios (Binance global and top-trader, OKX by currency and top-trader, Gate accounts and top traders, HTX elite accounts and positions, Bitget accounts and positions, Kraken Futures all accounts and top 20%), taker buy/sell ratio (Binance), Bybit share of accounts long, OKX and Bitget taker buy share and Gate taker long/short size for the 30 most traded perps on Binance, Bybit, OKX, Gate, HTX, Bitget and Kraken Futures, plus Bitfinex margin long and short position size in coins and the long share on its spot margin book (margin borrowers, not perpetual accounts, from 2026-09-22), plus GMX and Jupiter Perps long and short open interest in USD and the long share (pool-based perpetual DEXes, from 2026-09-23), recorded on our side from 2026-09-02 (Gate, HTX and Bitget from 2026-09-20); the free /api/public/positioning returns only the live board.","query":{"symbol":{"type":"string","description":"string, optional, e.g. BTCUSDT"},"exchange":{"type":"string","description":"string, optional: binance | bybit | okx | gate | htx | bitget | kraken | bitfinex | gmx | jupiter"},"from":{"type":"string","description":"iso, optional"},"to":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 20000"}}},{"url":"https://bykaranteli.com/api/x402/bulk-liquidations","price_usd":15,"description":"Monthly gzip CSV files of every liquidation event we recorded (exchange, symbol, side, price, qty, quote_qty, event_time) across Binance, Bybit, OKX, Gate, HTX, dYdX, Aster, Lighter, Kraken Futures and Deribit: about 1.5 million rows per month since 2026-07-30. One paid call returns one-hour signed download links for every finalized month plus the current month to date; the free /api/x402/liquidations-raw route returns at most 20k rows per call.","query":{}},{"url":"https://bykaranteli.com/api/x402/bulk-derivatives","price_usd":10,"description":"Monthly gzip CSV files of the derivatives tables: 5-minute Binance open interest per symbol (oi-5m), per-venue funding settlements (funding-settlements) and the 10-minute multi-venue market snapshots (venue-snapshots: price, volume, OI and funding for every venue feed we poll, exchanges and DEXs). One paid call returns one-hour signed links for every finalized month plus the current month to date.","query":{}},{"url":"https://bykaranteli.com/api/x402/bulk-flow","price_usd":10,"description":"Monthly gzip CSV files of the flow tables: $1M+ aggressive prints from our own trade sockets (whale-trades), Hyperliquid top-300 position change events (hl-whale-events), hourly long/short and taker statistics (positioning-hourly) and hourly RSI on eight intervals (rsi-hourly). One paid call returns one-hour signed links for every finalized month plus the current month to date.","query":{}},{"url":"https://bykaranteli.com/api/x402/jupiter-history","price_usd":0.005,"description":"Hourly Jupiter Perps history per market (SOL, ETH, BTC) and metric: exact long and short open interest read from the on-chain custody state (guaranteedUsd, globalShortSizes), long and short pool utilization, hourly borrow rates, custody AUM, price and 24h volume, plus JLP pool AUM, price and APR under market JLP; recorded on our side from 2026-09-02. The free /api/public/jupiter returns the live board and up to 30 days of hourly OI history.","query":{"symbol":{"type":"string","description":"string, optional market: SOL | ETH | BTC | JLP"},"metric":{"type":"string","description":"string, optional: long_oi_usd | short_oi_usd | long_util_pct | short_util_pct | long_borrow_hourly_pct | short_borrow_hourly_pct | custody_aum_usd | price_usd | volume_24h_usd, and for JLP aum_usd | apr_pct | price_usd"},"from":{"type":"string","description":"iso, optional"},"to":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 20000"}}},{"url":"https://bykaranteli.com/api/x402/turkey-premium-history","price_usd":0.005,"description":"Minute history of the Turkey premium index (2026-09-17): the TRY and USDT reference prices built from Turkish spot venues (BtcTurk, Bitlo, CoinTR, OKX TR, Binance TR, Bybit TR, KuCoin TR, Bitexen) as the median mid of eligible books, with eligible and observed venue counts, status, the Binance global USDT price, the ECB USD/TRY fix, the premium in basis points and index_bps, the Turkey Premium Index (total premium against the official rate; the 0-100 score is a fixed published reading of it); optionally the per-venue book rows (best bid and ask, spread, depth within 10 to 100 bps, censoring flag) with exchange=<venue>. The free /api/public/turkey-premium returns the live board and 15-minute points for up to 30 days.","query":{"symbol":{"type":"string","description":"string, optional pair: BTC-TRY | ETH-TRY | USDT-TRY | BTC-USDT | ETH-USDT"},"exchange":{"type":"string","description":"string, optional: a venue id such as btcturk to return that venue's book rows instead of the index"},"from":{"type":"string","description":"iso, optional"},"to":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 20000"}}},{"url":"https://bykaranteli.com/api/x402/insurance-fund-history","price_usd":0.005,"description":"Hourly insurance fund readings per pool on Binance, Bybit, OKX, Gate, MEXC, Bitfinex, Crypto.com, Delta Exchange, dYdX and Paradex: venue, pool (the contracts a pool covers, OKX's instrument family and its published venue total as pool total, a MEXC contract or other for the contracts folded together, a Bitfinex collateral currency, a Delta Exchange asset, or the single fund of Crypto.com, dYdX and Paradex), asset, balance in the asset, USD value (dollar stables 1:1, other assets at our recorded price, null when unpriced) and the number of contracts the pool covers, recorded on our side from 2026-09-23 and kept 35 days. The free /api/public/insurance-funds returns the latest reading and daily closes per venue; the free insurance-funds-daily file carries one row per day, venue and asset.","query":{"venue":{"type":"string","description":"string, optional: binance | bybit | okx | gate | mexc | bitfinex | cryptocom | delta | dydx | paradex"},"asset":{"type":"string","description":"string, optional, e.g. USDT"},"from":{"type":"string","description":"iso, optional"},"to":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 20000"}}},{"url":"https://bykaranteli.com/api/x402/tokenized-stocks-history","price_usd":0.005,"description":"Hourly readings per tokenized stock wrapper from xStocks, Robinhood Stock Tokens, Coinbase Tokenized Stocks, Binance bStocks, Ondo Stocks, Backpack Securities, Reality (Bitget), Superstate Opening Bell and Figure: the wrapper price (liquidity-weighted median of admitted DEX pools, or the volume-weighted exchange price under chain cex), the real share reference and its session state, the premium in percent, pool liquidity, 24h volume and admitted pools, recorded on our side from 2026-09-23 and kept permanently. The free /api/public/tokenized-stocks returns the latest board, where each wrapper's price_source names the price that valued its supply dollars (reference, issuer_oracle, wrapper, or null when unpriced) and totals.priced_by counts the wrappers per level; the free tokenized-stocks-daily file carries one close per wrapper and day with price_source as its last column.","query":{"wrapper":{"type":"string","description":"string, required, e.g. TSLAx"},"chain":{"type":"string","description":"string, optional: solana | ethereum | bnb | arbitrum | base | robinhood | ton | mantle | optimism | ink | hyperevm | xlayer | tron | linea | morph | provenance | cex"},"issuer":{"type":"string","description":"string, optional: xstocks | robinhood | coinbase | bstocks | ondo | backpack | gstocks | reality | superstate | figure"},"days":{"type":"number","description":"number, optional, 1..366, default 7"},"from":{"type":"string","description":"iso, optional"},"to":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 20000"}}},{"url":"https://bykaranteli.com/api/x402/prepaid-key","price_usd":10,"description":"Buy a prepaid API key loaded with $10 of credit for every paid route on this origin: send it as the x-api-key header instead of paying per call and each call deducts its listed price (from $0.002), so scripts and agents can make hundreds of calls after one payment. Pass key=<existing bk_live key> to top up instead of minting a new one. The plain key is returned once; balance and call count are free at /api/x402/prepaid-key/balance. Same crypto rails as every route (Solana USDC or Base USDC), no card, no account.","query":{"key":{"type":"string","description":"string, optional: an existing bk_live key to top up"}}},{"url":"https://bykaranteli.com/api/x402/orderbook-history","price_usd":0.005,"description":"5-minute spot order book depth snapshots per venue (Binance, Coinbase, Kraken, Bybit, OKX, Gate, MEXC, HTX, Bitget, Bitstamp, Gemini, Bitfinex, BingX, Crypto.com, Backpack, Binance US, Poloniex, LBank, Bitrue, XT, HashKey, DigiFinex, Bullish, WEEX, Deribit, Aster, Bitvavo, Independent Reserve, BtcTurk; five venues from 2026-09-02, eleven from 2026-09-20, the rest from 2026-09-22) for BTC, ETH, SOL, XRP, DOGE, ADA, LINK, AVAX, LTC and BNB: the book binned into 0.1% price buckets within 20% of mid as USD notional (bids and asks as JSON arrays), 2% depth per side, coverage of the book and level count, and in_aggregate (false for a book we record but hold out of the summed aggregate), recorded on our side from 2026-09-02 and kept 14 days; the free /api/public/orderbook returns the live aggregate and up to 24 hours of summed history.","query":{"symbol":{"type":"string","description":"string, optional, e.g. BTC"},"exchange":{"type":"string","description":"string, optional venue: binance | coinbase | kraken | bybit | okx | gate | mexc | htx | bitget | bitstamp | gemini | bitfinex | bingx | cryptocom | backpack | binanceus | poloniex | lbank | bitrue | xt | hashkey | digifinex | bullish | weex | deribit | aster | bitvavo | independentreserve | btcturk"},"from":{"type":"string","description":"iso, optional"},"to":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 5000"}}},{"url":"https://bykaranteli.com/api/x402/funding-history","price_usd":0.005,"description":"Settled funding rate history at per-venue, per-settlement granularity (every 8h print with its source exchange), the series behind carry and basis work. The free metric-daily download already carries a single daily BTC funding aggregate; this route is for the venue-level record.","query":{"symbol":{"type":"string","description":"string, optional"},"exchange":{"type":"string","description":"string, optional"},"from":{"type":"string","description":"iso, optional"},"to":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 20000"}}},{"url":"https://bykaranteli.com/api/x402/options-oi-history","price_usd":0.005,"description":"Daily listed options open interest per instrument on Deribit, Bybit, Binance, OKX and Delta Exchange: venue, strike, expiry, option type, open interest in coins, mark implied volatility, underlying price and traded notional where the venue publishes it. History per venue: Deribit from 2026-08-06, Bybit and Binance from 2026-09-21, OKX and Delta Exchange from 2026-09-23 (rolling window; rows before those dates do not exist).","query":{"currency":{"type":"string","description":"string, optional BTC or ETH"},"venue":{"type":"string","description":"string, optional options venue: deribit | bybit | binance | okx | delta"},"from":{"type":"string","description":"date, optional"},"to":{"type":"string","description":"date, optional"},"limit":{"type":"number","description":"number, optional, max 20000"}}},{"url":"https://bykaranteli.com/api/x402/spot-microstructure","price_usd":0.01,"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.","query":{"symbol":{"type":"string","description":"string, optional"},"exchange":{"type":"string","description":"string, optional"},"from":{"type":"string","description":"iso, optional"},"to":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 20000"}}},{"url":"https://bykaranteli.com/api/x402/venue-markets-history","price_usd":0.005,"description":"Ten-minute snapshots of price, 24h volume, open interest and 8h-equivalent funding per venue and symbol for every perpetual, spot and TradFi perpetual feed we poll (the live crypto list is /api/public/venues/markets, TradFi perps are on /api/public/tradfi): the raw rows behind the exchange coverage table, total-OI and DEX-share metrics, kept 35 days; older months are in the bulk-derivatives export.","query":{"symbol":{"type":"string","description":"string, optional"},"exchange":{"type":"string","description":"string, optional, venue id e.g. binance|bybit|hyperliquid"},"from":{"type":"string","description":"iso, optional"},"to":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 20000"}}},{"url":"https://bykaranteli.com/api/x402/whale-trades-raw","price_usd":0.002,"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.","query":{"symbol":{"type":"string","description":"string, optional"},"exchange":{"type":"string","description":"string, optional"},"from":{"type":"string","description":"iso, optional"},"to":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 10000"}}}]}