GETДоступен
Отчёт CFTC Commitments of Traders
Отчёт CFTC Commitments of Traders (фьючерсы CME на биткоин / эфир)
GET
/api/cftc/cotБолее ранний и более короткий ряд. `/api/sd/cme/cot` содержит полную историю CFTC по классам трейдеров с выбором единицы.
Запрос
Параметры запроса
| Имя | Тип | Обязательный | По умолчанию | Допустимые значения | Описание |
|---|---|---|---|---|---|
| currency | string | Необязательный | BTC | BTC, ETH | Базовый актив; любое значение, кроме ETH, означает BTC. Пример: BTC |
Пример запроса
curl -s "https://www.coinboss.com/api/cftc/cot?currency=BTC"Поля ответа
Таблица полей формируется из реальных ответов, поэтому в ней перечислено ровно то, что возвращает эндпоинт. В путях a[] обозначает элементы массива, а {*} — объекты с динамическим ключом, например монетой или биржей.
| Поле | Тип | Единица | Описание |
|---|---|---|---|
| success | boolean | — | true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`. |
| currency | string | — | Символ валюты / актива. |
| contract | string | — | Название и размер контракта фьючерса CME, которому посвящён отчёт (`CME Bitcoin Futures (5 BTC)` или `CME Ether Futures (50 ETH)`). |
| report_date | string | — | Отчётная дата (YYYY-MM-DD, вторник) последнего отчёта CFTC Commitments of Traders в `series`; отчёт публикуется в следующую пятницу. |
| fetched_at | number | ms | Время, когда CoinBoss получил данные от источника. |
| latest | object | — | Самая последняя запись. |
| latest.date | string | — | Календарная дата (UTC). |
| latest.oi | number | — | Открытый интерес. |
| latest.dealer_long | number | — | Отчёт CFTC: длинные позиции дилеров. |
| latest.dealer_short | number | — | Отчёт CFTC: короткие позиции дилеров. |
| latest.am_long | number | — | Отчёт CFTC: длинные позиции управляющих активами. |
| latest.am_short | number | — | Отчёт CFTC: короткие позиции управляющих активами. |
| latest.lev_long | number | — | Отчёт CFTC: длинные позиции фондов с плечом. |
| latest.lev_short | number | — | Отчёт CFTC: короткие позиции фондов с плечом. |
| latest.other_long | number | — | Отчёт CFTC: длинные позиции прочих отчитывающихся трейдеров. |
| latest.other_short | number | — | Отчёт CFTC: короткие позиции прочих отчитывающихся трейдеров. |
| latest.nonrept_long | number | — | Отчёт CFTC: длинные позиции неотчитывающихся трейдеров. |
| latest.nonrept_short | number | — | Отчёт CFTC: короткие позиции неотчитывающихся трейдеров. |
| latest.traders | number | — | Число трейдеров. |
| prev | object | — | Предыдущее значение (база сравнения). |
| prev.date | string | — | Календарная дата (UTC). |
| prev.oi | number | — | Открытый интерес. |
| prev.dealer_long | number | — | Отчёт CFTC: длинные позиции дилеров. |
| prev.dealer_short | number | — | Отчёт CFTC: короткие позиции дилеров. |
| prev.am_long | number | — | Отчёт CFTC: длинные позиции управляющих активами. |
| prev.am_short | number | — | Отчёт CFTC: короткие позиции управляющих активами. |
| prev.lev_long | number | — | Отчёт CFTC: длинные позиции фондов с плечом. |
| prev.lev_short | number | — | Отчёт CFTC: короткие позиции фондов с плечом. |
| prev.other_long | number | — | Отчёт CFTC: длинные позиции прочих отчитывающихся трейдеров. |
| prev.other_short | number | — | Отчёт CFTC: короткие позиции прочих отчитывающихся трейдеров. |
| prev.nonrept_long | number | — | Отчёт CFTC: длинные позиции неотчитывающихся трейдеров. |
| prev.nonrept_short | number | — | Отчёт CFTC: короткие позиции неотчитывающихся трейдеров. |
| prev.traders | number | — | Число трейдеров. |
| series | array | — | Временной ряд. |
| series[] | object | — | Временной ряд. |
| series[].date | string | — | Календарная дата (UTC). |
| series[].oi | number | — | Открытый интерес. |
| series[].dealer_long | number | — | Отчёт CFTC: длинные позиции дилеров. |
| series[].dealer_short | number | — | Отчёт CFTC: короткие позиции дилеров. |
| series[].am_long | number | — | Отчёт CFTC: длинные позиции управляющих активами. |
| series[].am_short | number | — | Отчёт CFTC: короткие позиции управляющих активами. |
| series[].lev_long | number | — | Отчёт CFTC: длинные позиции фондов с плечом. |
| series[].lev_short | number | — | Отчёт CFTC: короткие позиции фондов с плечом. |
| series[].other_long | number | — | Отчёт CFTC: длинные позиции прочих отчитывающихся трейдеров. |
| series[].other_short | number | — | Отчёт CFTC: короткие позиции прочих отчитывающихся трейдеров. |
| series[].nonrept_long | number | — | Отчёт CFTC: длинные позиции неотчитывающихся трейдеров. |
| series[].nonrept_short | number | — | Отчёт CFTC: короткие позиции неотчитывающихся трейдеров. |
| series[].traders | number | — | Число трейдеров. |
Сформировано 2026-11-11 23:00 UTC; использовано реальных ответов: 1.
Пример ответа
/api/cftc/cot?currency=BTC · Реальный ответ, получен 2026-11-13 03:52:57 UTC. Длинные массивы и словари сокращены для отображения: series: элементов было 448.
- "success"true
- "currency""BTC"
- "contract""CME Bitcoin Futures (5 BTC)"
- "report_date""2026-11-03"
- "fetched_at"1794536904404
- "latest"
- "date""2026-11-03"
- "oi"17527
- "dealer_long"6027
- "dealer_short"5548
- "am_long"4379
- "am_short"1976
- "lev_long"5114
- "lev_short"7705
- "other_long"124
- "other_short"308
- "nonrept_long"762
- "nonrept_short"869
- "traders"105
- "prev"
- "date""2026-10-27"
- "oi"20791
- "dealer_long"6257
- "dealer_short"5001
- "am_long"4743
- "am_short"1989
- "lev_long"5887
- "lev_short"9866
- "other_long"94
- "other_short"285
- "nonrept_long"1002
- "nonrept_short"842
- "traders"106
- "series"
Сведения
- Аутентификация
- Не требуется. Публичный эндпоинт.
- Лимит запросов
- 1200 запросов в минуту на один IP
- Серверный кеш
- 10m
- Пограничный микрокеш
- 10s
- Частота обновления
- при запросе, кеш 6 часов; отчёт еженедельный (позиции на вторник, публикация в пятницу)
- Окно
- полная недельная история
- Источники данных
- Позиции по фьючерсам CME на Bitcoin и Ether по категориям трейдеров из официальных открытых данных CFTC Commitments of Traders.
- Покрытие бирж
- `currency` = BTC (по умолчанию) или ETH; только стандартные контракты CME (микроконтракты не включены); категории: дилеры, управляющие активами, фонды с плечом, прочие отчитывающиеся, неотчитывающиеся.
- Сортировка
- по возрастанию отчётной даты
- Единицы измерения
- contracts (CME Bitcoin = 5 BTC, CME Ether = 50 ETH per contract)
- Метки времени
- Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
- Формат ответа
- json
- Стабильность
- Стабильный
Текущий статус
ДоступенПроверено: 2026-11-13 03:52:57 UTCHTTP 2003 msСхема совпадаетВозраст самой новой точки данных: 10.2d
Доступность за последние 30 дней
Пройдено 100% из 408 проверок
Ошибки
Неудачные вызовы имеют одинаковую структуру на всех эндпоинтах. Полный список приведён на странице ошибок. Ошибки и лимиты запросов →
| Код | 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. | Зависит от сообщения; считайте запрос неудачным. |
Попробовать
GET
/api/cftc/cotДоступенПараметры
string · по умолчанию BTC — Underlying; anything other than ETH is BTC.
URL запроса
https://www.coinboss.com/api/cftc/cot?currency=BTCВыберите эндпоинт и нажмите «Отправить запрос». Здесь появятся ответ, заголовки и время выполнения.
Другие эндпоинты этой категории
- Позиционирование по данным CFTC (криптофьючерсы CME) /api/sd/cme/cot
- Обзор фьючерсов CME /api/sd/cme/overview
- Отчёт CFTC Commitments of Traders /api/cftc/cot