/api/funding/accumulated
GETЧастично

Накопленное финансирование одной монеты по биржам

Накопленное финансирование одной монеты по биржам

GET/api/funding/accumulated
Частичное покрытие. Площадки без истории расчётов (перечислены в `unavailable`) не включаются; они указываются поимённо, а не заполняются нулём.

Запрос

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

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

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

curl -s "https://www.coinboss.com/api/funding/accumulated?base=BTC&days=7"

Поля ответа

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

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
basestring—Символ базового актива.
daysnumber—Дневные значения или число дней.
unitstring—Единица значений в этом объекте.
nownumbermsВремя сервера в момент формирования ответа.
seriesarray—Временной ряд.
series[]object—Временной ряд.
series[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
series[].symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
series[].pointsarray—Точки данных.
series[].points[]array—Точки данных.
series[].points[][]number—Точки данных.
series[].total_pctnumber%Доля в общем значении.
series[].nnumber—Число учтённых элементов.
series[].n_expectednumbercountСколько расчётов должно быть в полном окне: `days` × 24 ÷ `interval_h`; null, если интервал расчётов определить не удаётся.
series[].interval_hnumberhИнтервал финансирования.
series[].last_timenumbermsВремя последнего расчёта.
series[].history_fromnumbermsСамая ранняя из хранимых записей расчётов по этому контракту.
series[].completeboolean—True, если история биржи охватывает начало окна и содержит не менее 90 % ожидаемых расчётов; false означает, что `total_pct` неполное.
unavailablearray—Элементы, по которым нет данных, с указанием причин. Никогда не сообщаются как 0.
unavailable[]string—Элементы, по которым нет данных, с указанием причин. Никогда не сообщаются как 0.
methodstring—Примечания о формуле / методе.

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

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

/api/funding/accumulated?base=BTC&days=7 · Реальный ответ, получен 2026-11-13 04:02:35 UTC. Длинные массивы и словари сокращены для отображения: series: элементов было 16; series[].points: элементов было 21.

  • {
    • "success": true,
    • "base": "BTC",
    • "days": 7,
    • "unit": "pct",
    • "now": 1794542263852,
    • "series": [
      • { … 10 },
      • { … 10 }
      ],
    • "unavailable": [
      • "backpack",
      • "bitfinex",
      • "bitunix",
      • "edgex",
      • "lbank",
      • "lighter",
      • "paradex"
      ],
    • "method": "settled_records: cum = Σ 交易所实际结算费率(funding_settle,逐笔);1h/4h 结算的交易所每笔都计入;complete=false 为历史起点晚于窗口起点或窗内结算笔数不足(断档)"
    }

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

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

ПараметрыHTTPЗадержкаРезультат
base=ETH&days=720042 msПройдено
base=SOL&days=720041 msПройдено
base=ARKM&days=720037 msПройдено

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

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
10m
Пограничный микрокеш
10s
Частота обновления
ежечасно (коллектор deriv по 60-минутному таймеру; задание расчётов собственного слоя данных — начиная с 6-й минуты каждого часа)
Окно
параметр days, по умолчанию 7, диапазон 1..90
Источники данных
Записи рассчитанных ставок финансирования, которые собственные коллекторы ежечасно опрашивают через публичные эндпоинты истории финансирования 16 площадок (например, binance, bybit, okx, gate, bitget, hyperliquid).
Покрытие бирж
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, остальные — позже); биржи с действующей ставкой финансирования, но без истории расчётов перечислены в `unavailable`
Сортировка
по убыванию total_pct
Единицы измерения
unit = 'pct': cumulative settled funding in percent (points = [funding_time ms, cumulative %]); total_pct in percent; interval_h in hours
Метод расчёта
per exchange: cum = running SUM(settled rate) x 100 over the window for the contract with the most settlements; complete = history starts before the window AND settlement count >= 90% of floor(days x 24 / interval_h)
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный

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

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

Площадки без истории расчётов (перечислены в `unavailable`) не включаются; они указываются поимённо, а не заполняются нулём.

Доступность за последние 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/accumulatedЧастично
Параметры

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

string · по умолчанию BTC — Base coin symbol (uppercase, e.g. BTC).

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