Объём 24ч—Открытый интерес—Ликвидации 24ч$1.36BЛонг/Шорт 24ч—Доминация BTC—Доминация ETH—

Приложение

Язык ▾

₽ RUB ▾

/api/sd/cme/cot

GETДоступенFRESH

Позиционирование по данным CFTC (криптофьючерсы CME)

Еженедельный ряд отчёта Commitments of Traders по криптофьючерсам CME: лонг-позиции, шорт-позиции, спредовые и чистые позиции дилеров, управляющих активами, фондов с плечом, прочих отчитывающихся и неотчитывающихся участников.

GET/api/sd/cme/cot

Запрос

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

Имя	Тип	Обязательный	По умолчанию	Допустимые значения	Описание
coin	string	Обязательный	—	—	Символ монеты: `BTC`, `ETH`, `SOL` или `XRP`. Пример: BTC
range	string	Необязательный	1y	3m, 6m, 1y, 3y, all	Период выборки; одна точка на еженедельный отчёт.
unit	string	Необязательный	coin	coin, contracts, usd	Единица полей позиций. Для `contracts` требуется `contract`, поскольку контракты разного размера нельзя складывать.
contract	string	Необязательный	—	—	Один продукт CME по монете (например, `BTC` или `MBT`). По умолчанию: все продукты монеты, пересчитанные в монеты и просуммированные.

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

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

Поля ответа

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

Поле	Тип	Единица	Описание
success	boolean	—	true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
schema	string	—	Идентификатор схемы этого ответа. Меняется только тогда, когда у существующего поля меняется смысл или тип.
now	number	ms	Время сервера в момент формирования ответа.
coin	string	—	Символ монеты (в верхнем регистре).
range	string	—	Применённый период выборки.
unit	string	—	Единица полей позиций: `coin`, `contracts` или `usd`.
contract	null	—	Выбранный продукт CME либо `null` для всех продуктов монеты.
report_date	string	—	Отчётная дата отчёта CFTC (обычно вторник).
contracts	array	—	Учтённые продукты CME.
contracts[]	string	—	Учтённые продукты CME.
multipliers	object	—	Число монет на контракт по продуктам (ключ — код продукта). динамические ключи: BTC,MBT
multipliers.{*}	number	—	Число монет на контракт по продуктам (ключ — код продукта).
points	number	—	Точки ряда, от старых к новым.
latest	object	—	Самый последний еженедельный отчёт.
latest.date	string	—	Отчётная дата еженедельного отчёта.
latest.contracts	array	—	Учтённые продукты CME.
latest.contracts[]	string	—	Учтённые продукты CME.
latest.oi	number	—	Общий открытый интерес по отчёту в выбранной единице.
latest.dealer_long	number	—	Длинные позиции дилеров / посредников.
latest.dealer_short	number	—	Короткие позиции дилеров / посредников.
latest.dealer_spread	number	—	Взаимно компенсирующиеся длинные и короткие позиции дилеров; не входят ни в длинные, ни в короткие.
latest.dealer_net	number	—	Дилеры: лонг − шорт.
latest.asset_mgr_long	number	—	Длинные позиции управляющих активами / институциональных инвесторов.
latest.asset_mgr_short	number	—	Короткие позиции управляющих активами / институциональных инвесторов.
latest.asset_mgr_spread	number	—	Взаимно компенсирующиеся позиции управляющих активами; не входят ни в длинные, ни в короткие.
latest.asset_mgr_net	number	—	Управляющие активами: лонг − шорт.
latest.lev_money_long	number	—	Длинные позиции фондов с плечом.
latest.lev_money_short	number	—	Короткие позиции фондов с плечом.
latest.lev_money_spread	number	—	Взаимно компенсирующиеся позиции фондов с плечом; не входят ни в длинные, ни в короткие.
latest.lev_money_net	number	—	Фонды с плечом: лонг − шорт.
latest.other_rept_long	number	—	Длинные позиции прочих отчитывающихся трейдеров.
latest.other_rept_short	number	—	Короткие позиции прочих отчитывающихся трейдеров.
latest.other_rept_spread	number	—	Взаимно компенсирующиеся позиции прочих отчитывающихся трейдеров; не входят ни в длинные, ни в короткие.
latest.other_rept_net	number	—	Прочие отчитывающиеся: лонг − шорт.
latest.nonrept_long	number	—	Длинные позиции неотчитывающихся (мелких) трейдеров.
latest.nonrept_short	number	—	Короткие позиции неотчитывающихся (мелких) трейдеров.
latest.nonrept_net	number	—	Неотчитывающиеся: лонг − шорт.
series	array	—	Недельные точки, от старых к новым.
series[]	object	—	Недельные точки, от старых к новым.
series[].date	string	—	Отчётная дата еженедельного отчёта.
series[].contracts	array	—	Учтённые продукты CME.
series[].contracts[]	string	—	Учтённые продукты CME.
series[].oi	number	—	Общий открытый интерес по отчёту в выбранной единице.
series[].dealer_long	number	—	Длинные позиции дилеров / посредников.
series[].dealer_short	number	—	Короткие позиции дилеров / посредников.
series[].dealer_spread	number	—	Взаимно компенсирующиеся длинные и короткие позиции дилеров; не входят ни в длинные, ни в короткие.
series[].dealer_net	number	—	Дилеры: лонг − шорт.
series[].asset_mgr_long	number	—	Длинные позиции управляющих активами / институциональных инвесторов.
series[].asset_mgr_short	number	—	Короткие позиции управляющих активами / институциональных инвесторов.
series[].asset_mgr_spread	number	—	Взаимно компенсирующиеся позиции управляющих активами; не входят ни в длинные, ни в короткие.
series[].asset_mgr_net	number	—	Управляющие активами: лонг − шорт.
series[].lev_money_long	number	—	Длинные позиции фондов с плечом.
series[].lev_money_short	number	—	Короткие позиции фондов с плечом.
series[].lev_money_spread	number	—	Взаимно компенсирующиеся позиции фондов с плечом; не входят ни в длинные, ни в короткие.
series[].lev_money_net	number	—	Фонды с плечом: лонг − шорт.
series[].other_rept_long	number	—	Длинные позиции прочих отчитывающихся трейдеров.
series[].other_rept_short	number	—	Короткие позиции прочих отчитывающихся трейдеров.
series[].other_rept_spread	number	—	Взаимно компенсирующиеся позиции прочих отчитывающихся трейдеров; не входят ни в длинные, ни в короткие.
series[].other_rept_net	number	—	Прочие отчитывающиеся: лонг − шорт.
series[].nonrept_long	number	—	Длинные позиции неотчитывающихся (мелких) трейдеров.
series[].nonrept_short	number	—	Короткие позиции неотчитывающихся (мелких) трейдеров.
series[].nonrept_net	number	—	Неотчитывающиеся: лонг − шорт.
coverage	object	—	Что входит и что не входит в эти значения. Сверьтесь с этим блоком, прежде чем сравнивать итоги с другим источником.
coverage.included_exchanges	array	—	Источники, актуальные данные которых учтены.
coverage.included_exchanges[]	string	—	Источники, актуальные данные которых учтены.
coverage.unavailable	array	—	Источники, которые не удалось включить, с указанием причины для каждого. Они никогда не учитываются как 0. пусто в образцах, по которым построена таблица
coverage.stale_excluded	array	—	Строки, не учтённые потому, что их последнее обновление выходит за окно актуальности. пусто в образцах, по которым построена таблица
method	object	—	Текстовое описание формул, использованных для этого ответа, по одной записи на поле.
method.value	string	—	Пояснение к формуле для `value`, обычный текст.
method.categories	string	—	Пояснение к формуле для `categories`, обычный текст.
method.identity	string	—	Пояснение к формуле для `identity`, обычный текст.
method.price	string	—	Пояснение к формуле для `price`, обычный текст.
method.is_stale	string	—	Пояснение к формуле для `is_stale`, обычный текст.
meta	object	—	Происхождение данных и актуальность этого ответа.
meta.schema	string	—	Идентификатор схемы этого ответа. Меняется только тогда, когда у существующего поля меняется смысл или тип.
meta.source	array	—	Публичные эндпоинты источников, из которых собраны данные.
meta.source[]	object	—	Публичные эндпоинты источников, из которых собраны данные.
meta.source[].exchange	string	—	Идентификатор биржи (в нижнем регистре).
meta.source[].endpoint	string	—	Публичный эндпоинт источника, который читает коллектор (показан для сведений о происхождении данных; клиенты его не вызывают).
meta.observed_at	number	ms	Метка времени, указанная источником для данных.
meta.received_at	number	ms	Время получения данных коллектором CoinBoss.
meta.fetched_at	number	ms	Время формирования этого ответа.
meta.window	string	—	Временное окно, которое охватывают значения.
meta.quality	string	—	FRESH, PARTIAL, STALE, BROKEN или UNAVAILABLE — оценка по меткам времени данных и покрытию.
meta.is_stale	boolean	—	True, если данные старше своего окна актуальности.
meta.cache_ttl_s	number	s	Время жизни кеша этого ответа.
meta.fallback	string	—	Что возвращает эндпоинт при сбое коллектора или источника.
latest.price	number	USD	Цена, используемая для пересчёта в USD. может отсутствовать
latest.price_src	string	—	Откуда взято значение `price`: расчётная цена ближайшего месяца CME, если она собрана, иначе дневная референсная цена с соответствующей пометкой. может отсутствовать
series[].price	number	USD	Цена, используемая для пересчёта в USD. может отсутствовать
series[].price_src	string	—	Откуда взято значение `price`: расчётная цена ближайшего месяца CME, если она собрана, иначе дневная референсная цена с соответствующей пометкой. может отсутствовать

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

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

/api/sd/cme/cot?coin=BTC · Реальный ответ, получен 2026-11-13 03:58:25 UTC. Длинные массивы и словари сокращены для отображения: series: элементов было 51.

{
- "success": true,
- "schema": "coinboss.sd.cme/1",
- "now": 1794542305751,
- "coin": "BTC",
- "range": "1y",
- "unit": "coin",
- "contract": null,
- "report_date": "2026-11-03",
- "contracts": [
  - "BTC",
  - "MBT"
  ],
- "multipliers": {
  - "BTC": 5,
  - "MBT": 0.1
  },
- "points": 51,
- "latest": {
  - "date": "2026-11-03",
  - "contracts": [ … 2 ],
  - "oi": 89918.8,
  - "dealer_long": 30263.2,
  - "dealer_short": 27953.8,
  - "dealer_spread": 2450,
  - "dealer_net": 2309.4,
  - "asset_mgr_long": 22052.2,
  - "asset_mgr_short": 9925.7,
  - "asset_mgr_spread": 935,
  - "asset_mgr_net": 12126.5,
  - "lev_money_long": 26616.8,
  - "lev_money_short": 40103.2,
  - "lev_money_spread": 2148,
  - "lev_money_net": -13486.4,
  - "other_rept_long": 1111.6,
  - "other_rept_short": 1787.6,
  - "other_rept_spread": 99.6,
  - "other_rept_net": -676,
  - "nonrept_long": 4242.4,
  - "nonrept_short": 4515.9,
  - "nonrept_net": -273.5
  },
- "series": [
  - { … 22 },
  - { … 22 }
  ],
- "coverage": {
  - "included_exchanges": [ … 1 ],
  - "unavailable": [],
  - "stale_excluded": []
  },
- "method": {
  - "value": "CFTC Commitments of Traders, Traders in Financial Futures, futures only. Each series point is one weekly report (as-of Tuesday). unit=coin: contracts x multipli…",
  - "categories": "dealer = Dealer/Intermediary, asset_mgr = Asset Manager/Institutional, lev_money = Leveraged Funds, other_rept = Other Reportables, nonrept = Non-reportable; *_…",
  - "identity": "oi = sum of the four category longs + four category spreads + nonrept_long (and the same on the short side)",
  - "price": "unit=usd only: CME front-month final settlement of the report date when collected, otherwise reference spot price (price_src per point); null price gives null v…",
  - "is_stale": "now is more than 10 days past the scheduled release of the latest stored report (release = report_date + 3 days, 21:30 UTC upper bound for Friday 15:30 ET)"
  },
- "meta": {
  - "schema": "coinboss.sd.cme/1",
  - "source": [ … 1 ],
  - "observed_at": 1793664000000,
  - "received_at": 1794504008901,
  - "fetched_at": 1794542305751,
  - "window": "1y",
  - "quality": "FRESH",
  - "is_stale": false,
  - "cache_ttl_s": 300,
  - "fallback": "on collector failure the last stored weekly report is served with its real report_date; flagged is_stale=true once 10 days have passed since its scheduled relea…"
  }
}

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

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

Параметры	HTTP	Задержка	Результат
coin=ETH&unit=usd	200	7 ms	Пройдено PARTIAL
coin=BTC&range=all	200	15 ms	Пройдено FRESH
coin=BTC&unit=contracts	400	1 ms	Пройдено возвращает ожидаемую ошибку

Проверено: 2026-11-13 03:58:25 UTC

Сведения

Аутентификация: Не требуется. Публичный эндпоинт.
Лимит запросов: 1200 запросов в минуту на один IP
Серверный кеш: 5m
Пограничный микрокеш: 10s
Частота обновления: Еженедельно. Отчётная дата обычно приходится на вторник, а CFTC публикует отчёт в пятницу; коллектор выполняет проверку три раза в сутки.
Окно: 3m / 6m / 1y / 3y / all, недельные точки.
Источники данных: Отчёт CFTC Commitments of Traders, раздел Traders in Financial Futures (только фьючерсы); данные собирает и хранит CoinBoss (sd_cme_cot_weekly).
Покрытие бирж: BTC — с 2018-04-10, ETH — с 2021-04-06; SOL и XRP — с момента их листинга на CME. Неделя, в отчёте за которую отсутствует один из продуктов монеты, помечается PARTIAL.
Пагинация: Пагинации нет; `range` ограничивает число точек.
Сортировка: По возрастанию отчётной даты.
Единицы измерения: Positions in coin by default (contracts × multiplier), or in contracts / USD with `unit`. With `unit=usd` each point carries the reference `price` and `price_src` used.
Метод расчёта: net = long − short for every trader class. `*_spread` is the offsetting long-and-short position held by the same trader and is not included in long or short. Identity: Σ long + Σ spread + non-reportable long = open interest (and the same on the short side).
Метки времени: Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа: json
Стабильность: Стабильный
Доступен с: 2026-11-11

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

ДоступенПроверено: 2026-11-13 03:58:25 UTCHTTP 2005 msСхема совпадаетВозраст самой новой точки данных: 10.6h

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

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

Ошибки

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

Код	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/sd/cme/cotДоступен

Параметры

coin Обязательный

string — Coin symbol: `BTC`, `ETH`, `SOL` or `XRP`.

range

string · по умолчанию 1y — Look-back range; one point per weekly report.

unit

string · по умолчанию coin — Unit of the position fields. `contracts` requires `contract`, because contracts of different size cannot be added.

contract

string — One CME product of the coin (for example `BTC` or `MBT`). Default: all products of the coin, converted to coin and summed.

URL запросаhttps://www.coinboss.com/api/sd/cme/cot?coin=BTC

Выберите эндпоинт и нажмите «Отправить запрос». Здесь появятся ответ, заголовки и время выполнения.

Позиционирование по данным CFTC (криптофьючерсы CME) /api/sd/cme/cot
Обзор фьючерсов CME /api/sd/cme/overview
Отчёт CFTC Commitments of Traders /api/cftc/cot