Накопленное финансирование одной монеты по биржам
Накопленное финансирование одной монеты по биржам
/api/funding/accumulatedЗапрос
Параметры запроса
| Имя | Тип | Обязательный | По умолчанию | Допустимые значения | Описание |
|---|---|---|---|---|---|
| days | integer | Необязательный | 7 | ≥ 1 · ≤ 90 | Период выборки в днях. Пример: 7 |
| base | string | Необязательный | BTC | — | Символ базовой монеты (в верхнем регистре, например BTC). Пример: BTC |
Пример запроса
curl -s "https://www.coinboss.com/api/funding/accumulated?base=BTC&days=7"Поля ответа
Таблица полей формируется из реальных ответов, поэтому в ней перечислено ровно то, что возвращает эндпоинт. В путях a[] обозначает элементы массива, а {*} — объекты с динамическим ключом, например монетой или биржей.
| Поле | Тип | Единица | Описание |
|---|---|---|---|
| success | boolean | — | true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`. |
| base | string | — | Символ базового актива. |
| days | number | — | Дневные значения или число дней. |
| unit | string | — | Единица значений в этом объекте. |
| now | number | ms | Время сервера в момент формирования ответа. |
| series | array | — | Временной ряд. |
| series[] | object | — | Временной ряд. |
| series[].exchange | string | — | Идентификатор биржи в нижнем регистре (например, `binance`). |
| series[].symbol | string | — | Символ инструмента, нормализованный CoinBoss (например, BTCUSDT). |
| series[].points | array | — | Точки данных. |
| series[].points[] | array | — | Точки данных. |
| series[].points[][] | number | — | Точки данных. |
| series[].total_pct | number | % | Доля в общем значении. |
| series[].n | number | — | Число учтённых элементов. |
| series[].n_expected | number | count | Сколько расчётов должно быть в полном окне: `days` × 24 ÷ `interval_h`; null, если интервал расчётов определить не удаётся. |
| series[].interval_h | number | h | Интервал финансирования. |
| series[].last_time | number | ms | Время последнего расчёта. |
| series[].history_from | number | ms | Самая ранняя из хранимых записей расчётов по этому контракту. |
| series[].complete | boolean | — | True, если история биржи охватывает начало окна и содержит не менее 90 % ожидаемых расчётов; false означает, что `total_pct` неполное. |
| unavailable | array | — | Элементы, по которым нет данных, с указанием причин. Никогда не сообщаются как 0. |
| unavailable[] | string | — | Элементы, по которым нет данных, с указанием причин. Никогда не сообщаются как 0. |
| method | string | — | Примечания о формуле / методе. |
Сформировано 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"
- "unavailable"
- "backpack"
- "bitfinex"
- "bitunix"
- "edgex"
- "lbank"
- "lighter"
- "paradex"
- "method""settled_records: cum = Σ 交易所实际结算费率(funding_settle,逐笔);1h/4h 结算的交易所每笔都计入;complete=false 为历史起点晚于窗口起点或窗内结算笔数不足(断档)"
Проверенные образцы
Помимо примера выше, автопроверка вызывает этот эндпоинт с указанными параметрами и каждый раз сверяет схему.
| Параметры | HTTP | Задержка | Результат |
|---|---|---|---|
| base=ETH&days=7 | 200 | 42 ms | Пройдено |
| base=SOL&days=7 | 200 | 41 ms | Пройдено |
| base=ARKM&days=7 | 200 | 37 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
- Стабильность
- Стабильный
Текущий статус
Площадки без истории расчётов (перечислены в `unavailable`) не включаются; они указываются поимённо, а не заполняются нулём.
Доступность за последние 30 дней
Пройдено 100% из 411 проверок
Ошибки
Неудачные вызовы имеют одинаковую структуру на всех эндпоинтах. Полный список приведён на странице ошибок. Ошибки и лимиты запросов →
| Код | HTTP | Значение | Что делать |
|---|---|---|---|
| INVALID_PARAM | 400 | Отсутствует обязательный параметр, или значение не принимается. `param` называет параметр, если он известен. | Не повторяйте запрос без изменений; исправьте его. |
| UNAUTHORIZED | 401 | Заголовок `CB-API-KEY` был отправлен, но ключ неизвестен или отозван. Для публичных данных ключ не нужен — уберите заголовок или используйте действительный ключ. | Не повторяйте запрос без изменений. |
| FORBIDDEN | 403 | Маршрут не входит в публичный API (внутренний или только для аккаунта). | Не повторяйте запрос. |
| NOT_FOUND | 404 | Неизвестный маршрут, либо запрошенная монета / биржа / фонд не существует. | Не повторяйте запрос; сверьте путь и идентификаторы с каталогом. |
| RATE_LIMITED | 429 | Запросов больше, чем позволяет поминутный лимит. `Retry-After` указывает, сколько секунд нужно подождать. | Дождитесь истечения `Retry-After`, затем повторите запрос с нарастающей задержкой. |
| INTERNAL | 500 | Непредвиденная ошибка сервера. Сообщение намеренно общее; при обращении указывайте `request_id`. | Повторите запрос один раз через несколько секунд; если ошибка сохраняется, сообщите о ней, указав ID запроса. |
| UPSTREAM_FAILED | 503 | Источник данных, стоящий за этим эндпоинтом, не ответил вовремя. Устаревшие или подменные значения вместо него не возвращаются. | Повторите запрос с нарастающей задержкой; проверьте страницу статуса. |
| UNAVAILABLE | 501 / 503 | Набор данных временно не готов (прогрев кеша), либо у эндпоинта пока нет законного публичного источника. | Повторите запрос позже; каталог помечает эндпоинты, недоступные по проектному решению. |
| REQUEST_FAILED | 200 | Некоторые более старые эндпоинты отвечают HTTP 200 с `success: false`. Всегда проверяйте `success`, а не только статус HTTP. | Зависит от сообщения; считайте запрос неудачным. |
Попробовать
/api/funding/accumulatedЧастичноinteger · по умолчанию 7 · мин. 1 · макс. 90 — Look-back window in days.
string · по умолчанию BTC — Base coin symbol (uppercase, e.g. BTC).
https://www.coinboss.com/api/funding/accumulated?days=7&base=BTCДругие эндпоинты этой категории
- Финансирование по одной монете /api/sd/funding
- История финансирования, взвешенного по OI / по объёму /api/currency/funding-weighted
- Детализация ставок финансирования одной монеты по биржам /api/derivatives/funding-detail
- Накопленное финансирование одной монеты по биржам /api/funding/accumulated
- Возможности арбитража финансирования /api/funding/arbitrage
- Ряды для графика ставки финансирования по одной монете /api/funding/chart
- Текущие ставки финансирования одной монеты на всех биржах /api/funding/coin
- Накопленные комиссии финансирования /api/funding/fees
- Тепловая карта ставок финансирования /api/funding/heatmap
- История ставки финансирования одной монеты на одной бирже /api/funding/history
- Матрица ставок финансирования /api/funding/matrix
- Список ставок финансирования по монетам /api/market/funding
- Рейтинг спреда ставок финансирования между биржами /api/market/funding-spread