/api/funding/heatmap
GETДоступен

Тепловая карта ставок финансирования

Тепловая карта ставок финансирования (монета × день)

GET/api/funding/heatmap

Запрос

Параметры запроса

ИмяТипОбязательныйПо умолчаниюДопустимые значенияОписание
daysintegerНеобязательный30≥ 7 · ≤ 90Период выборки в днях. Пример: 30
exchangestringНеобязательныйbinance—Идентификатор биржи (в нижнем регистре, например binance). Пример: binance
limitintegerНеобязательный50≤ 100Число возвращаемых строк.

Пример запроса

curl -s "https://www.coinboss.com/api/funding/heatmap?exchange=binance&days=30"

Поля ответа

Таблица полей формируется из реальных ответов, поэтому в ней перечислено ровно то, что возвращает эндпоинт. В путях a[] обозначает элементы массива, а {*} — объекты с динамическим ключом, например монетой или биржей.

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
daysnumber—Дневные значения или число дней.
coinsarray—Монеты.
coins[]string—Монеты.
day_tsarray—Метка времени.
day_ts[]numbermsМетка времени.
matrixarray—Матрица с ключами по строке и столбцу.
matrix[]array—Матрица с ключами по строке и столбцу.
matrix[][]number|null—Матрица с ключами по строке и столбцу.

Сформировано 2026-11-11 23:00 UTC; использовано реальных ответов: 3.

Пример ответа

/api/funding/heatmap?exchange=binance&days=30 · Реальный ответ, получен 2026-11-13 03:57:47 UTC. Длинные массивы и словари сокращены для отображения: coins: элементов было 50; day_ts: элементов было 30; matrix: элементов было 50; matrix[]: элементов было 30.

  • {
    • "success": true,
    • "exchange": "binance",
    • "days": 30,
    • "coins": [
      • "BTC",
      • "ETH",
      • "ZEC",
      • "SOL",
      • "XAU",
      • "XRP",
      • "HYPE",
      • "XAG"
      ],
    • "day_ts": [
      • 1792022400000,
      • 1792108800000,
      • 1792195200000,
      • 1792281600000,
      • 1792368000000,
      • 1792454400000,
      • 1792540800000,
      • 1792627200000
      ],
    • "matrix": [
      • [ … 8 ],
      • [ … 8 ]
      ]
    }

Проверенные образцы

Помимо примера выше, автопроверка вызывает этот эндпоинт с указанными параметрами и каждый раз сверяет схему.

ПараметрыHTTPЗадержкаРезультат
days=30&exchange=okx20065 msПройдено
days=30&exchange=hyperliquid20078 msПройдено

Проверено: 2026-11-13 03:57:47 UTC

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
5m
Пограничный микрокеш
10s
Частота обновления
ежечасно (коллектор deriv по 60-минутному таймеру; задание расчётов собственного слоя данных — начиная с 6-й минуты каждого часа)
Окно
параметр days, по умолчанию 30, диапазон 7..90; одна ячейка на монету за каждый день UTC
Источники данных
Записи рассчитанных ставок финансирования, которые собственные коллекторы ежечасно опрашивают через публичные эндпоинты истории финансирования 16 площадок (например, binance, bybit, okx, gate, bitget, hyperliquid).
Покрытие бирж
одна биржа на запрос (параметр exchange, по умолчанию binance); топ-монеты по фьючерсному объёму; некриптовалютные символы отфильтровываются по белому списку криптовалют; 16 площадок; binance покрывает все бессрочные контракты USDT; bybit / okx / gate / bitget покрывают топ-60 монет по фьючерсному объёму, htx — топ-20; aster, hyperliquid, kucoin, mexc, bingx, kraken, dydx, deribit, whitebit, cryptocom хранят по одному основному контракту на монету; у bitfinex нет публичной истории расчётов; глубина истории зависит от площадки (binance / bybit / okx / bitget — с 2026-04-04, остальные — позже)
Пагинация
limit = число монет (по умолчанию 50, макс. 100)
Сортировка
по убыванию фьючерсного объёма
Единицы измерения
cumulative settled funding in percent per UTC day; day_ts in Unix ms
Метод расчёта
cell = SUM(settled rate) x 100 over all settlements of that coin on that UTC day for the selected exchange
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный

Текущий статус

ДоступенПроверено: 2026-11-13 03:57:47 UTCHTTP 200318 msСхема совпадаетВозраст самой новой точки данных: 4h

Доступность за последние 30 дней

Пройдено 100% из 410 проверок

Ошибки

Неудачные вызовы имеют одинаковую структуру на всех эндпоинтах. Полный список приведён на странице ошибок. Ошибки и лимиты запросов →

КодHTTPЗначениеЧто делать
INVALID_PARAM400Отсутствует обязательный параметр, или значение не принимается. `param` называет параметр, если он известен.Не повторяйте запрос без изменений; исправьте его.
UNAUTHORIZED401Заголовок `CB-API-KEY` был отправлен, но ключ неизвестен или отозван. Для публичных данных ключ не нужен — уберите заголовок или используйте действительный ключ.Не повторяйте запрос без изменений.
FORBIDDEN403Маршрут не входит в публичный API (внутренний или только для аккаунта).Не повторяйте запрос.
NOT_FOUND404Неизвестный маршрут, либо запрошенная монета / биржа / фонд не существует.Не повторяйте запрос; сверьте путь и идентификаторы с каталогом.
RATE_LIMITED429Запросов больше, чем позволяет поминутный лимит. `Retry-After` указывает, сколько секунд нужно подождать.Дождитесь истечения `Retry-After`, затем повторите запрос с нарастающей задержкой.
INTERNAL500Непредвиденная ошибка сервера. Сообщение намеренно общее; при обращении указывайте `request_id`.Повторите запрос один раз через несколько секунд; если ошибка сохраняется, сообщите о ней, указав ID запроса.
UPSTREAM_FAILED503Источник данных, стоящий за этим эндпоинтом, не ответил вовремя. Устаревшие или подменные значения вместо него не возвращаются.Повторите запрос с нарастающей задержкой; проверьте страницу статуса.
UNAVAILABLE501 / 503Набор данных временно не готов (прогрев кеша), либо у эндпоинта пока нет законного публичного источника.Повторите запрос позже; каталог помечает эндпоинты, недоступные по проектному решению.
REQUEST_FAILED200Некоторые более старые эндпоинты отвечают HTTP 200 с `success: false`. Всегда проверяйте `success`, а не только статус HTTP.Зависит от сообщения; считайте запрос неудачным.

Попробовать

GET/api/funding/heatmapДоступен
Параметры

integer · по умолчанию 30 · мин. 7 · макс. 90 — Look-back window in days.

string · по умолчанию binance — Exchange id (lowercase, e.g. binance).

integer · по умолчанию 50 · макс. 100 — Number of rows to return.

URL запросаhttps://www.coinboss.com/api/funding/heatmap?days=30&exchange=binance
Выберите эндпоинт и нажмите «Отправить запрос». Здесь появятся ответ, заголовки и время выполнения.