Журнал изменений
Каждое изменение Data API и его контракта, сначала новые. Номера версий следуют политике версионирования и устаревания.
/mcp теперь также принимает MCP-ключ в заголовке X-API-Key: YOUR_API_KEY - для клиентов и шлюзов, таких как Smithery, которые резервируют Authorization для собственной авторизации. Authorization: Bearer продолжает работать и остаётся способом по умолчанию, описанным в документации; если отправлены оба заголовка, проверяется именно ключ из X-API-Key. Data API на /api/v1 по-прежнему принимает только Bearer-ключи. Неудачные попытки аутентификации теперь ограничиваются не только по IP, но и по ключу, поэтому недействительный ключ одного клиента больше не блокирует других клиентов за тем же IP.
GET /calculators/compound-interest округлял срок до целого числа периодов капитализации, поэтому срок, заканчивающийся посреди периода, моделировался слишком длинным или слишком коротким: 6 месяцев при капитализации annually считались полным годом (12 взносов и проценты за весь год), а 5 месяцев не давали ни одного периода (ни взносов, ни процентов). Теперь целые периоды рассчитываются как прежде, последний неполный период приносит проценты пропорционально (простые проценты за его долю), а каждый взнос в пределах срока учитывается. Если срок равен целому числу периодов капитализации, результаты не меняются; параметры и поля ответа не изменились.
API и его документация трактовали rate как ставку за период капитализации, тогда как калькулятор на сайте и инструкция к нему использовали годовую ставку. GET /calculators/compound-interest применял rate целиком к каждому периоду капитализации, поэтому 5% при ежемесячной капитализации росли как 5% в месяц. Теперь rate - номинальная годовая ставка: каждый период приносит rate, делённую на число периодов в году (5% при ежемесячной капитализации дают 5/12% в месяц), о чём теперь сообщает meta.note. Параметры и поля ответа не меняются; результаты меняются для всех частот капитализации, кроме annually. Кроме того, если contribution_frequency и compound_frequency обе равны daily или обе равны weekly, взносы больше не задерживаются и не теряются из-за округления чисел с плавающей запятой, поэтому total_contributions при duration_unit=months может быть больше на один взнос. Это меняет смысл существующего параметра: чтобы воспроизвести прежние результаты, умножьте rate на число периодов капитализации в году.
Каждое значение Fear & Greed теперь содержит index рядом с score: индекс Fear & Greed от 0 до 100 в точности как на Bitculator (0–19 крайний страх, 20–39 страх, 40–59 нейтрально, 60–79 жадность, 80–100 крайняя жадность) — используйте его для отображения. score не изменился: это исходный составной показатель −100…+100, из которого выводится index. Относится к GET /sentiment/fear-greed (основное значение и каждая запись в intervals), fear_greed в GET /global и meta.fear_greed в GET /global/heatmap. Только добавление; существующие поля не изменены.
GET /coins/{slug} возвращал fully_diluted_valuation равным 0 для монет без максимального предложения (например, Solana и Ethereum, предложение которых не ограничено). Теперь используется общее предложение, а если неизвестно ни одно, значение равно null, как уже было описано в контракте OpenAPI.
marketcap и dominance могут быть null для монеты без циркулирующего предложения, а score и breakdown рейтинга доверия равны null для биржи без ранга. POST /alarms возвращает 422, если у монеты нет текущего значения выбранной метрики. /coins/recently-added и /wallets/timeline теперь учитывают sort. /coins/gainers и /coins/losers сортируются по самому изменению (раньше фактически по рыночной капитализации), а losers исключают монеты с 0.00. Сортировка по возрастанию возвращает null-значения последними. /prices сопоставляет неоднозначный символ с активной монетой с самым высоким рейтингом. Контракт OpenAPI помечает рыночные поля, которые могут быть null, и типизирует объём за 24 ч как число.
Опубликованный контракт теперь содержит примеры на уровне media-type, одну общую схему ошибки, на которую ссылается каждый ответ 4xx/5xx, ответы 401, 429 и 500, которые может вернуть любой вызов с ключом, заголовки X-RateLimit-* и X-Quota-* в каждом успешном ответе, доставку alarm.triggered как callback на POST /webhooks, а также метаданные контакта, лицензии и условий. Ни один запрос или ответ не изменился - только то, как они описаны.
Новое: /apis.json, /.well-known/api-catalog (RFC 9727), /.well-known/security.txt (RFC 9116), бандл JSON Schema с общими формами ответов, публичная страница статуса с JSON-двойником, этот журнал изменений и политика версионирования и устаревания.
MCP-сервер перешёл на собственные ключи и тарифы, выпускаемые в MCP-консоли. Ключи Data API больше не принимаются на /mcp; каждый вызов инструмента по-прежнему стоит один запрос.
MCP-сервер Bitculator запущен на /mcp: 19 инструментов «только для чтения» по Streamable HTTP для Claude, Cursor, VS Code и любого MCP-клиента, возвращающих те же данные в виде десятичных строк, что и REST API.
Клиенты для TypeScript, Python, PHP, Go, Rust, Java, C# и C++, каждый покрывает все эндпоинты на общем транспортном ядре: Bearer-аутентификация, распаковка оболочки, захват X-Quota-*, повторы при 429 и 5xx, типизированные ошибки и постраничная навигация.
Некоторые эндпоинты и более длинные окна индикаторов теперь требуют Starter или Pro. Вызов вне вашего тарифа возвращает 403 plan_required, где details.required_plan называет тариф, который его открывает, и не расходует квоту.
Запуск: 85 операций в 15 группах - монеты, цены, рынки, биржи, кошельки, глобальные данные, настроения, индикаторы, ликвидации, конвертация, калькуляторы, редакционные материалы, оповещения, вебхуки и мета. Bearer-ключи с правом data-api, оболочка { data, meta }, точность десятичных строк, заголовки X-Quota-*, подписанные вебхуки и тарифы Free, Starter и Pro с собственной месячной квотой.
Об устаревании объявляется здесь и по электронной почте каждому владельцу ключа не позднее чем за шесть месяцев до удаления - см. политику устаревания. Машиночитаемый индекс /apis.json несёт дату самой новой записи в своей метке modified.