Ринкові дані
Інструмент
search_coins
Знаходить монету чи токен за довільною текстовою назвою або символом і повертає канонічний slug із ранжованим ринковим зведенням для кожного збігу. Точка входу: усі інші інструменти по монетах адресуються за slug.
| Параметр |
Тип |
Опис |
query
обов'язковий
|
string |
Довільний текстовий пошук за назвами та символами монет. |
type
|
enum |
Обмежити збіги: coin або token. |
limit
|
integer |
Максимум збігів у відповіді (1–50, за замовчуванням 10). |
Інструмент
get_coin
Повний профіль однієї монети: пропозиція, ранг та його зміни, історичні максимум/мінімум і відстань до них, повністю розводнена оцінка, посилання, контракти та опис.
| Параметр |
Тип |
Опис |
slug
обов'язковий
|
string |
Канонічний slug монети, наприклад bitcoin. |
Інструмент
get_prices
Поточні спотові ціни до 100 монет одним викликом, за бажанням — з конвертацією у фіатну валюту. Найдешевший спосіб відповісти на питання про ціну: потрібен рівно один селектор.
| Параметр |
Тип |
Опис |
slugs
|
string |
Slug монет через кому — пріоритетний селектор. |
symbols
|
string |
Тікери через кому; неоднозначні символи зіставляються з монетою з найвищим рангом. |
ids
|
string |
Числові id монет Bitculator через кому. |
convert
|
string |
Символ фіатної валюти для конвертації цін, наприклад EUR. За замовчуванням USD. |
Інструмент
get_top_movers
Найбільші лідери зростання чи падіння за відсотковою зміною за останні 24 години або 7 днів.
| Параметр |
Тип |
Опис |
direction
обов'язковий
|
enum |
gainers або losers. |
interval
|
enum |
Вікно зміни для ранжування: 24h або 7d (за замовчуванням 24h). |
limit
|
integer |
Максимум монет у відповіді (1–50, за замовчуванням 10). |
Інструмент
get_trending_coins
Монети, які зараз привертають найбільше уваги на Bitculator, у вигляді компактних ринкових рядків.
| Параметр |
Тип |
Опис |
limit
|
integer |
Максимум монет у відповіді (1–20, за замовчуванням 10). |
Історія
Інструмент
get_price_history
Свічки OHLCV по монеті за діапазон дат. Зберігання: хвилинні ~8 днів, півгодинні ~3 місяці, годинні ~6 місяців, денні — вся історія. Повертає найсвіжіші свічки у вікні, починаючи з найстаріших.
| Параметр |
Тип |
Опис |
slug
обов'язковий
|
string |
Канонічний slug монети. |
interval
|
enum |
Інтервал свічки: minutely, half-hourly, hourly або daily (за замовчуванням daily). |
start
|
date |
Початок вікна у форматі YYYY-MM-DD; за замовчуванням — нещодавнє вікно, що відповідає інтервалу. |
end
|
date |
Кінець вікна у форматі YYYY-MM-DD; за замовчуванням — зараз. |
limit
|
integer |
Максимум свічок у відповіді (1–500, за замовчуванням 90). |
Інструмент
get_historical_price
Ціна однієї монети на одну конкретну дату в минулому, з відкатом до 3 днів, якщо на точний день даних немає.
| Параметр |
Тип |
Опис |
slug
обов'язковий
|
string |
Канонічний slug монети. |
date
обов'язковий
|
date |
Дата у форматі YYYY-MM-DD (2009-01-01 або пізніше, не в майбутньому). |
Інструмент
get_global_history
Часовий ряд загальної капіталізації крипторинку чи загального обсягу. Гранулярність залежить від періоду: 24h — півгодинна, 7d — годинна, 30d і all — денна.
| Параметр |
Тип |
Опис |
metric
обов'язковий
|
enum |
Який ряд повернути: marketcap або volume. |
period
|
enum |
Вікно: 24h, 7d, 30d або all (за замовчуванням 24h). |
Настрої та глобальні дані
Інструмент
get_global_market
Зріз усього ринку: загальна капіталізація, загальний обсяг за 24 години, домінантність BTC/ETH та кількість монет/токенів/бірж/пар.
Цей інструмент не приймає параметрів.
Інструмент
get_fear_greed
Індекс настроїв «Страх та жадібність» по всьому ринку або по одній монеті, якщо передано slug, включно із суб-оцінками за інтервалами 7d/30d.
| Параметр |
Тип |
Опис |
coin
|
string |
Необов'язковий slug монети для значення по конкретній монеті; пропустіть для загальноринкового індексу. |
Інструмент
get_altseason_index
Індекс альтсезону — чи випереджають альткоїни біткоїн — з опціональною денною історією.
| Параметр |
Тип |
Опис |
days
|
integer |
Скільки днів денної історії включити (0–365; 0 повертає лише поточне значення). |
Інструмент
get_liquidations_summary
Сьогоднішні підсумки ліквідацій ф'ючерсів із розбивкою long/short та домінантністю. Одразу після денного перекату дані можуть бути null.
Цей інструмент не приймає параметрів.
Біржі
Інструмент
list_exchanges
Біржі в рейтингу з обсягом за 24 години, домінантністю за обсягом та кількістю пар/активів. Також зіставляє назви бірж зі slug.
| Параметр |
Тип |
Опис |
type
|
enum |
Обмежити централізованими (cex) або децентралізованими (dex) біржами. |
search
|
string |
Довільний текстовий пошук за назвами бірж. |
sort
|
string |
Поля сортування через кому, префікс "-" для спадання: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets. |
limit
|
integer |
Максимум бірж у відповіді (1–50, за замовчуванням 10). |
Інструмент
get_exchange
Повний профіль однієї біржі: ранг, обсяг та зміни, домінантність, лістинговані пари й активи та посилання.
| Параметр |
Тип |
Опис |
slug
обов'язковий
|
string |
Канонічний slug біржі, наприклад binance-exchange. |
Інструмент
get_exchange_trust_score
Рейтинг довіри біржі (0–10) з повною розбивкою за 13 факторами.
| Параметр |
Тип |
Опис |
slug
обов'язковий
|
string |
Канонічний slug біржі. |
Інструмент
get_coin_markets
Де торгується монета: її ринки на біржах із парою, ціною та обсягом за 24 години, відсортовані за обсягом.
| Параметр |
Тип |
Опис |
slug
обов'язковий
|
string |
Канонічний slug монети. |
exchange
|
string |
Необов'язковий slug біржі, щоб обмежити результати одним майданчиком. |
instrument
|
enum |
Обмежити одним типом інструмента: spot, future, option, swap або margin. |
limit
|
integer |
Максимум ринків у відповіді (1–50, за замовчуванням 10). |
Аналіз та утиліти
Інструмент
get_coin_technicals
Мультиіндикаторний технічний зріз по монеті одним викликом: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, волатильність та інше — кожен з актуальним станом та оцінкою.
| Параметр |
Тип |
Опис |
slug
обов'язковий
|
string |
Канонічний slug монети. |
Інструмент
convert_currency
Конвертує суму між будь-якими крипто- та/або фіатними валютами (до 10 цілей за виклик) за живими курсами, з повною десятковою точністю.
| Параметр |
Тип |
Опис |
from
обов'язковий
|
string |
Slug вихідної валюти, наприклад bitcoin або united-states-dollar. |
to
обов'язковий
|
string |
Slug цільових валют через кому, до 10. |
amount
|
number |
Сума вихідної валюти для конвертації (за замовчуванням 1). |
Інструмент
calculate_dca
Бектест стратегії усереднення (DCA) на реальній історії цін: усього вкладено, накопичено монет, поточна вартість і прибуток/збиток.
| Параметр |
Тип |
Опис |
slug
обов'язковий
|
string |
Канонічний slug монети. |
amount
обов'язковий
|
number |
Сума в USD, що купується на кожному інтервалі. |
interval
обов'язковий
|
enum |
Періодичність покупок: daily, weekly, monthly, quarterly або yearly. |
start
обов'язковий
|
date |
Дата першої покупки у форматі YYYY-MM-DD (раніше за сьогодні). |
end
|
date |
Дата останньої покупки у форматі YYYY-MM-DD; за замовчуванням — сьогодні. |
series
|
boolean |
Включити серію по кожній покупці (великий вивід — залишайте false, якщо не просили). |