{"openapi":"3.1.0","info":{"title":"ByKaranteli crypto derivatives data","version":"1.0.0","description":"Crypto derivatives market structure recorded around the clock. The public endpoints are free with an account key (30 requests a minute on the Free API plan; Builder, Business and Scale plans raise the rate, add member depth and include the x402 catalog). The /api/x402/* endpoints sell depth and history per call for anonymous agents.","x-guidance":"Endpoints under /api/public/*, /api/liqmap/public, /api/v1/public/datasets/* and /api/series take an account key in the Authorization header (Bearer bk_...). Get a free key at https://bykaranteli.com/dashboard/api; plans at https://bykaranteli.com/developers#tiers. The /api/x402/* endpoints answer HTTP 402 with machine-readable payment requirements and settle in USDC on Solana or Base per successful response, or run unpaid under a Builder or higher key. A failed response settles nothing.","contact":{"email":"support@bykaranteli.com","url":"https://bykaranteli.com/developers"},"license":{"name":"ByKaranteli Data Licence","url":"https://bykaranteli.com/data#license"}},"servers":[{"url":"https://bykaranteli.com"}],"components":{"securitySchemes":{"accountKey":{"type":"http","scheme":"bearer","description":"Account API key (bk_...). Free with a verified account: https://bykaranteli.com/dashboard/api"}}},"paths":{"/api/x402":{"get":{"summary":"Free machine-readable catalog of the paid endpoints","operationId":"x402Catalog","security":[],"responses":{"200":{"description":"Catalog of paid endpoints, prices and settlement rails"}}}},"/api/public/indices":{"get":{"summary":"Fear & Greed, BTC dominance, stablecoin flow, altseason, euphoria in one object.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/euphoria":{"get":{"summary":"Retail Euphoria Index with components.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/heatmap":{"get":{"summary":"Funding rate grid for the most traded Binance USDT-M perpetuals.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/funding-arb":{"get":{"summary":"Cross-exchange funding spreads, annualized net of taker fees.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/pressure":{"get":{"summary":"Composite long/short pressure scores per symbol.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/pressure/{symbol}":{"get":{"summary":"Pressure score and components for one symbol.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/oi":{"get":{"summary":"Open interest leaderboard: intraday OI gainers and losers.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/top-movers":{"get":{"summary":"24h top gainers and losers with price, volume and OI deltas.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/liqmap":{"get":{"summary":"Public 24h liquidation map for one symbol (see /api/liqmap/public).","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: symbol, timeframe.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/indicators":{"get":{"summary":"Bitcoin cycle indicators (Pi Cycle, Mayer, 200W/2Y MAs, golden ratio, profitable days, S2F, Puell, Bitfinex margin): latest readings, Pi Cycle cross dates and daily series.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: days, points=0.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/rsi":{"get":{"summary":"RSI heatmap: Wilder RSI(14) on 15m, 1h, 4h, 12h, 1d, 3d, 1w, 1M for ~580 Binance USDT perps (crypto top-400 + TradFi), with overbought/oversold counts per interval.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: symbol, kind=crypto|tradfi, sort=<interval>.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/hyperliquid-whales":{"get":{"summary":"Hyperliquid whale tracker: top-300 accounts by equity, long vs short notional per coin, largest positions, last 200 position changes.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: coin, events=1.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/positioning":{"get":{"summary":"Positioning board: long/short account and position ratios, taker buy/sell and CVD for 30 perps on Binance, Bybit and OKX.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: symbol.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/orderbook":{"get":{"summary":"Spot order book depth: five venues binned into 0.1% buckets, walls, 2% depth per venue, up to 24h summed history.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: symbol, hours.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/coverage":{"get":{"summary":"Coverage registry: every venue and data type we collect, how, since when and the age of the last record, derived live.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/tradfi":{"get":{"summary":"Binance TradFi perpetuals board: stocks, indices, commodities with funding, basis, OI, volume, 24h liquidations, cross-venue listings and session state.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: market, symbol.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/liquidations":{"get":{"summary":"Recorded 24h liquidations by side, symbol and venue, per-venue coverage kind, and a coverage-adjusted market estimate with its inputs.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/incidents":{"get":{"summary":"Detected liquidation cascades with size, side and price path.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/options":{"get":{"summary":"Deribit options snapshot: walls, GEX, DVOL, term structure.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/options/surface":{"get":{"summary":"IV surface by expiry and moneyness, 25-delta skew, constant-30d history.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: currency=BTC|ETH.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/options-flow":{"get":{"summary":"Options tape (Deribit + OKX): premium, strikes, put/call, blocks, venue.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/etf":{"get":{"summary":"US spot ETF flows: today's provisional aggregate + per-fund table, 30 finalized days, IBIT issuer primary-source check.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/flow":{"get":{"summary":"Order-flow toxicity (VPIN) with 120 days of history.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/premium":{"get":{"summary":"Coinbase premium, Kimchi and Turkey premium, cash-and-carry basis, daily history.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/cot":{"get":{"summary":"CFTC Commitments of Traders for crypto futures, weekly.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/events":{"get":{"summary":"FOMC (and CPI/NFP once connected) measured BTC reactions.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/slippage":{"get":{"summary":"Live execution slippage ladders by order size.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/whales":{"get":{"summary":"Whale tape: $1M+ aggressive prints, 24h aggregates.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/quantum/watchset.csv":{"get":{"summary":"Dormant-P2PK watch set as CSV with base-height provenance.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"CSV payload","content":{"text/csv":{}}}}}},"/api/public/altseason":{"get":{"summary":"Altcoin Season Index, live reading and recorded history.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/themes":{"get":{"summary":"Eight equal-weight narrative indices with baskets and daily points.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: points=0 to omit series.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/factors":{"get":{"summary":"Factor board: every recorded metric in its band with the conditional 7d BTC outcome.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/correlations":{"get":{"summary":"30-day rolling correlation matrix across major perps.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/charge":{"get":{"summary":"PsiCharge liquidity state and scorecard.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/quantum":{"get":{"summary":"Quantum-exposed Bitcoin supply, daily first-party measurement with provenance.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/macro":{"get":{"summary":"Macro liquidity series: Fed funds, 10y, Fed balance sheet, RRP, stablecoin supply.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: days.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/network":{"get":{"summary":"Bitcoin network health series from our own node.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: days.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/listings":{"get":{"summary":"New and delisted perpetual contracts across six exchanges.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: days.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/venues/markets":{"get":{"summary":"56-feed venue snapshot aggregates: OI, DEX share, funding range, spot dispersion, pegs.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: symbol.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/venues/oi-history":{"get":{"summary":"Hourly total perp open interest across every venue we snapshot, DEX share and OI-weighted funding, since 2026-08-21.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: days.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/venues/lead-lag":{"get":{"summary":"Venue lead-lag scoreboard from one-minute return cross-correlations.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/context":{"get":{"summary":"Band-conditioned context for a recorded metric.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: metric.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/smart-money/{symbol}":{"get":{"summary":"Smart-money read for one symbol.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/symbols":{"get":{"summary":"Symbols board: recorded price, 24h change, funding, open interest and pressure for every tracked perp.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: format=csv, sort, top.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/dev-activity":{"get":{"summary":"Public build log.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/borrow-rates":{"get":{"summary":"Hourly margin borrow rates per venue and asset, with the annualised APR.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/fees":{"get":{"summary":"Maker and taker fee schedules per venue and market type, with the change log.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/jupiter":{"get":{"summary":"Jupiter Perps (Solana): long/short open interest, utilization, borrow rates, weekly top traders.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: base, days.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/leverage-tiers":{"get":{"summary":"Leverage tier ladders (position size versus maximum leverage) per venue and symbol.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: symbol, venue.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/settlements":{"get":{"summary":"Delivery settlement prices of dated futures per venue.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/venues/profile":{"get":{"summary":"One venue's profile: markets, fees, leverage, borrow, coverage and events.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: venue.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/public/withdrawals":{"get":{"summary":"Withdrawal status per venue and asset: paused, fees, minimums.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: asset, venue.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/v1/public/manifest":{"get":{"summary":"Self-describing manifest of every public v1 endpoint.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/v1/public/health":{"get":{"summary":"Data liveness: liquidation stream and venue snapshot freshness verdict.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/v1/public/ideas":{"get":{"summary":"Public trade ideas aggregate.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: symbol, sort, limit, since_days.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/v1/public/liquidation-map":{"get":{"summary":"Liquidation map for one symbol (alias of /api/liqmap/public).","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: symbol, timeframe.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/v1/public/datasets/{name}":{"get":{"summary":"Dataset download, CSV or JSON (ByKaranteli Data Licence).","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan. Query: format, symbol.","security":[{"accountKey":[]}],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/v1/public/profiles/{handle}":{"get":{"summary":"Public member profile aggregate.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"parameters":[{"name":"handle","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/v1/public/me":{"get":{"summary":"Session-scoped alias of profiles/{handle}: the caller's own profile (needs the session cookie).","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/v1/public/series":{"get":{"summary":"Published course series.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/v1/public/sitemap.json":{"get":{"summary":"JSON sibling of the XML sitemap.","description":"Free with an account key (Authorization: Bearer bk_...; a free key comes with any verified account, required for programs from 2026-09-10). Licence: personal and research use with attribution; commercial use with the Business plan.","security":[{"accountKey":[]}],"responses":{"200":{"description":"JSON payload","content":{"application/json":{}}}}}},"/api/x402/liqmap-levels":{"get":{"summary":"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.","operationId":"liqmap-levels","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/options-flow":{"get":{"summary":"BTC or ETH options tape depth from recorded Deribit + OKX flow: daily premium-flow history plus the full big-print list.","operationId":"options-flow","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/flow-vpin":{"get":{"summary":"Order flow toxicity (VPIN) history for BTC, ETH and SOL: 90-day daily track plus the last 500 volume buckets.","operationId":"flow-vpin","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/cot-history":{"get":{"summary":"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.","operationId":"cot-history","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/liquidations-raw":{"get":{"summary":"Individual liquidation events recorded from our own exchange sockets across Binance, Bybit, OKX, Gate, HTX, dYdX and Aster, 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).","operationId":"liquidations-raw","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/networks-history":{"get":{"summary":"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.","operationId":"networks-history","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/leverage-tiers-history":{"get":{"summary":"Every recorded version of each perpetual's leverage ladder on every venue we record (Bybit, OKX, Gate, HTX, Bitget, MEXC and more): 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.","operationId":"leverage-tiers-history","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/oi-history":{"get":{"summary":"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.","operationId":"oi-history","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/tradfi-oi-history":{"get":{"summary":"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.","operationId":"tradfi-oi-history","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/tradfi-funding-history":{"get":{"summary":"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.","operationId":"tradfi-funding-history","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/indicators-events":{"get":{"summary":"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.","operationId":"indicators-events","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/rsi-history":{"get":{"summary":"Hourly Wilder RSI(14) history for ~580 Binance USDT perpetuals (crypto top-400 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.","operationId":"rsi-history","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/hl-whale-events":{"get":{"summary":"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.","operationId":"hl-whale-events","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/positioning-history":{"get":{"summary":"Hourly long/short account and position ratios (Binance global and top-trader, OKX by currency and top-trader), taker buy/sell ratio (Binance), Bybit share of accounts long and OKX taker buy share for the 30 most traded perps, recorded on our side from 2026-09-02; the free /api/public/positioning returns only the live board.","operationId":"positioning-history","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/bulk-liquidations":{"get":{"summary":"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 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.","operationId":"bulk-liquidations","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"15.000000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/bulk-derivatives":{"get":{"summary":"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, funding for 58 feeds on 45 exchanges and DEXs). One paid call returns one-hour signed links for every finalized month plus the current month to date.","operationId":"bulk-derivatives","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"10.000000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/bulk-flow":{"get":{"summary":"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.","operationId":"bulk-flow","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"10.000000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/jupiter-history":{"get":{"summary":"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.","operationId":"jupiter-history","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/prepaid-key":{"get":{"summary":"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.","operationId":"prepaid-key","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"10.000000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/orderbook-history":{"get":{"summary":"5-minute spot order book depth snapshots per venue (Binance, Coinbase, Kraken, Bybit, OKX) 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, 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.","operationId":"orderbook-history","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/funding-history":{"get":{"summary":"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.","operationId":"funding-history","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/options-oi-history":{"get":{"summary":"Daily listed options open interest per instrument: strike, expiry, option type, open interest, mark implied volatility, underlying price and traded notional. History from 2026-08-06 (rolling window; rows before that date do not exist).","operationId":"options-oi-history","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/spot-microstructure":{"get":{"summary":"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.","operationId":"spot-microstructure","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/venue-markets-history":{"get":{"summary":"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.","operationId":"venue-markets-history","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}},"/api/x402/whale-trades-raw":{"get":{"summary":"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.","operationId":"whale-trades-raw","responses":{"200":{"description":"Requested data, returned after payment settles"},"402":{"description":"Payment required: the response carries x402 payment requirements"}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"asset":"USDC"}}}}}