Объём 24ч—Открытый интерес—Ликвидации 24ч$1.36BЛонг/Шорт 24ч—Доминация BTC—Доминация ETH—
Приложение
Язык ▾
₽ RUB ▾
/api/funding/history
GETДоступен

История ставки финансирования одной монеты на одной бирже

История ставки финансирования одной монеты на одной бирже

GET/api/funding/history
Контракты, котируемые в кратных количествах монеты (например, `1000PEPE`), сопоставляются с базовой монетой. Это почасовые снимки текущей (прогнозной) ставки финансирования, а не ставок, по которым фактически прошли расчёты. Финансирование по состоявшимся расчётам доступно в `/api/funding/accumulated`.

Запрос

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

ИмяТипОбязательныйПо умолчаниюДопустимые значенияОписание
basestringОбязательный——Символ базовой монеты (в верхнем регистре, например BTC). Пример: BTC
exchangestringНеобязательныйbinance—Идентификатор биржи (в нижнем регистре, например binance). Пример: binance
hoursintegerНеобязательный168≥ 1 · ≤ 2160Период выборки в часах. Пример: 168

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

curl -s "https://www.coinboss.com/api/funding/history?base=BTC&exchange=binance&hours=168"

Поля ответа

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

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
basestring—Символ базового актива.
exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
hoursnumber—Часовые значения или число часов.
symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
countnumber—Число элементов.
dataarray—Полезные данные.
data[]object—Полезные данные.
data[].hour_tsnumbermsНачало часового интервала.
data[].ratenumber—Ставка финансирования текущего периода в том виде, в каком её публикует биржа.

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

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

/api/funding/history?base=BTC&exchange=binance&hours=168 · Реальный ответ, получен 2026-11-13 04:02:36 UTC. Длинные массивы и словари сокращены для отображения: data: элементов было 168.

  • {
    • "success": true,
    • "base": "BTC",
    • "exchange": "binance",
    • "hours": 168,
    • "symbol": "BTCUSDT",
    • "count": 168,
    • "data": [
      • { … 2 },
      • { … 2 }
      ]
    }

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

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

ПараметрыHTTPЗадержкаРезультат
base=ETH&hours=168&exchange=binance2007 msПройдено
base=SOL&hours=168&exchange=binance2006 msПройдено
base=ARKM&hours=168&exchange=binance2009 msПройдено

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

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
5m
Пограничный микрокеш
10s
Частота обновления
почасовой архив при каждой смене часа UTC (снимок таблицы последних значений); копия в ClickHouse синхронизируется раз в 5 min
Окно
параметр hours, по умолчанию 168 h, диапазон 1..2160 h; часовые точки
Источники данных
Текущие ставки финансирования, которые собственные коллекторы опрашивают через публичные REST API 24 площадок бессрочных контрактов (например, binance, okx, bybit, bitget, gate, hyperliquid).
Покрытие бирж
одна биржа на запрос (параметр exchange, по умолчанию binance); только варианты написания символа BASEUSDT / BASE-USDT-SWAP / BASE_USDT
Единицы измерения
rate as a raw fraction per funding interval; hour_ts in Unix ms
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный

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

ДоступенПроверено: 2026-11-13 04:02:36 UTCHTTP 2001 msСхема совпадаетВозраст самой новой точки данных: 63m

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

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

Ошибки

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

Код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/historyДоступен
Параметры

string — Base coin symbol (uppercase, e.g. BTC).

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

integer · по умолчанию 168 · мин. 1 · макс. 2160 — Look-back window in hours.

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