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

Финансирование по одной монете

Собственный слой данных: финансирование по одной монете (приведено к 8h, взвешено)

GET/api/sd/funding

Запрос

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

ИмяТипОбязательныйПо умолчаниюДопустимые значенияОписание
coinstringОбязательный——Символ монеты; 400, если не указан. Псевдоним: `base`. Пример: BTC

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

curl -s "https://www.coinboss.com/api/sd/funding?coin=BTC"

Поля ответа

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

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
coinstring—Символ монеты в верхнем регистре (например, BTC).
nownumbermsВремя сервера в момент формирования ответа.
unitstring—Единица всех полей ставок в этом ответе: `fraction` (0.0001 = 0.01 %).
avg_8hnumberfraction per 8hПростое среднее ставок, приведённых к 8h, по одному контракту на биржу.
oi_weighted_8hnumberfraction per 8hСреднее ставок, приведённых к 8h, взвешенное по открытому интересу.
apr_pctnumber% per yearПростой пересчёт в годовое выражение: ставка за 8h × 3 × 365 × 100.
apr_basisstring—На каком агрегате основано главное значение `apr_pct`.
n_exchangesnumber—Число учтённых бирж.
n_normalizednumber—Биржи, интервал финансирования которых известен и ставки которых удалось привести к 8h.
n_unknown_intervalnumber—Биржи, не учтённые в агрегатах, поскольку их интервал финансирования неизвестен.
settled_cum_7dobject—Сумма фактически рассчитанных ставок финансирования за последние 7 дней, усреднённая по биржам с историей расчётов.
settled_cum_7d.avgnumberfractionПростое среднее по биржам.
settled_cum_7d.oi_weightednumberfractionСреднее, взвешенное по открытому интересу.
settled_cum_7d.nnumber—Биржи с полным окном.
settled_cum_30dobject—То же за 30 дней.
settled_cum_30d.avgnumberfractionПростое среднее по биржам.
settled_cum_30d.oi_weightednumberfractionСреднее, взвешенное по открытому интересу.
settled_cum_30d.nnumber—Биржи с полным окном.
by_exchangearray—Одна строка на биржу: её основной контракт по этой монете (с наибольшим открытым интересом).
by_exchange[]object—Разбивка по биржам.
by_exchange[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
by_exchange[].symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
by_exchange[].marginstring—Класс валюты маржи.
by_exchange[].kindstring—Вид.
by_exchange[].primaryboolean—true для контракта, который представляет биржу в агрегатах.
by_exchange[].ratenumber—Ставка финансирования текущего периода в том виде, в каком её публикует биржа.
by_exchange[].interval_hnumberhИнтервал финансирования.
by_exchange[].rate_8hnumber—Ставка, приведённая к 8-часовому периоду: rate × 8 / interval_h.
by_exchange[].apr_pctnumber% per yearЗначение в процентах годовых.
by_exchange[].next_funding_timenumber|nullmsВремя следующего расчёта.
by_exchange[].next_derivedboolean—true, если время следующего расчёта выведено из интервала, а не опубликовано биржей.
by_exchange[].predicted_ratenull—Ориентировочная ставка следующего периода, если биржа её публикует; иначе null.
by_exchange[].oi_usdnumber|nullUSDОткрытый интерес (номинал в USD).
by_exchange[].updated_atnumbermsВремя последнего обновления этой строки.
by_exchange[].age_snumbersЧисло секунд с последнего обновления этой строки.
by_exchange[].is_staleboolean—true, если строка старше окна актуальности; устаревшие строки в итогах не используются.
by_exchange[].settledobject|null—Записи фактических расчётов по этому контракту; null, если у биржи нет публичной истории.
by_exchange[].settled.last_ratenumber—Ставка последнего расчёта. может отсутствовать
by_exchange[].settled.last_timenumbermsВремя последнего расчёта. может отсутствовать
by_exchange[].settled.interval_hnumberhИнтервал финансирования. может отсутствовать
by_exchange[].settled.cum_7dnumber—Сумма рассчитанных ставок за последние 7 дней. может отсутствовать
by_exchange[].settled.n_7dnumber—Расчёты, найденные за последние 7 дней. может отсутствовать
by_exchange[].settled.n_7d_expectednumber—Число расчётов, ожидаемое за 7 дней при этом интервале. может отсутствовать
by_exchange[].settled.cum_7d_completeboolean—true, если в 7-дневном окне не пропущено ни одного расчёта. может отсутствовать
by_exchange[].settled.cum_30dnumber—Сумма рассчитанных ставок за последние 30 дней. может отсутствовать
by_exchange[].settled.n_30dnumber—Расчёты, найденные за последние 30 дней. может отсутствовать
by_exchange[].settled.n_30d_expectednumber—Число расчётов, ожидаемое за 30 дней при этом интервале. может отсутствовать
by_exchange[].settled.cum_30d_completeboolean—true, если в 30-дневном окне не пропущено ни одного расчёта. может отсутствовать
by_exchange[].settled.history_fromnumbermsСамая ранняя из хранимых записей расчётов по этому контракту. может отсутствовать
other_contractsarray—Другие контракты той же монеты (USDC, с маржой в монете, …). В агрегаты не входят.
other_contracts[]object—Один дополнительный контракт биржи с финансированием (с маржой в монете, в USDC, …), который не является её основным контрактом и исключён из агрегатов.
other_contracts[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
other_contracts[].symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
other_contracts[].marginstring—Класс валюты маржи.
other_contracts[].kindstring—Вид.
other_contracts[].primaryboolean—true для контракта, который представляет биржу в агрегатах.
other_contracts[].ratenumber—Ставка финансирования текущего периода в том виде, в каком её публикует биржа.
other_contracts[].interval_hnumber|nullhИнтервал финансирования.
other_contracts[].rate_8hnumber|null—Ставка, приведённая к 8-часовому периоду: rate × 8 / interval_h.
other_contracts[].apr_pctnumber|null% per yearЗначение в процентах годовых.
other_contracts[].next_funding_timenumber|nullmsВремя следующего расчёта.
other_contracts[].next_derivedboolean—true, если время следующего расчёта выведено из интервала, а не опубликовано биржей.
other_contracts[].predicted_ratenumber|null—Ориентировочная ставка следующего периода, если биржа её публикует; иначе null.
other_contracts[].oi_usdnumber|nullUSDОткрытый интерес (номинал в USD).
other_contracts[].updated_atnumbermsВремя последнего обновления этой строки.
other_contracts[].age_snumbersЧисло секунд с последнего обновления этой строки.
other_contracts[].is_staleboolean—true, если строка старше окна актуальности; устаревшие строки в итогах не используются.
other_contracts[].settledobject|null—Записи фактических расчётов по этому контракту; null, если у биржи нет публичной истории.
other_contracts[].settled.last_ratenumber—Ставка последнего расчёта. может отсутствовать
other_contracts[].settled.last_timenumbermsВремя последнего расчёта. может отсутствовать
other_contracts[].settled.interval_hnumberhИнтервал финансирования. может отсутствовать
other_contracts[].settled.cum_7dnumber—Сумма рассчитанных ставок за последние 7 дней. может отсутствовать
other_contracts[].settled.n_7dnumber—Расчёты, найденные за последние 7 дней. может отсутствовать
other_contracts[].settled.n_7d_expectednumber—Число расчётов, ожидаемое за 7 дней при этом интервале. может отсутствовать
other_contracts[].settled.cum_7d_completeboolean—true, если в 7-дневном окне не пропущено ни одного расчёта. может отсутствовать
other_contracts[].settled.cum_30dnumber—Сумма рассчитанных ставок за последние 30 дней. может отсутствовать
other_contracts[].settled.n_30dnumber—Расчёты, найденные за последние 30 дней. может отсутствовать
other_contracts[].settled.n_30d_expectednumber—Число расчётов, ожидаемое за 30 дней при этом интервале. может отсутствовать
other_contracts[].settled.cum_30d_completeboolean—true, если в 30-дневном окне не пропущено ни одного расчёта. может отсутствовать
other_contracts[].settled.history_fromnumbermsСамая ранняя из хранимых записей расчётов по этому контракту. может отсутствовать
coverageobject—Что входит и что не входит в приведённые выше значения. Сверьтесь с этим блоком, прежде чем сравнивать итоги с другим источником.
coverage.settle_history_exchangesarray—Биржи, по которым собираются записи фактических расчётов.
coverage.settle_history_exchanges[]string—Идентификатор биржи, по которой для этой монеты собираются записи о фактических расчётах финансирования.
coverage.no_settle_historyarray—Биржи без публичного источника истории расчётов; их `settled` равно null.
coverage.no_settle_history[]string—Идентификатор биржи основного контракта, по которому история расчётов не собрана, поэтому его блок `settled` равен null.
coverage.unknown_intervalarray—Строки, для которых не удалось определить интервал финансирования. пусто в образцах, по которым построена таблица
coverage.no_liveness_excludedarray—Строки, исключённые потому, что по контракту нет признаков торгов (нет недавнего тикера, открытого интереса или котировки). пусто в образцах, по которым построена таблица
methodobject—Текстовое описание формул, использованных для этого ответа.
method.ratestring—Ставка финансирования текущего периода в том виде, в каком её публикует биржа.
method.rate_8hstring—Ставка, приведённая к 8-часовому периоду: rate × 8 / interval_h.
method.apr_pctstring% per yearЗначение в процентах годовых.
method.aggregatestring—Агрегат по биржам.
method.settledstring—Записи фактических расчётов по этому контракту; null, если у биржи нет публичной истории.
method.predicted_ratestring—Ориентировочная ставка следующего периода, если биржа её публикует; иначе null.
method.livenessstring—Текстовое правило отсева неактивных контрактов: строка финансирования учитывается, только если есть тикер не старше 1h, открытый интерес не старше 3h или собственная котировка не старше 3h.

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

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

/api/sd/funding?coin=BTC · Реальный ответ, получен 2026-11-13 03:57:42 UTC. Длинные массивы и словари сокращены для отображения: by_exchange: элементов было 23; other_contracts: элементов было 18; coverage.settle_history_exchanges: элементов было 16.

  • {
    • "success": true,
    • "coin": "BTC",
    • "now": 1794542262267,
    • "unit": "fraction",
    • "avg_8h": 0.00006731782608695654,
    • "oi_weighted_8h": 0.00005745116946489526,
    • "apr_pct": 6.2909,
    • "apr_basis": "oi_weighted_8h",
    • "n_exchanges": 23,
    • "n_normalized": 23,
    • "n_unknown_interval": 0,
    • "settled_cum_7d": {
      • "avg": 0.0016089506666666666,
      • "oi_weighted": 0.0015317230977727185,
      • "n": 15
      },
    • "settled_cum_30d": {
      • "avg": 0.0066857086666666675,
      • "oi_weighted": 0.006362887957085279,
      • "n": 15
      },
    • "by_exchange": [
      • { … 17 },
      • { … 17 }
      ],
    • "other_contracts": [
      • { … 17 },
      • { … 17 }
      ],
    • "coverage": {
      • "settle_history_exchanges": [ … 8 ],
      • "no_settle_history": [ … 7 ],
      • "unknown_interval": [],
      • "no_liveness_excluded": []
      },
    • "method": {
      • "rate": "current funding-period rate as published by the exchange (charged at next settlement; may change until then)",
      • "rate_8h": "rate × 8 / interval_h (rows with unknown interval excluded from aggregates)",
      • "apr_pct": "per exchange: rate_8h × 3 × 365 × 100; headline apr_pct = oi_weighted_8h × 3 × 365 × 100 (falls back to avg_8h when no OI weights; see apr_basis). Simple annual…",
      • "aggregate": "one contract per exchange (largest OI); avg_8h = simple mean; oi_weighted_8h = Σ(rate_8h × oi_usd)/Σoi_usd",
      • "settled": "actual settlement records collected from each exchange funding-history endpoint; cum = Σ settled rates in window",
      • "predicted_rate": "exchange-published indicative/next-period rate where available",
      • "liveness": "a funding row is used only if the same contract on the same exchange has a ticker within 1h, open interest within 3h, or a self-collected quote within 3h; rows …"
      }
    }

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

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

ПараметрыHTTPЗадержкаРезультат
coin=ETH20043 msПройдено
coin=SOL20044 msПройдено
coin=ARKM20041 msПройдено
—4001 msПройдено возвращает ожидаемую ошибку

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

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
20s
Пограничный микрокеш
10s
Частота обновления
раз в 60 s для большинства площадок (запись вместе с тикерами; для binance — отдельное задание с периодом 60 s); остальные задания по финансированию и контракты с маржой в монете — раз в 5 min; записи расчётов — ежечасно
Окно
последний снимок (строки финансирования в пределах 4 h по контрактам с действующим тикером / OI); суммы расчётов за 7 d и 30 d
Источники данных
Текущие ставки финансирования, которые собственные коллекторы опрашивают через публичные REST API 24 площадок бессрочных контрактов (например, binance, okx, bybit, bitget, gate, hyperliquid).
Покрытие бирж
24 площадки для текущих ставок; история расчётов — с 16 площадок (бессрочные контракты с маржой в монете на binance, okx, bybit хранятся отдельно)
Единицы измерения
unit = 'fraction' (0.0001 = 0.01%); rate_8h normalized to 8 h; apr_pct in percent; times in Unix ms
Метод расчёта
one contract per exchange (largest OI); rate_8h = rate x 8 / interval_hours; avg_8h = simple mean; oi_weighted_8h = SUM(rate_8h x oi_usd) / SUM(oi_usd); apr_pct = rate_8h x 3 x 365 x 100; settled 7 d / 30 d = SUM of settlement records with a completeness flag (>= 90% of expected settlements)
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный
Доступен с
2026-11-11

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

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

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

string — Coin symbol; 400 when missing. Alias: `base`.

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