GETЧастичноPARTIAL
Обзор фьючерсов CME
Открытый интерес и дневной объём CME по одной монете в разбивке по продуктам (стандартные и микроконтракты) с пересчётом в монеты и в номинал в USD, а также последняя сводка позиционирования CFTC.
GET
/api/sd/cme/overviewЧастичное покрытие. Открытый интерес и объём в контрактах и в монетах — это данные биржи. Для номинала в USD сейчас используется дневная референсная цена с пометкой (`price_src`), поскольку официальная расчётная цена CME пока не собирается; этот пробел указан в `coverage.unavailable`, и по этой причине ответ помечается PARTIAL.
Запрос
Параметры запроса
| Имя | Тип | Обязательный | По умолчанию | Допустимые значения | Описание |
|---|---|---|---|---|---|
| coin | string | Обязательный | — | — | Символ монеты. Продукты CME есть у `BTC`, `ETH`, `SOL` и `XRP`; для других допустимых символов возвращается 200 с `meta.quality = "UNAVAILABLE"`. Пример: BTC |
Пример запроса
curl -s "https://www.coinboss.com/api/sd/cme/overview?coin=BTC"Поля ответа
Таблица полей формируется из реальных ответов, поэтому в ней перечислено ровно то, что возвращает эндпоинт. В путях a[] обозначает элементы массива, а {*} — объекты с динамическим ключом, например монетой или биржей.
| Поле | Тип | Единица | Описание |
|---|---|---|---|
| success | boolean | — | true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`. |
| schema | string | — | Идентификатор схемы этого ответа. Меняется только тогда, когда у существующего поля меняется смысл или тип. |
| now | number | ms | Время сервера в момент формирования ответа. |
| coin | string | — | Символ монеты (в верхнем регистре). |
| trade_date | string|null | — | Торговая дата CME, к которой относятся значения. |
| oi_contracts | object|null | — | Открытый интерес в контрактах, односторонний. динамические ключи: BTC,MBT |
| oi_contracts.{*} | number | contracts | Открытый интерес в контрактах, односторонний. |
| oi_coin | number|null | coin | Открытый интерес в монетах: число контрактов × множитель контракта. |
| oi_usd | number|null | USD | Открытый интерес как номинал в USD: количество монет × `price`. |
| volume_contracts | object|null | — | Общий объём за торговую дату в контрактах (электронные торги, торговый зал и внебиржевые сделки). динамические ключи: BTC,MBT |
| volume_contracts.{*} | number | contracts | Общий объём за торговую дату в контрактах (электронные торги, торговый зал и внебиржевые сделки). |
| volume_coin | number|null | coin | Объём в монетах: число контрактов × множитель контракта. |
| volume_usd | number|null | USD | Объём как номинал в USD: количество монет × `price`. |
| price | number|null | USD | Цена, используемая для пересчёта в USD. |
| price_src | string|null | — | Откуда взято значение `price`: расчётная цена ближайшего месяца CME, если она собрана, иначе дневная референсная цена с соответствующей пометкой. |
| products | array|null | — | Одна строка на каждый продукт CME по монете. |
| products[] | object | — | Одна строка на каждый продукт CME по монете. |
| products[].product | string | — | Код продукта CME. |
| products[].name | string | — | Название продукта CME. |
| products[].multiplier | number | coin | Число монет на контракт. |
| products[].oi_contracts | number | contracts | Открытый интерес в контрактах, односторонний. |
| products[].oi_coin | number | coin | Открытый интерес в монетах: число контрактов × множитель контракта. |
| products[].oi_usd | number | USD | Открытый интерес как номинал в USD: количество монет × `price`. |
| products[].volume_contracts | number | contracts | Общий объём за торговую дату в контрактах (электронные торги, торговый зал и внебиржевые сделки). |
| products[].globex_volume_contracts | number | contracts | Электронная часть объёма (Globex). |
| products[].volume_coin | number | coin | Объём в монетах: число контрактов × множитель контракта. |
| products[].volume_usd | number | USD | Объём как номинал в USD: количество монет × `price`. |
| products[].settle | null | USD | Расчётная цена ближайшего месяца; `null`, пока она не собирается. |
| products[].settle_month | null | — | Контрактный месяц расчётной цены. |
| products[].settle_src | null | — | Источник расчётной цены. |
| cot | object|null | — | Сводка последнего отчёта CFTC Commitments of Traders по монете. |
| cot.report_date | string | — | Отчётная дата отчёта CFTC (обычно вторник). |
| cot.is_stale | boolean | — | True, если данные старше своего окна актуальности. |
| cot.contracts | array | — | Учтённые продукты CME. |
| cot.contracts[] | string | — | Учтённые продукты CME. |
| cot.unit | string | — | Единица полей позиций: `coin`, `contracts` или `usd`. |
| cot.oi_contracts | object | — | Открытый интерес в контрактах, односторонний. динамические ключи: BTC,MBT |
| cot.oi_contracts.{*} | number | contracts | Открытый интерес в контрактах, односторонний. |
| cot.oi_coin | number | coin | Открытый интерес в монетах: число контрактов × множитель контракта. |
| cot.dealer_net | number | — | Дилеры: лонг − шорт. |
| cot.asset_mgr_net | number | — | Управляющие активами: лонг − шорт. |
| cot.lev_money_net | number | — | Фонды с плечом: лонг − шорт. |
| cot.other_rept_net | number | — | Прочие отчитывающиеся: лонг − шорт. |
| cot.nonrept_net | number | — | Неотчитывающиеся: лонг − шорт. |
| coverage | object | — | Что входит и что не входит в эти значения. Сверьтесь с этим блоком, прежде чем сравнивать итоги с другим источником. |
| coverage.included_exchanges | array | — | Источники, актуальные данные которых учтены. |
| coverage.included_exchanges[] | string | — | Источники, актуальные данные которых учтены. |
| coverage.unavailable | array | — | Источники, которые не удалось включить, с указанием причины для каждого. Они никогда не учитываются как 0. |
| coverage.unavailable[] | object | — | Источники, которые не удалось включить, с указанием причины для каждого. Они никогда не учитываются как 0. |
| coverage.unavailable[].exchange | string | — | Идентификатор биржи (в нижнем регистре). |
| coverage.unavailable[].field | string | — | Отсутствующее поле. может отсутствовать |
| coverage.unavailable[].reason | string | — | Машиночитаемый код причины. |
| coverage.unavailable[].detail | string | — | Понятное человеку объяснение причины. |
| coverage.stale_excluded | array | — | Строки, не учтённые потому, что их последнее обновление выходит за окно актуальности. пусто в образцах, по которым построена таблица |
| method | object | — | Текстовое описание формул, использованных для этого ответа, по одной записи на поле. |
| method.oi_contracts | string | — | Пояснение к формуле для `oi_contracts`, обычный текст. |
| method.oi_coin | string | — | Пояснение к формуле для `oi_coin`, обычный текст. |
| method.oi_usd | string | — | Пояснение к формуле для `oi_usd`, обычный текст. |
| method.volume_contracts | string | — | Пояснение к формуле для `volume_contracts`, обычный текст. |
| method.volume_usd | string | — | Пояснение к формуле для `volume_usd`, обычный текст. |
| method.is_stale | string | — | Пояснение к формуле для `is_stale`, обычный текст. |
| method.cot | string | — | Пояснение к формуле для `cot`, обычный текст. |
| meta | object | — | Происхождение данных и актуальность этого ответа. |
| meta.schema | string | — | Идентификатор схемы этого ответа. Меняется только тогда, когда у существующего поля меняется смысл или тип. |
| meta.source | array | — | Публичные эндпоинты источников, из которых собраны данные. |
| meta.source[] | object | — | Публичные эндпоинты источников, из которых собраны данные. |
| meta.source[].exchange | string | — | Идентификатор биржи (в нижнем регистре). |
| meta.source[].endpoint | string | — | Публичный эндпоинт источника, который читает коллектор (показан для сведений о происхождении данных; клиенты его не вызывают). |
| meta.observed_at | number|null | ms | Метка времени, указанная источником для данных. |
| meta.received_at | number|null | 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 | — | Что возвращает эндпоинт при сбое коллектора или источника. |
Сформировано 2026-11-11 23:00 UTC; использовано реальных ответов: 4.
Пример ответа
/api/sd/cme/overview?coin=BTC · Реальный ответ, получен 2026-11-13 03:58:26 UTC. Длинные массивы и словари сокращены для отображения: meta.source: элементов было 3.
- "success"true
- "schema""coinboss.sd.cme/1"
- "now"1794542306145
- "coin""BTC"
- "trade_date""2026-11-11"
- "oi_contracts"
- "BTC"19533
- "MBT"24382
- "oi_coin"100103.2
- "oi_usd"7409157367.61
- "volume_contracts"
- "BTC"8985
- "MBT"35304
- "volume_coin"48455.4
- "volume_usd"3586435637.53
- "price"74015.19
- "price_src""ref_binance_1d_close"
- "products"
- "cot"
- "report_date""2026-11-03"
- "is_stale"false
- "contracts"
- "unit""coin"
- "oi_contracts"
- "oi_coin"89918.8
- "dealer_net"2309.4
- "asset_mgr_net"12126.5
- "lev_money_net"-13486.4
- "other_rept_net"-676
- "nonrept_net"-273.5
- "coverage"
- "included_exchanges"
- "unavailable"
- "stale_excluded"
- "method"
- "oi_contracts""open interest in contracts (one-sided) per CME product, from the CME daily volume & open interest report"
- "oi_coin""sum over products of oi_contracts x contract multiplier (BTC 5, MBT 0.1, ETH 50, MET 0.1, SOL 500, MSL 25, XRP 50000, MXP 2500 coins per contract)"
- "oi_usd""oi_coin x price; price = CME front-month final settlement price when collected (price_src=cme_settle_front_month), otherwise a reference spot price for the same…"
- "volume_contracts""CME total volume for the trade date in contracts (Globex + pit + ex-pit + OTC/cleared); globex_volume_contracts is the Globex part"
- "volume_usd""volume in coins (contracts x multiplier) x the same price as oi_usd"
- "is_stale""trade_date 22:00 UTC is more than 120h old"
- "cot""latest CFTC Commitments of Traders (TFF, futures only) row(s) for the coin: positions converted to coins with the contract multiplier; net = long - short"
- "meta"
- "schema""coinboss.sd.cme/1"
- "source"
- "observed_at"1794434400000
- "received_at"1794504014502
- "fetched_at"1794542306145
- "window""latest"
- "quality""PARTIAL"
- "is_stale"false
- "cache_ttl_s"300
- "fallback""on collector failure the last stored CME trade date is served with its real trade_date; it is flagged is_stale=true once older than 120h; nothing is interpolate…"
Проверенные образцы
Помимо примера выше, автопроверка вызывает этот эндпоинт с указанными параметрами и каждый раз сверяет схему.
| Параметры | HTTP | Задержка | Результат |
|---|---|---|---|
| coin=ETH | 200 | 5 ms | Пройдено PARTIAL |
| coin=XRP | 200 | 5 ms | Пройдено PARTIAL |
| coin=PEPE | 200 | 2 ms | Пройдено UNAVAILABLE |
| — | 400 | 1 ms | Пройдено возвращает ожидаемую ошибку |
Проверено: 2026-11-13 03:58:26 UTC
Сведения
- Аутентификация
- Не требуется. Публичный эндпоинт.
- Лимит запросов
- 1200 запросов в минуту на один IP
- Серверный кеш
- 5m
- Пограничный микрокеш
- 10s
- Частота обновления
- CME публикует данные один раз за торговый день; коллектор запускается три раза в сутки (04:20, 11:20, 17:20 UTC).
- Окно
- Последняя торговая дата CME (`trade_date`).
- Источники данных
- Файлы ежедневного бюллетеня CME Group об объёме и открытом интересе; отчёт CFTC Commitments of Traders (Traders in Financial Futures, только фьючерсы). Данные собирает и хранит CoinBoss (sd_cme_daily, sd_cme_cot_weekly).
- Покрытие бирж
- Восемь продуктов CME: BTC, MBT, ETH, MET, SOL, MSL, XRP, MXP. Открытый интерес односторонний, в контрактах.
- Единицы измерения
- Contracts are single-sided. Coin = contracts × contract multiplier (BTC 5, MBT 0.1, ETH 50, MET 0.1, SOL 500, MSL 25, XRP 50,000, MXP 2,500). USD notional = coin × `price`.
- Метод расчёта
- oi_coin = Σ over products (open interest in contracts × multiplier); oi_usd = oi_coin × price. Volume is total daily volume (electronic, floor and off-exchange).
- Метки времени
- Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
- Формат ответа
- json
- Стабильность
- Стабильный
- Доступен с
- 2026-11-11
Текущий статус
ЧастичноПроверено: 2026-11-13 03:58:26 UTCHTTP 2005 msСхема совпадаетВозраст самой новой точки данных: 10.6h
Эндпоинт сообщает качество данных PARTIAL — Открытый интерес и объём в контрактах и в монетах — это данные биржи. Для номинала в USD сейчас используется дневная референсная цена с пометкой (`price_src`), поскольку официальная расчётная цена CME пока не собирается; этот пробел указан в `coverage.unavailable`, и по этой причине ответ помечается PARTIAL.
Доступность за последние 30 дней
Пройдено 99.75% из 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/overviewЧастичноПараметры
string — Coin symbol. `BTC`, `ETH`, `SOL` and `XRP` have CME products; other valid symbols return 200 with `meta.quality = "UNAVAILABLE"`.
URL запроса
https://www.coinboss.com/api/sd/cme/overview?coin=BTCВыберите эндпоинт и нажмите «Отправить запрос». Здесь появятся ответ, заголовки и время выполнения.
Другие эндпоинты этой категории
- Позиционирование по данным CFTC (криптофьючерсы CME) /api/sd/cme/cot
- Обзор фьючерсов CME /api/sd/cme/overview
- Отчёт CFTC Commitments of Traders /api/cftc/cot