Рыночные данные
Инструмент
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, если не просили). |