Представляем Bitculator Data API

Каждый график, таблица и индикатор на Bitculator работает на одном двигателе данных: живые цены обновляются примерно каждую минуту, тысячи рынков на биржах, показатели настроения, технические индикаторы, ликвидации, глобальная история рынка.

Сегодня мы открываем этот движок. Bitculator Data API запущен - Bearer-аутентифицированный JSON API с 85 конечными точками в 15 группах, бесплатный уровень и документация на 19 языках.

Ваш первый вызов — одна строка:

curl "https://bitculator.com/api/v1/coins?per_page=5" \\ -H “Authorization: Bearer YOUR_API_KEY”
{ "data": [ { "rank": 1, "name": "Bitcoin", "symbol": "BTC", "price": "67412.83451201", "..." : "..." } ], "meta": { "current_page": 1, "per_page": 5, "..." : “...”} }

Создайте ключ в консоли разработчика и этот вызов заработает прямо сейчас. 

API организован в 15 групп ресурсов, и всё, что платформа показывает, содержится там:

• Монеты и цены - полный каталог активов, живые котировки, исторические цены, OHLC, данные о предложении.
• Рынки и биржи - пары, тикеры, объёмы и детали бирж на всех площадках, которые мы отслеживаем.
• Кошельки - каталог кошельков с спецификациями и поддерживаемыми активами.
• Глобальный рынок - общая капитализация рынка, объём и доминирование, включая исторические серии.
• Настроение и индикаторы - страх и жадность, сигналы бычьего/медвежьего режима и технические индикаторы (RSI, скользящие средние и пр.) для каждого актива.
• Ликвидации - данные по длинным/коротким ликвидациям.
• Конвертация и калкуляторы - конвертация крипто↔фиат по актуальным курсам и конечные точки калькулятора платформы.
• Редакционные материалы - статьи и глоссарий.
• Сигнализация и вебхуки - создание ценовых сигналов через API и получение подписанных доставок вебхуков, когда они срабатывают.
• Meta - использование, планы и машиночитаемая спецификация.

Полная справка с примерами для каждого конечного пункта находится в документации API.

Несколько решений в дизайне, на которых мы не пошли на компромисс:

• Десятичная точность в виде строк. Цены, ставки и запасы возвращаются в виде строк, а не чисел с плавающей точкой. Число с плавающей точкой не может точно передать 0.00000001842, поэтому мы не просим его. Ваш парсер сохраняет каждую цифру, которую произвел рынок.
• Одна конвертация, повсюду. Успешные ответы имеют вид { data, meta }; любая ошибка 4xx или 5xx — { "error": { "code", "message", "details" } }. Совпадение по error.code: сообщения могут быть переформулированы, коды стабильны.
• Ваш квотник зависит от каждого ответа. Заголовки X-Quota-Limit, X-Quota-Used и X-Quota-Reset возвращаются с каждым вызовом, поэтому вы никогда не будете гадать, где вы находитесь — хотя можно просто запросить GET /usage.
• Предсказуемые пределы. лимиты per_page зависят от плана, и превышение лимита возвращает честный 422. API никогда не «мылит» ваш запрос и не отдаёт меньше, чем вы просили.
• Подписанные вебхуки. Доставки оповещений несут заголовок в стиле Stripe X-Bitculator-Signature, чтобы вы могли проверить подлинность перед доверием полезной нагрузке.
• Публичная спецификация. Весь интерфейс описан в OpenAPI спецификации, и документация предлагает готовую коллекцию Postman.

У Data API есть своя ежемесячная квота, отдельно от встроенных виджетов Bitculator. Бесплатный уровень не требует карты — получите ключ и начинайте строить. Платные планы увеличивают месячный пул вызовов и верхний предел per_page предела; детали и текущие цены доступны на странице Data API.

Помимо API мы поставляем восемь официальных, лицензированных MIT SDK - TypeScript, Python, PHP, Go, Rust, Java, C# и C++ - каждый покрывает все 85 конечных точек с автоматической пагинацией, типизированными ошибками, умными повторными попытками и встроенным гарантом использования десятичной строки. Команды установки, логотипы и ссылки на репозитории для всех восьми находятся в разделе SDK на странице API, а исходники открыты на github.com/bitculator. Но для ясности: SDK вам не нужен. Это простой HTTP с заголовком Bearer — curl, fetch, requests или Guzzle работают точно так же, как вы ожидаете.

1. Просмотрите страницу Data API для планов, квот и быстрой старты.
2. Создайте свой ключ в консоли разработчика
3. Сделайте первый вызов — и проверьте заголовки X-Quota-*, которые возвращаются вместе с ним.

Мы создали этот API, потому что хотели, чтобы он существовал. Если вы что-то построите на его основе, нам действительно приятно об этом узнать.