Публичные обновления

Программа, вызвавшая маршрут с ключом без пригодного ключа, теперь узнаёт, что увидел шлюз: тело ответа 401 key_required содержит поле reason (none, empty_authorization, empty_x_api_key, malformed_authorization, malformed_x_api_key или non_bearer_scheme) и фразу, которая его называет. Пустой заголовок, заполнитель вроде bk_..., префикс, скопированный из списка ключей, нераскрытая переменная оболочки или значение Bearer, которое шаблон превратил в undefined, отклоняются до любого поиска, к какому бы классу ни относился вызывающий; ключ во втором заголовке по-прежнему учитывается. Таблица ошибок для разработчиков, руководство по подключению и публичный манифест описывают это поле. Все примеры на странице разработчиков, в панели, в Playground, в руководстве по подключению и в карточке агента читают ключ из одной переменной BYKARANTELI_API_KEY, а панель нового ключа показывает строку export и готовый первый вызов.

С ключом аккаунта tier_required теперь, как и другие отказы, называет два способа оплатить вызов (предоплаченный ключ в x-api-key при ключе аккаунта в Authorization: Bearer или кошелек без ключа аккаунта) и дает ссылку на планы; аккаунт, для которого ByKaranteli отключил каталог, сохраняет свою формулировку на всех маршрутах. Записи /api/x402 содержат included_from (builder, business или null для магазина предоплаченных ключей, который всегда покупается) рядом с raw_records, а openapi.json перечисляет ответы каждого типа маршрута (400 там, где он есть, 402, 403 и заголовки ответа 200) с x-raw-records и x-included-from. networks-history и leverage-tiers-history применяют окно плана к сроку действия: возвращается версия, которая началась до окна и еще действует или закончилась внутри него. x-quota-used теперь учитывает вызов, на который отвечает, в том числе в медленной полосе и с полным весом включенного вызова каталога, поэтому совпадает с /api/v1/usage.

Таблица, которую читает /api/x402/funding-history, содержит только расчёты бессрочных контрактов Binance USDT-M. До сегодняшнего дня фильтр exchange сравнивал значение с внутренним именем источника, поэтому exchange=binance возвращал пустой результат. Теперь exchange=binance (в любом регистре) читает все строки, любая другая площадка получает 400 до запроса и не оплачивается, а вызов без параметра работает как прежде. Маршрут и файл bulk-derivatives теперь описывают то, что содержат: полные данные для TradFi perpetuals и символов, которые наши страницы читают каждый день, с возможными пропусками у редко читаемых контрактов. Страницы планов: массовые выгрузки следуют окну истории плана, Business за последние 365 дней и Scale за весь архив, в виде месячных файлов, текущий месяц обновляется каждый день; строка Scale больше не упоминает ежедневные сырые выгрузки, которых в плане не было.

Ключ аккаунта читает каталог /api/x402 в рамках плана: с месячным потолком, окном истории и лимитом строк за вызов. Builder: 1 000 включенных вызовов каталога в месяц за последние 90 дней, до 5 000 строк за вызов, только сводные ряды (маршруты сырых записей оплачиваются за вызов). Business: 10 000 в месяц за последние 365 дней, до 20 000 строк за вызов, сырые записи включены. Scale и Enterprise: без потолка, весь архив, сырые записи включены. Окно отсчитывается от 00:00 UTC, и каждый включенный вызов по-прежнему считается за 10 запросов месячного добросовестного использования плана. Сырые записи это отдельные события ликвидаций и рейтинг крупнейших принтов, принты китов, события позиций Hyperliquid и почасовые записи позиций, снимки стакана, минутные бары и снимки рынков по площадкам. Два новых ответа, оба с оплатой за вызов: 403 history_window (from, to или days раньше окна плана) и 403 raw_tier_required (маршрут сырых записей на плане ниже Business); x402_allowance_used (HTTP 402) снова означает потолок плана. Чтобы оплатить вызов, когда в запросе есть ключ аккаунта, передайте ключ аккаунта в заголовке Authorization: Bearer, а предоплаченный ключ в x-api-key, или отправьте вызов без ключа аккаунта и оплатите кошельком. Включенные ответы несут x-history-window-days и x-history-row-cap (оба отсутствуют у liqmap-levels, options-flow и flow-vpin; последний не у массовых выгрузок), а при потолке еще x-x402-allowance-limit и x-x402-allowance-used; /api/v1/usage добавляет history_days, rows_per_call и raw_records_included. Вызовы с кошелька и по предоплаченному ключу не меняются: весь архив с собственным лимитом строк маршрута, $0.10 за вызов. Планы, документация API.

/api/liqmap/v3 обслуживает собственное чтение страницы LiqMap. Запрос без сессии участника, который приходит не из браузера (без Fetch Metadata, как у curl или скрипта), теперь получает тот же ответ 401 key_required, что и /api/liqmap/public, с Cache-Control: no-store. Сама страница и другие браузеры читают его как прежде, а запрос с ключом аккаунта обслуживается и учитывается как любой другой вызов с ключом. Программам следует использовать GET /api/liqmap/public или GET /api/public/liqmap с бесплатным ключом аккаунта.

GET /api/public/liqmap и каждый ответ LiqMap теперь содержат meta.inputs_present (ticker, orderbook, long_short, open_interest, funding, liquidity_snapshots; true, когда вход дошёл до модели) и meta.degraded, равный true, когда отсутствовал один из рыночных входов (тикер, стакан, long/short, открытый интерес, фандинг) и его заменило нейтральное значение по умолчанию; liquidity_snapshots носит справочный характер, сборщик глубины покрывает часть вселенной. Разреженная карта читается как разреженная, а не выдаёт себя за полную.

В потоке wss://bykaranteli.com/ws/v1 появился новый канал снимков tokenized: панель токенизированных акций с тем же ответом, что GET /api/public/tokenized-stocks (эмитент, сеть или площадка, цена, референсная цена, премия и предложение каждой обертки, с отметкой as_of), отправляется при изменении. Подписка: {"op":"subscribe","channel":"tokenized"}; его открывает каждый план, который открывает все каналы потока. Таблица каналов на /ru/developers.

У ключей Builder и Business был потолок включённых вызовов каталога в месяц, а сверх него приходил 402. Потолка больше нет: ключ Builder и выше вызывает любой маршрут /api/x402 в рамках плана, и каждый успешный вызов каталога считается за 10 запросов месячного добросовестного использования плана, той же цифры, которую несут заголовки x-quota и /api/v1/usage. Сверх добросовестного использования ключ замедляется до скорости Free, но не останавливается. Ключи Free и Terminal, кошельки и предоплаченные ключи платят за вызов, как прежде. Планы, документация API.

/api/public/macro отдаёт все макросерии с группами, формулой и входами композита и по каждой серии метку, единицу, периодичность, преобразование, источник и первую дату; latest всегда последняя строка серии независимо от окна. /api/public/events добавляет блоки cpi и nfp рядом с FOMC: измеренные реакции, размер против обычного получаса, доля роста и следующая запланированная публикация, а также датированные строки событий, которые читают отметки графика. Документация API.

GET /api/public/hyperliquid-positions?coin=BTC возвращает карту цен ликвидации с почасовым архивом (24 часа всем, 720 с глубиной участника); ?address= фильтрует /api/public/hyperliquid-whales и /api/x402/hl-whale-events; платный /api/x402/hl-positions-history отдаёт строки почасового архива, бесплатный набор hl-position-levels текущие уровни; маршруты участника /api/member/hl-addresses принимают сессию или ключ аккаунта. MCP: get_hl_positions, list_tracked_addresses, add_tracked_address, remove_tracked_address. Документация API.

GET /api/public/options/chain?currency=BTC отдаёт открытый интерес и IV по экспирации и страйку с изменением за последний час и за 24 часа и почасовой ATM IV ближайшей экспирации (крупнейшие страйки всем, каждый страйк с глубиной участника через ?strikes=all). /api/public/options-flow и платный /api/x402/options-flow добавляют знаковые премии покупки, продажи и нетто за 1h, 4h и 24h по типу опциона, разбивки по экспирации, страйку и площадке и последние многоногие структуры, названные по своим ногам. Набор options-chain-hourly; платный /api/x402/options-chain-history. MCP: get_options_chain. Документация API.

/api/public/tradfi-gaps (window, symbol) и /api/public/venue-share (days); наборы tradfi-gaps и venue-share-daily; платный /api/x402/venue-share-history с почасовыми строками по каждой учитываемой площадке, итогом часа и долей. MCP: get_tradfi_gaps, get_venue_share. Документация API.

GET-запрос к /api/v1/usage с вашим ключом возвращает план вызывающего ключа, его лимит частоты, использованную месячную квоту и время её сброса, вызовы за сегодня, ключи аккаунта и лимит x402. Заголовки ответа о частоте и квоте и таблица ошибок описаны на /ru/developers.

Каждый пример REST на /ru/developers передаёт заголовок с ключом аккаунта и работает в том виде, как написан. Количества в манифесте и документе OpenAPI читаются из кода и совпадают с тем, что отдаёт API, а версии ru и ko перечисляют каждый эндпоинт.

Планы: у Terminal есть лимит для хобби в API (60 запросов в минуту, 150 000 в месяц); у Builder, Business и Scale пределы добросовестного использования 1, 3 и 10 млн вызовов в месяц, сверх них ключ замедляется до скорости Free, но никогда не останавливается; каталог x402 входит в план до 1 000 вызовов в месяц на Builder и до 10 000 на Business, на Scale без потолка. Цены не изменились.

Каждый платный маршрут под /api/x402 теперь стоит $0,10 в USDC за вызов (Solana или Base) вместо прежних $0,002 до $0,01. Предоплаченный ключ остался $10 и теперь покрывает 100 вызовов. Каталог, /openapi.json, документ .well-known/x402 и документация для разработчиков читают цену из одного места, поэтому изменились вместе.

wss://bykaranteli.com/ws/v1 with the same account key on the handshake. Event channels push liquidation prints from nine venues, $1M+ whale prints, Hyperliquid whale position events and your own alert firings as they happen, each with a seq you can resume from; snapshot channels push pressure, open interest, funding and LiqMap only when the payload changes, in the same shape as the REST routes. Paid plans only: Builder gets one connection with liquidations for three named symbols, Business opens all nine channels with five connections and 15 minutes of replay, Scale and Enterprise raise every limit. Protocol, examples and error codes on /developers; connection, frame and time usage on /dashboard/api.

/pricing now says plainly what it sells: Terminal for people ($29 a month, 1 to 12 month terms) and the API plans for programs (free key, Builder $49, Business $149, Scale $399), with one table that lists every feature side by side. Free and Terminal keys carry a quota of 15,000 requests per calendar month (UTC): every keyed response reports it in x-quota-limit, x-quota-used and x-quota-reset, and from 2026-10-01 a key over the quota answers 429 until the month resets; Builder and above have no monthly cap. Two enforcement fixes: a program that sends browser headers but names itself in the User-Agent is treated as a program and needs a key, and 5-minute SuperChart bars with 5,000 bars of history are a Terminal feature again for signed-in accounts (a free account sees the public depth). The hosted MCP endpoint caps keyless clients at 600 tool calls a day per client; a key lifts that. /dashboard/api shows the month's calls against the quota.

The public JSON API now takes an account key from programs: a free key comes with any verified account (/dashboard/api, 30 requests a minute) and is required for scripts, bots and agents from 2026-09-10; pages on the site keep working without one. New plans for code on /pricing: Builder $49, Business $149 and Scale $399 a month buy rate, member depth on the API (LiqMap on seven timeframes, 5-minute series) and, from Business, a commercial licence and bulk exports; every paid API plan includes the Terminal membership, and members active today keep Builder rights for the rest of their period. Datasets served from this site are now under the ByKaranteli Data Licence (personal and research use with attribution, see /data); files published earlier on the GitHub, Kaggle, Hugging Face and Zenodo mirrors stay CC0 and stop updating. The MCP package 0.26.0 reads BYKARANTELI_API_KEY.

The rule-based signal engine, its receipts, strategy pages and performance APIs were removed. The former hub pages redirect to the data they were built on (/data, /symbols, /methodology) and individual receipt URLs answer 410 Gone. The symbol pages now show recorded price, funding, open interest and the derivatives pressure score; the MCP server serves 45 data tools. Nothing about the recording network changed.

13 dataset routes are listed in the Coinbase Bazaar directory with live CDP settlement. Agents can pay per call with USDC; the free snapshots stay free. Details at /developers.