Справка для разработчиков

Передайте ключ аккаунта при рукопожатии как Authorization: Bearer bk_... (тот же ключ, что и для REST API). Ключ в строке запроса отклоняется. Ключи Free и Terminal получают 403 plan_required.

bykaranteli-mcp является официальным MCP-сервером (Model Context Protocol), который открывает этот API как 68 инструментов внутри Claude, Cursor и любого другого ассистента с поддержкой MCP: рыночные индексы, тепловая карта и арбитраж фандинга, оценки давления, лидеры роста и падения, доска символов, дневные ликвидации и каскады, потоки ETF, позиционирование COT, снимок и лента опционов, Coinbase Premium, токсичность потока, лестницы проскальзывания, влияние FOMC, открытый интерес, лента китов, опережение и запаздывание, корреляции, поверхность IV, макроликвидность, здоровье сети, новые листинги, рынки площадок, квантовая экспозиция, кластеры ликвидаций LiqMap и многое другое. Бесплатный ключ аккаунта (BYKARANTELI_API_KEY), Node 18+. Помимо рыночных данных: get_series возвращает любой записанный ряд по метрике, символу и периоду, parse_alert_text превращает фразу вроде "BTC funding above 0.05%" в оповещение, а инструменты аккаунта показывают и изменяют ваши оповещения и список наблюдения тем же ключом (инструменты, которые что-то меняют, помечены как запись, учитываются в вашем тарифе и фиксируются в вашем аккаунте). Каждый рыночный ответ содержит блок provenance: биржи, стоящие за числом, полное или выборочное покрытие, свежесть данных и страницу доказательства.

claude mcp add bykaranteli -e BYKARANTELI_API_KEY=bk_... -- npx -y bykaranteli-mcp

{
  "mcpServers": {
    "bykaranteli": { "command": "npx", "args": ["-y", "bykaranteli-mcp"] }
  }
}

Источник и документация: github.com/bykarantelicom/bykaranteli-mcp · npmjs.com/package/bykaranteli-mcp

Эти эндпоинты идут глубже и оценивают каждый вызов в USDC через протокол x402, так что автономный агент может купить один ответ без аккаунта, API-ключа или подписки. Оплата проходит в блокчейне за каждый запрос; регистрироваться не нужно ни одной из сторон. Оплаченный вызов читает весь архив с собственным лимитом строк маршрута за $0.10. Ключи Builder и выше вызывают те же маршруты без оплаты в рамках плана: Builder 1 000 вызовов каталога в месяц за последние 90 дней, до 5 000 строк за вызов, только сводные ряды; Business 10 000 в месяц за последние 365 дней, до 20 000 строк, сырые записи включены; Scale и Enterprise без потолка за весь архив. Окно отсчитывается от 00:00 UTC его первого дня, и каждый включенный вызов также считается за 10 запросов месячного добросовестного использования плана. Сырые записи (отдельные события ликвидаций и рейтинг крупнейших принтов, принты китов, события позиций Hyperliquid и почасовые записи позиций, снимки стакана, минутные бары и снимки рынков по площадкам: liquidations-raw, liquidation-leaderboard-history, hl-whale-events, hl-positions-history, orderbook-history, spot-microstructure, venue-markets-history, whale-trades-raw) входят в план начиная с Business. Поле history_since маршрута означает его первую записанную строку; включенный вызов читает от начала окна плана (x-history-window-days). Сверх потолка (x402_allowance_used, HTTP 402), раньше окна (history_window, HTTP 403) или на маршруте сырых записей ниже Business (raw_tier_required, HTTP 403) вызов оплачивается отдельно: передайте ключ аккаунта в заголовке Authorization: Bearer, а предоплаченный ключ в x-api-key, или отправьте вызов без ключа аккаунта и оплатите 402 кошельком. Массовые выгрузки доступны с Business и выше, вне потолка; в списке только месяцы, пересекающиеся с окном плана.

# 1. Запрос без оплаты: endpoint отвечает 402 с машиночитаемыми условиями
curl -i https://bykaranteli.com/api/x402/flow-vpin

# 2. Любой x402-клиент платит и автоматически повторяет запрос
npm i @x402/fetch @x402/core @x402/svm
# wrapFetchWithPayment(fetch, client) -> 200 + data, расчет в USDC

Цена указана за успешный ответ: за неудачный запрос расчёт не проводится. Вы платите за глубину и историю, а не за доступ: каждый live-снимок выше остаётся бесплатным с ключом аккаунта в пределах лимитов вашего плана.

Доска символов: записанный 24-часовой тикер, ставка финансирования, изменение открытого интереса и оценка давления деривативов по каждому отслеживаемому бессрочному контракту Binance USDT-M.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/symbols?sort=change&top=20' | jq '.symbols[:5]'

{
  "generatedAt": "2026-09-05T09:00:00.000Z",
  "sort": "volume",
  "totalSymbols": 512,
  "symbols": [
    {
      "symbol": "BTCUSDT", "lastPrice": 109412.5, "change24hPct": 1.84,
      "quoteVolume24h": 21874112034.1, "fundingRatePct": 0.0081,
      "openInterestUsd": 12041233810.4, "oi24hPct": 2.1,
      "pressureScore": 61, "pressureDirection": "LONG",
      "pressureUpdatedAt": "2026-09-05T08:45:12.000Z"
    }
  ]
}

Market Profile одного бессрочного контракта Binance USDT-M по нашим собственным минутным барам, одна строка на закрытый день UTC, новые первыми: poc (ценовая корзина с наибольшим числом отметок TPO), val и vah (зона стоимости 70%), ib_low и ib_high (первый час UTC), vpoc (корзина с наибольшим объемом в котируемой валюте), open, high, low, close, tpo_total и periods. naked_pocs перечисляет точки контроля последних 60 записанных дней, которые ни один последующий закрытый день не пересек; profile_latest дает [price, tpo, volume_usd] по каждой корзине последнего дня. Периоды TPO по 30 минут, корзины шириной 0.05% от цены открытия дня. С любым ключом доступно 30 дн.; до 400 дн. доступно участникам (сессия Terminal или ключ Builder и выше). Для символа без записанных минутных баров ответ 404 no_profile. Уровни каждого дня есть в наборе данных market-profile-daily; полный профиль каждого дня находится на платном маршруте /api/x402/market-profile-history.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/market-profile?symbol=BTC&days=5' | jq '{symbol, recorded_since, latest: .days[0], naked_pocs}'

Гэпы выходных и ночи у perpetuals на акции, индексы и сырье относительно нашей собственной записи закрытия кассового рынка США: опорная цена это медианная цена площадок в последнем 10-минутном снимке перед 16:00 New York. window=weekend (по умолчанию, последние 12 выходных: sat_12, sun_12, sun_20, pre_open, open) или night (последние 20 ночей после закрытия с понедельника по четверг: utc_04, pre_open, open); open это первый снимок после 09:30 New York. Каждая точка содержит price (медиана площадок), venues, spread_pct (разница самой высокой и самой низкой площадки к медиане), gap_pct, lo_pct и hi_pct относительно опорной цены. Без symbol: kpis, summary по каждому активу (медианный абсолютный гэп в опорной точке и на открытии, same_direction_pct, когда оба значения есть хотя бы в 5 окнах, медианный разброс) и latest, последнее окно со всеми активами; с symbol=TSLA: сводка по этому активу и все окна. Запись ведется с 2026-08-25; календаря праздников нет. Все окна и точки есть в датасете tradfi-gaps; исходные 10-минутные снимки площадок доступны на платном маршруте /api/x402/venue-markets-history.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/tradfi-gaps?window=weekend&symbol=TSLA' | jq '.summary, .windows[0].symbols[0].points'

Доля каждой учитываемой площадки ликвидаций (Binance, Bybit, OKX, Gate, HTX, dYdX, Aster, Lighter, Kraken Futures, GMX и Deribit) в записанном итоге за days=1 (по умолчанию), 7 или 30: usd, long_usd, short_usd, events, share_pct, long_share_pct, since (первый день учета площадки, если он попадает в окно) и trend_pp (доля за последние 7 дней минус доля за 7 дней до них, null, если площадка учитывалась не весь предыдущий отрезок). daily это таблица долей по дням и площадкам за последние 30 дней UTC (сегодняшний день неполный); oi дает долю каждой площадки в открытом интересе perp за последний час и за 7 дней. Теневые площадки и площадки без публичного потока в итог не входят. Дневные строки это датасет venue-share-daily; почасовые строки по площадкам с итогом каждого часа доступны на платном маршруте /api/x402/venue-share-history.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/venue-share?days=7' | jq '{total_usd, venues: [.venues[] | {exchange, share_pct, trend_pp}]}'

Композитный индикатор давления по деривативам в диапазоне 0-100 для всех отслеживаемых бессрочных контрактов Binance USDT-M, дельта OI за 1h/4h/24h + ставка финансирования + базис. Режимы с учетом направления.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/pressure?limit=20&side=long' | jq '.items[:5]'

{
  "generatedAt": "2026-04-23T20:47:28.616Z",
  "count": 60,
  "items": [
    {
      "symbol": "BARDUSDT",
      "score": 45, "direction": "SHORT", "regime": "SHORT_RAMP",
      "regimeLabel": "Net short bias building",
      "components": { "oi24hPct": -8.7, "oi4hPct": 1.5, "oi1hPct": 0.1, "fundingRatePct": -0.037, "basisPct": -0.19 },
      "explainer": [ "Open interest down 8.7% over 24h", "Funding rate -0.037% per interval" ]
    },
    …
  ]
}

Снимок давления по символу с обновлением в реальном времени, если кэш устарел.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/pressure/BTCUSDT

Спред ставки финансирования между биржами для топ-символов на 33 биржах, Binance, OKX, Bybit, Gate.io, HTX, BingX, Bitget, MEXC, Kraken Futures, Hyperliquid, Aster, dYdX, ApeX, Backpack, Bitfinex, Bitmart, BloFin, BTSE, Crypto.com, Delta Exchange, Deribit, DigiFinex, Extended, HashKey, KuCoin, Lighter, Paradex, Phemex, Toobit, WEEX, WhiteBIT, WOO X и XT, с годовой APR нетто после учета издержек.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/funding-arb | jq '.rows[:5]'

Публичный снимок LiqMap (24H): оценка уровней ликвидаций по нескольким биржам для 201 основных бессрочных контрактов, Binance, Bybit, OKX, Gate, HTX и Hyperliquid, с наложением фактических ликвидаций. ?symbol=BTC..OP.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/liqmap/public?symbol=BTC' | jq '.real_levels.totals'

Снимок ставок финансирования по фиксированному набору крупных бессрочных контрактов Binance USDT-M: по каждому символу текущая ставка финансирования, изменение открытого интереса за 24h и изменение цены за 24h; ?format=csv возвращает те же строки в CSV.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/heatmap | jq '.rows[:5]'

Лидеры движения по доске давления: бессрочные контракты с наибольшим по модулю изменением открытого интереса за 24h (biggestOi24h), самой экстремальной ставкой финансирования (extremeFunding), самым широким базисом (widestBasis) и самой высокой оценкой давления (highestStress), у каждой строки указано направление. ?format=csv возвращает четыре списка одним CSV.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/top-movers | jq '.biggestOi24h[:5]'

Индекс сезона альткоинов: текущее значение в реальном времени, сильнейшие и слабейшие крупные альткоины, дневная история в записи.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/altseason | jq '.value'

8 равновзвешенных нарративных индексов (AI, RWA, DePIN, meme, L1, L2, DeFi, quantum) с фиксированными корзинами и ежедневными точками с 2025-01-01; добавьте ?points=0, чтобы получить только табло.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/themes | jq '.themes[] | {key, last, ret_30d_pct}'

Факторная панель: каждый зафиксированный метрик в своем историческом диапазоне с медианным движением BTC за 7 дней, которое последовало за ним, относительно базовой частоты.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/factors | jq '.rows[:5]'

Ставки маржинального заимствования: последняя годовая ставка по каждой площадке и активу (USDT, USDC, BTC, ETH и крупные альткоины на каждой площадке, чью историю заимствования мы можем читать), часовые ряды за 30 дней для стейблкоинов и мейджоров и керри funding минус заимствование по каждой площадке. Записывается ежечасно.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/borrow-rates' | jq '.latest[:5], .carry[:3]'

Торговые комиссии: maker и taker базового уровня по каждой площадке и типу рынка (медиана по парам, если площадка устанавливает цену для каждой пары), ежедневно считываются с собственного endpoint комиссий каждой биржи, плюс журнал изменений комиссий.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/fees' | jq '.median_taker_perp, .rows[:5]'

Календарь экспираций и расчётные цены: экспирации датированных фьючерсов и опционов на ближайшие 60 дней по спискам рынков 53 площадок, сгруппированные по дате, площадке и базовому активу, плюс расчётные цены, записанные при поставке датированных фьючерсов; recorded_venues показывает, на скольких площадках записана расчётная цена.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/settlements' | jq '.next_7d, .upcoming[:5], .recorded[:3]'

Одна биржа и всё, что мы о ней записываем: контракты в базе по типам, открытый интерес корзины и средний funding из 10-минутного рекордера площадок, сводка лестницы плеча, число сетей для депозита и вывода, базовые комиссии, аптайм по статусу и журнал последних событий. ?venue=bybit; без параметра вы получите список id записанных площадок. Это JSON, на котором построена /venues/<venue>.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/venues/profile?venue=bybit' | jq '.instruments, .status, .events[:3]'

Сети депозита и вывода на каждой площадке, которую мы записываем, ежедневно в виде медленно меняющихся строк: по каждому активу и сети флаг депозита, флаг вывода, комиссия и минимум вывода, плюс журнал приостановок и возобновлений. Без фильтров: выводы, приостановленные прямо сейчас, по значимости актива. ?asset=USDT: все площадки и сети для этого актива; ?venue=kucoin сужает выборку.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/withdrawals?asset=USDT' | jq '.rows[:5]'

Лестницы плеча по каждому бессрочному контракту на каждой площадке, чьи лестницы мы читаем, ежедневно в виде медленно меняющихся строк: уровень, нижняя и верхняя граница номинала, максимальное плечо, ставка поддерживающей маржи, плюс журнал снижений и повышений плеча. ?symbol=BTC сужает выборку до одного базового актива, ?venue=okx до одной биржи; без фильтров вы получите обзор по всем площадкам.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/leverage-tiers?symbol=SOL' | jq '.rows[:5]'

Агрегаты слоя площадок по каждому perp и spot фиду, который мы опрашиваем (список в поле coverage): совокупный OI по perp, доля DEX, диапазон funding, спред спота, привязки стейблкоинов; ?symbol=BTC для строк по одной монете. Площадки из oi_excluded_venues (WhiteBIT, BitMart) перечислены, но не входят в суммы OI и долю DEX.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/venues/markets | jq '.symbols[:3]'

Кто двигается первым: кросс-корреляции одноминутной доходности по парам площадок и UTC-дню с асимметрией опережения.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/venues/lead-lag | jq '.pairs[] | {id, summary}'

Поверхность IV по сроку экспирации и moneyness, для каждого срока ATM / 25-delta put и call IV, skew и butterfly, постоянная 30d история; ?currency=BTC|ETH.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/options/surface?currency=BTC' | jq '{atm_30d, skew25_30d_pp}'

Снимок опционов по площадкам Deribit, Bybit, Binance, OKX и Delta Exchange: стены OI, гамма-экспозиция дилеров, уровень нулевой гаммы, срочная структура и доля каждой площадки в venues_included. DVOL, это индекс Deribit.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" "https://bykaranteli.com/api/public/options?venue=all" | jq '.assets.BTC | {venues_included, call_wall, put_wall}'

Почасовая цепочка опционов по площадкам Deribit, Bybit, Binance, OKX и Delta Exchange, записывается с 2026-09-30: по каждой экспирации открытый интерес в монетах и USD с изменением за 1 час и 24 часа, ATM IV с изменением за 24 часа и max pain; по каждому контракту открытый интерес и его изменения, mark IV с изменением за 24 часа, а также mark, bid и ask Deribit в монетах; плюс почасовая траектория ATM IV одной экспирации за последние 24 ч. Изменение учитывает только площадки, которые есть в обоих часах. С любым ключом доступны контракты с наибольшим открытым интересом, первые 40; strikes=all возвращает все контракты при глубине участника (сессия Terminal или ключ Builder и выше).

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/options/chain?currency=BTC&venue=all' | jq '{hour, spot, front_expiry, expiries: .expiries[:3], strikes: .strikes[:3]}'

Лента опционов Deribit и OKX, фиксируемая каждые 15 минут: премия, страйки, put/call, блочные сделки, площадка для каждой печати; windows (купленная, проданная и чистая премия со знаком по типу опциона за 1 ч, 4 ч и 24 ч), by_expiry, by_strike, by_venue и последние многоэлементные структуры с их ногами и меткой типа.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/options-flow | jq '.assets.BTC | {prints_24h, call_premium_bought_24h_usd, put_premium_bought_24h_usd, block_share_24h}'

Потоки US spot BTC, ETH, SOL и XRP ETF: предварительный совокупный показатель за сегодня с таблицей по каждому фонду, последние 30 финализированных торговых дней и проверка эмитента IBIT (shares outstanding BlackRock x NAV по сравнению с лентой).

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/etf | jq '{btc: .assets.BTC.latest_finalized, issuer: .issuer_check}'

Токсичность потока ордеров (VPIN) по основным бессрочным контрактам из минутных баров с разметкой taker: текущее значение, его перцентиль за последние 90 дней с порогом 90-го перцентиля, среднее за 24h и размер корзины. Дневная история доступна на платном маршруте /api/x402/flow-vpin.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/flow | jq '.symbols.BTCUSDT | {vpin, percentile_90d, avg_24h}'

Премия Coinbase относительно Binance и basis cash-and-carry, ежедневная история с 2017; Kimchi premium (Upbit, Bithumb, Coinone) и премия Turkey (BtcTurk) с 2026-08-21.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/premium | jq '.assets.BTC | {date, premium_pct, avg7_pct}'

Commitments of Traders CFTC для Bitcoin futures, еженедельно, с обратным заполнением до 2018.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/cot | jq '.assets.BTC | {report_date, hedge_funds_net_contracts, institutions_net_contracts}'

Измеренные реакции BTC через 5, 30 и 60 минут на заявления FOMC (поля верхнего уровня) и на публикации CPI и отчёта по занятости (cpi, nfp), каждая с датой следующего релиза, плюс датированный макрокалендарь в events.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/events | jq '{fomc: .recent_reactions[:3], cpi_next: .cpi.next_release, nfp_next: .nfp.next_release}'

Лестницы проскальзывания live execution по размеру ордера, рассчитанные по реальным книгам заявок, фиксируются каждый час.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/slippage | jq '.ladders[:3]'

Лента whale: агрессивные рыночные сделки $1M+ из наших собственных сокетов, с агрегатами за 24h и долей buy.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/whales | jq '.window_24h'

Индикаторы цикла Bitcoin, пересчитываемые каждую ночь по первичному журналу закрытий с 2012: Pi Cycle Top (с датами пересечения), Mayer Multiple, 200-week и 2-year MAs, golden ratio multiple, profitable days, stock-to-flow, Puell Multiple с нашего собственного узла, позиционирование по марже Bitfinex. ?days= window, ?points=0 только для latest.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/indicators?points=0' | jq '.latest, .pi_cycle_crosses'

Тепловая карта RSI: Wilder RSI(14) на восьми интервалах (15m to 1M) для крипто top-400 Binance USDT perpetuals по объему плюс каждый TradFi perp, с количеством перекупленности и перепроданности по каждому интервалу. ?symbol=, ?kind=crypto|tradfi и ?sort=<interval> фильтруют и упорядочивают.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/rsi?sort=4h' | jq '.summary, .rows[:5]'

История открытого интереса по нескольким площадкам: почасовая сумма perp open interest по всем площадкам в нашем реестре на самом полном 10-минутном снимке часа (whitebit и bitmart исключены), доля DEX (ончейн-площадки перечислены в поле dex_venues) и текущий взвешенный по OI funding. ?days=1..90, по умолчанию 30; записывается с 2026-08-21.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/venues/oi-history?days=7' | jq '.oi_weighted_funding_pct, .points[-1]'

Реестр покрытия, получаемый в реальном времени: ленты ликвидаций по площадкам с типом (full, sampled, delayed, shadow, none), датой начала, событиями за 24h и последней записью; 10-минутные снимки лент по площадкам и рынкам с количеством символов и последним bucket; legs арбитража funding, источники позиционирования, whale tape, spot minutes и скан whale Hyperliquid с показателем freshness.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/coverage | jq '.totals, .liquidations[:3]'

Записанные временные ряды за SuperChart в едином формате для каждой метрики. Параметры: metric (price, volume, cvd_perp, cvd_spot, oi, funding, funding_agg, liquidations, long_short, top_traders, rsi, premium, etf_flow, borrow, whale_net), symbol (BTCUSDT), period (15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M; 1m, 3m, 5m, 10m с глубиной участника), limit (до 300 баров; до 5 000 с глубиной участника), to (ISO). Глубину участника дают ключ Builder и выше или членство Terminal при входе на сайт; ключ Free или Terminal получает глубину по умолчанию и 403 на 1m, 3m, 5m, 10m. Каждый ответ называет свой источник. Добавьте venue=<id> (bybit, okx, gate, hyperliquid и любая площадка рекордера), чтобы получить цену, открытый интерес и фандинг этой биржи; по умолчанию остаётся Binance.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/series?metric=oi&symbol=BTCUSDT&period=1h&limit=200' | jq '.source, .points[-3:]'

Глубина книги заявок по споту для BTC, ETH, SOL, XRP, DOGE, ADA, LINK, AVAX, LTC и BNB: книги 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, разбитые на интервалы 0.1% в пределах 20% от mid (USD notional, массивы bids и asks), крупнейшие стены с разделением по площадкам, глубина 2% и reach книги по каждой площадке; ?hours=1..24 добавляет суммарную 5-минутную историю. Каждая строка площадки содержит in_aggregate: false означает книгу, которую мы записываем, но не включаем в суммы и стены, поскольку ее размер не подтвержден; held_out перечисляет такие площадки, aggregate_venues считает суммируемые. Сырые снимки по каждой площадке доступны на платном маршруте /api/x402/orderbook-history.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/orderbook?symbol=BTC&hours=6' | jq '.walls[:5], .venues'

Панель позиционирования для 30 наиболее торгуемых Binance USDT perps: собственные опубликованные соотношения long/short по аккаунтам и позициям и taker flow каждой биржи на Binance, Bybit, OKX, Gate, HTX, Bitget и Kraken Futures, плюс размеры маржинальных позиций long и short Bitfinex на спотовой маржинальной книге (маржинальные заемщики, а не аккаунты перпетуалов), открытый интерес long и short в долларах на GMX и Jupiter Perps (perpetual DEX с пулом ликвидности: разбивка по сторонам, а не соотношение аккаунтов), и серии CVD (24h at 5m, 7d at 1h) для BTC, ETH и SOL. Почасовая история доступна на платном маршруте /api/x402/positioning-history.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/positioning?symbol=BTCUSDT' | jq '.rows[0]'

Заметки деска, новые сверху: короткие датированные наблюдения, которые автор деска (модель ИИ) написал по собственным записанным данным ByKaranteli о деривативах и сверил с ними перед публикацией; у каждой время публикации в UTC, время данных карточки, новостная ценность деска от 0 до 10, панель, монеты и постоянный URL. По умолчанию последние 24 часа; ?day=YYYY-MM-DD один день UTC, ?since=<iso> до 7 дней назад, ?type=<card> один тип карточки, ?lang=zh|ru|ko перевод (заметка без перевода возвращается на английском с пометкой), ?limit=1..100. Архив по дням и языкам на /api/x402/desk-notes-history; английский текст в бесплатном наборе данных desk-notes; RSS на /desk/feed.xml.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/desk?limit=5' | jq '.notes[] | {published_at, type, headline, url}'

Панель турецкой премии: референсные цены в TRY и USDT по 5 парам, которые строятся каждую минуту по турецким спотовым площадкам (медиана средних цен подходящих стаканов), статус, спред и глубина стакана каждой площадки, премия в б.п. (пары в TRY через USDT/TRY против глобальной цены Binance; USDT/TRY против фикса ЕЦБ). ?pair=BTC-TRY&days=1..30 добавляет 15-минутную историю; бесплатный дневной CSV /api/v1/public/datasets/turkey-premium-daily.csv; минутные строки на /api/x402/turkey-premium-history. Блок index содержит индекс турецкой премии: полную премию BTC-TRY к фиксингу ECB USD/TRY в б.п. с долларовой частью и крипточастью, оценку от 0 до 100 (50 соответствует мировой цене), режим, средние за 24 часа и 7 дней и серию одного знака; у каждой пары есть index_bps, у каждой площадки implied_index_bps. index.reference_state показывает, живой ли референс USD/TRY в эту минуту: fresh (внутридневная котировка моложе 30 минут при открытом валютном рынке), carried (валютный рынок закрыт с пятницы 22:00 до воскресенья 22:00 UTC или живой источник недоступен менее 24 рыночных часов; используется последняя котировка) или stale (старше 24 рыночных часов); score и regime равны null, пока состояние не fresh, причина в score_paused_reason, а дневные строки содержат minutes_fresh, minutes_carried, minutes_stale и index_live_close (индекс последней минуты fresh относительно живой котировки); дневной CSV добавляет minutes_fresh и index_live_close последними двумя столбцами.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/turkey-premium?pair=BTC-TRY&days=1' | jq '{index: (.index | {value_bps, score, regime, dollar_leg_bps, crypto_leg_bps}), btc_try: (.pairs["BTC-TRY"] | {price, status, eligible})}'

Proof API слоя BYK Data Layer (бета): каждые пять минут наши расчётные данные (композитная ставка финансирования, совокупный открытый интерес, ликвидации за 5 минут, глубина, премии, оценка давления) сводятся в корень Меркла, подписываются и записываются в Solana, а раз в сутки в Base. Ключ не нужен. Индекс показывает последние эпохи со ссылками на блокчейн; /genesis, /authorization-log, /epochs/{sequence}, /epochs/{sequence}/records, /proofs/{sequence|latest}/{feed}/{asset} (лист, путь аудита, манифест, подпись, привязки), /witness-keys/{kind}/{n}, /documents/{hash} и /catalog возвращают точные байты, которые нужны верификатору. Страница с проверкой в браузере: /proof. Ответы /api/public/pressure, /api/public/premium (строки кимчи-премии Upbit), /api/public/orderbook и /api/public/turkey-premium содержат byk_proof: последнюю запечатанную запись того же вычисления (sequence, proof_url, sealed_value) и matches_this_value, которое показывает, совпадает ли соседнее число с запечатанным. Независимый верификатор в одном файле, который читает только Solana и Base: /byk-verify.mjs.

curl -s 'https://bykaranteli.com/api/v1/proof/proofs/latest/BYK.FUNDING.COMPOSITE.B/BTC' | jq '{sequence, result, value: .decoded.value_decimal, unit: .decoded.unit, leaf_index, path: (.audit_path | length), solana: .anchors.solana[0].links.explorer}'

Панель Jupiter Perps (Solana): точный long и short open interest по каждому рынку (SOL, ETH, BTC) из on-chain custody state, загрузка пула и почасовые ставки заимствования, JLP AUM и APR, объем за 24h, топ-трейдеры недели по realized PnL. ?base=SOL&days=7 добавляет почасовую историю OI (максимум 30 days).

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/jupiter?base=SOL&days=1' | jq '.markets[0], .history.points[-1]'

Панель Solana Perps: все площадки бессрочных контрактов Solana, которые мы читаем (Jupiter, Pacifica, Phoenix, GM Trade, Velocity, Bullet), обновление каждые 10 минут. venues даёт открытый интерес в одну сторону (oi_usd, на пуловых площадках также oi_long_usd и oi_short_usd), объём за 24h, число рынков, медианную почасовую ставку с rate_kind (Jupiter: borrow_hourly, почасовая плата пулу за заимствование; остальные площадки: funding_hourly) и as_of, а также stale: true, когда при сбое источника показано последнее успешное чтение; totals суммирует их; markets перечисляет все рынки всех площадок по убыванию открытого интереса (instrument_type, mark, изменение за 24h, открытый интерес в USD с обеими сторонами, если площадка их публикует, объём за 24h, почасовая ставка в процентах от позиции; null, если площадка не публикует число). ?venue=jupiter|pacifica|phoenix|gmtrade|velocity|bullet фильтрует рынки; &symbol=SOL&days=1..30 добавляет почасовую историю одного рынка на любой площадке, кроме Jupiter (история Jupiter остаётся на /api/public/jupiter). С любым ключом доступно 7 дней истории; больше 7 дней доступно участникам (сессия Terminal или ключ Builder и выше). Полный почасовой набор находится на платном маршруте /api/x402/solana-perps-history, строки на полночь в наборе данных solana-perps-daily.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/solana-perps?venue=phoenix&symbol=SOL&days=1' | jq '.totals, .venues, .markets[0], .history.points[-1]'

Трекер whale Hyperliquid: 1000 крупнейших аккаунтов по equity, сканирование каждые 5 минут, long против short notional по каждой монете с крупнейшей позицией на каждой стороне, каждая открытая позиция, а при events=1 последние 200 изменений позиции (opened, closed, increased, reduced, flipped); address=0x... оставляет один аккаунт. Полная история событий доступна на платном /api/x402/hl-whale-events.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/hyperliquid-whales?coin=BTC&events=1' | jq '.by_coin, .events[:5]'

Карта цен ликвидации Hyperliquid по одной монете: открытые позиции 1000 крупнейших по equity аккаунтов, размещённые по цене ликвидации, которую Hyperliquid сообщает для каждой, полосами по 0.25% от mark. long (ниже mark) и short (выше) перечисляют полосы от ближней к дальней с price, notional_usd, positions и знаковым distance_pct; totals считает все позиции, without_liq_px это позиции с кросс маржой без цены ликвидации; largest это крупнейшая полоса с каждой стороны; model_comparison ставит ближайший кластер модели LiqMap с каждой стороны рядом с ближайшей отслеживаемой полосой (null вне вселенной LiqMap); coverage показывает, сколько из 1000 аккаунтов ответили и когда; history даёт почасовой номинал long и short, записываемый с 2026-09-30. Строки по каждой позиции на /api/x402/hl-positions-history.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/hyperliquid-positions?coin=BTC' | jq '{coin, mark, coverage, largest, model_comparison, nearest_long: .long[:3], nearest_short: .short[:3]}'

Панель TradFi perpetuals: каждый Binance stock, index и commodity perp с funding, basis, open interest, объемом за 24h и ликвидациями, указанием других площадок, где он листится, и состоянием торговой сессии. ?market= и ?symbol= фильтруют.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/tradfi?market=EQUITY' | jq '.rows[:5]'

Зафиксированные ликвидации за 24h по стороне, символу и площадке, тип покрытия каждой площадки и оценка рынка с поправкой на покрытие вместе с входными данными.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/liquidations | jq '{recorded, market_estimate, by_exchange}'

Крупнейшие одиночные ликвидации за последние 24h, 7d или 30d по учитываемым площадкам (ранг, символ, площадка, сторона, цена, количество, номинал, время) и тепловая карта сессий за 30 дней: ячейки день недели на час UTC, итоги по часам и дням, доли Азии, Европы и США.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/liquidation-leaderboard?window=7d&limit=10' | jq '{window, largest: .largest[:3], sessions: .sessions.sessions}'

Токенизированные акции: обертки в сети от xStocks, Robinhood Stock Tokens, Coinbase Tokenized Stocks, Binance bStocks, Ondo Stocks, Backpack Securities, Reality (Bitget), Superstate Opening Bell, Figure, Dinari dShares и Securitize (Exodus) по базовым акциям (эмитент, сеть, цена, премия к реальной акции, ликвидность DEX и объем за 24 часа, предложение, держатели, статус), токенизированные спотовые пары на биржах, референсная цена и ее сессия, сопоставление с перпетуалами и итоги панели, обновление каждые 10 минут. Обертки берутся только из источников эмитентов: публичный API Backed (xStocks), API активов Robinhood, API токенизированных акций Coinbase, список монет Binance плюс отпечаток контракта (bStocks), CSV адресов Ondo плюс отпечаток контракта, список проверенных токенов Jupiter (Backpack), список спотовых рынков Gate (gStocks, только биржа), API Reality плюс проверка идентичности, API Superstate, маркер ограниченной акции в Provenance (Figure), проверка принадлежности к фабрике Dinari (dShares) и запись актива Algorand (токен акции Exodus, трансфер-агент Securitize). Поле price_source у каждой обертки называет цену, по которой оценено ее предложение в долларах (reference: референсная цена акции; issuer_oracle: цена эмитента для токена; wrapper: собственная цена в пулах или на бирже; null: без долларов), а totals.priced_by считает обертки по уровням, включая оставшиеся без цены. ?underlying=TSLA, ?issuer=xstocks | robinhood | coinbase | bstocks | ondo | backpack | gstocks | reality | superstate | figure | dinari | securitize, ?chain=solana, ?top=1..200 (по умолчанию 50); дневной CSV tokenized-stocks-daily, почасовые строки по оберткам на /api/x402/tokenized-stocks-history.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/tokenized-stocks?top=5' | jq '{supply_usd: .totals.supply_usd, premium_median_pct: .totals.premium_median_pct, rows: [.rows[] | {underlying, supply_usd, wrappers: [.wrappers[] | {issuer, chain, price, premium_pct}]}]}'

Страховые фонды бирж Binance, Bybit, OKX, Gate, MEXC, Bitfinex, Crypto.com, Delta Exchange, dYdX и Paradex: последнее ежечасное чтение по каждой площадке (сумма в USD, по активам, изменение за 24 ч и 7 дн, фонд против открытого интереса бессрочных контрактов площадки), каждый пул и дневные закрытия по площадкам. ?venue=binance | bybit | okx | gate | mexc | bitfinex | cryptocom | delta | dydx | paradex, ?days=1..366, ?pools=0 убирает строки пулов; дневной CSV insurance-funds-daily, ежечасные строки пулов на /api/x402/insurance-fund-history. Площадка, которая перестала публиковать данные, учитывается по последнему чтению до 48 часов и указывается в stale_venues, затем исключается из итога и указывается в missing_venues; для итога нужны Binance, Bybit, OKX и Gate.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/insurance-funds?days=7&pools=0' | jq '{total_usd, change_24h_pct, venues: [.venues[] | {venue, total_usd, coverage_pct}]}'

Автоматически выявленные каскады ликвидаций с размером, стороной, монетами и траекторией цены.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/incidents | jq '.incidents[0]'

Доска открытого интереса по 10 основным бессрочным контрактам с разрешением 5 минут: по каждому символу OI в USD, изменение открытого интереса и цены за 24h и режим (longs_building, shorts_building, deleverage_down, deleverage_up, quiet); last_bar_utc показывает время последнего бара.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/oi | jq '.symbols[:5]'

30-дневная скользящая матрица корреляции Пирсона дневных доходностей по основным бессрочным контрактам.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/correlations | jq '.symbols'

Модель состояния ликвидности PsiCharge: score, state и опубликованная годовая таблица показателей.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/charge | jq '{score, state}'

Объем Bitcoin, подверженный квантовым рискам, измеряемый ежедневно на основе нашего собственного узла, с хэшами происхождения.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/quantum | jq '.latest | {exposed_btc, base_height}'

Официальный макронабор через FRED: ставки центробанков, инфляция и занятость, балансы центробанков, кривая казначейских бумаг и широкий долларовый индекс ФРС, плюс наш сводный индикатор глобальной ликвидности (формула в composite) и предложение стейблкоинов; latest, series, groups и definitions (название, единица, периодичность, источник); ?days=365.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/macro?days=30' | jq '{composite: .composite.formula, liquidity: .latest.global_liquidity_busd, cpi: .latest.fred_cpi_yoy_pct, groups: [.groups[] | .key]}'

Состояние сети Bitcoin на основе нашего собственного узла: хешрейт, сложность, комиссии, mempool; ?days=365.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/network | jq '.latest'

Новые и делистингованные бессрочные контракты на 6 биржах, сканируемые ежечасно; ?days=30.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/listings | jq '.listed[:5]'

Контекст по диапазонам для любой записанной метрики: где находится текущий уровень и что последовало далее; ?metric=coinbase_premium_pct.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/context?metric=coinbase_premium_pct' | jq '{metric, today_value, interpretation}'

Сигнал smart money по одному символу на основе записанного позиционирования.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/smart-money/BTCUSDT | jq '.'

43 datasets в формате CSV или JSON: market history, symbol board, listings, liquidations, ETF flows (total + by fund), COT, premium, DVOL, options chain + flow, metrics, quantum, theme indices, venue markets, whale trades, stablecoin pegs, basis, slippage. Полный каталог на /data. Ежедневные CSV-отражения: github.com/bykarantelicom/crypto-datasets

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/v1/public/datasets/daily-market.csv | head -5

Сколько аккаунт вызывающего ключа израсходовал по своему плану, те же цифры, что в заголовках x-quota: plan (tier, label), rate.per_minute, monthly (limit, used, remaining, reset, state: ok, slow_lane, refused_until_reset или unlimited), today (вызовы по всем ключам аккаунта), keys (active, limit) и x402 (included_calls_per_month, included_used_this_month, applies, requests_per_call, history_days, где null означает весь архив, rows_per_call, raw_records_included; при applies false поля requests_per_call, history_days и rows_per_call равны null, а raw_records_included равно false). Нужен ключ аккаунта: вызов без него получает 401 key_required.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/v1/usage | jq '{plan, monthly, today}'

Все рыночные индексы в одном payload: Retail Euphoria Index (proprietary) + Fear & Greed (alternative.me) + CoinGecko global + DeFiLlama stablecoin flow + Altcoin Season Index (top-50 alts vs BTC, 90d).

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/indices | jq '.euphoria.score, .fearGreed.today.valueRaw'

Retail Euphoria Index, отдельный инструмент. Композит из F&G + трендовых мемов + доминирования BTC + позиционирования crowd по топ-30.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/euphoria | jq '{score, regime, explainer}'

Встраиваемый HTML-виджет, показывающий текущий score давления для символа. Используйте в iframe. Темная тема, без трекинга.

<iframe src="https://bykaranteli.com/embed/pressure/BTCUSDT" width="340" height="200" style="border:0"></iframe>

Встраиваемый виджет ликвидаций за 24h: итоги long/short, число событий, топ-символы, крупнейший принт. Галерея и условия на /widgets.

<iframe src="https://bykaranteli.com/embed/liquidations" width="100%" height="300" style="border:0"></iframe>

Встраиваемый виджет глубины spot order book для одной из 10 отслеживаемых монет: глубина 2%, дисбаланс, walls, mirrored bin strip.

<iframe src="https://bykaranteli.com/embed/orderbook/BTC" width="100%" height="380" style="border:0"></iframe>

Встраиваемый виджет long/short positioning для одного perp, данные по соотношениям Binance, Bybit, OKX и taker flow.

<iframe src="https://bykaranteli.com/embed/positioning/BTC" width="100%" height="200" style="border:0"></iframe>

Виджет whales для Hyperliquid, встраиваемый: номинал лонг против шорт у 1000 крупнейших аккаунтов по каждой монете.

<iframe src="https://bykaranteli.com/embed/whales" width="100%" height="330" style="border:0"></iframe>

Виджет breadth RSI(14), встраиваемый: число перекупленных и перепроданных по каждому интервалу, а также экстремумы на ?interval.

<iframe src="https://bykaranteli.com/embed/rsi?interval=4h" width="100%" height="340" style="border:0"></iframe>

<iframe src="https://bykaranteli.com/embed/liquidations" width="100%" height="300" style="border:0;border-radius:12px;background:#0b0e14" loading="lazy" title="Liquidations 24h"></iframe>

• Лимит запросов составляет 30 запросов в минуту на ключ на плане Free API (60 на Terminal, 300, 1 200 и 3 000 на Builder, Business и Scale), плюс 15 000 запросов за календарный месяц на бесплатных ключах и 150 000 на ключах Terminal (с 2026-09-25 сверх этого 429 monthly_quota_exceeded). У Builder, Business и Scale есть пределы добросовестного использования: 1 000 000, 3 000 000 и 10 000 000 в месяц; сверх них платный ключ никогда не останавливается и отвечает со скоростью Free (30 в минуту) до сброса месяца. Каждый ответ по ключу на плане с месячным лимитом несет заголовки x-quota-limit, x-quota-used и x-quota-reset; x-quota-state: slow отмечает ответ из медленной полосы. Включенный вызов каталога x402 считается здесь за 10 запросов и отдельно идет в потолок каталога плана (1 000 в месяц на Builder, 10 000 на Business, без потолка на Scale и выше). Браузеры на сайте ограничены по IP. Сверх лимита приходит 429 с retry-after.
• Данные доступны только для чтения. PII и торговые действия не раскрываются.
• Атрибуция: видимая ссылка обратно на bykaranteli.com или на исходную страницу (например, /symbols) приветствуется при встраивании.
• Личное и исследовательское использование с атрибуцией бесплатно. Коммерческое использование данных, которые мы вычисляем, требует плана Business, распространение производных данных требует Scale; сырые записи и другие сторонние данные на любом плане предназначены только для вашего собственного использования. Выдавать наши цифры за ваш собственный внутренний бэктест нельзя никогда.
• Скрапинг внутренних маршрутов (/dashboard/*, /api/admin/*, /api/member/*) заблокирован и отслеживается. Используйте только /api/public/*.