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

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

Сьогодні ми відкриваємо цей двигун. Bitculator Data API запущено — JSON-API з автентифікацією Bearer з 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 та отримання підписаних доставок вебхуків, коли вони спрацьовують.
• Метадані - використання, плани та машинно-читальна специфікація.

Повна довідкова база з прикладами для кожного ендпойнта зберігається в документації 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 ceiling; деталі та поточні ціни знаходяться на сторінці 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, тому що хотіли, щоб він існував. Якщо ви щось побудуєте на ньому, ми щиро хочемо дізнатися про це.