Сводка по разделам сайта
Сводка по разделам сайта (для контентных страниц)
/api/content/summaryЗапрос
У этого эндпоинта нет параметров.
Пример запроса
curl -s "https://www.coinboss.com/api/content/summary"Поля ответа
Таблица полей формируется из реальных ответов, поэтому в ней перечислено ровно то, что возвращает эндпоинт. В путях a[] обозначает элементы массива, а {*} — объекты с динамическим ключом, например монетой или биржей.
| Поле | Тип | Единица | Описание |
|---|---|---|---|
| success | boolean | — | true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`. |
| now | number | ms | Время сервера в момент формирования ответа. |
| exchanges | object | — | Биржи. |
| exchanges.count | number | — | Число элементов. |
| exchanges.total_vol | number | USD | 24h-объём фьючерсов, суммированный по всем биржам, без контрактов, привязанных к акциям. |
| exchanges.total_oi | number | — | Общий открытый интерес. |
| exchanges.total_contracts | number | count | Число тикеров фьючерсных контрактов на всех биржах, без контрактов, привязанных к акциям. |
| exchanges.top3 | array | — | Три первые записи. |
| exchanges.top3[] | object | — | Три первые записи. |
| exchanges.top3[].name | string | — | Название. |
| exchanges.top3[].vol | number | — | Объём. |
| exchanges.top3[].share_pct | number | % | Доля в общем значении. |
| exchanges.dex_share_vol_pct | number | % | Доля `total_vol`, приходящаяся на децентрализованные биржи бессрочных контрактов. |
| exchanges.dex_share_oi_pct | number | % | Доля `total_oi`, приходящаяся на децентрализованные биржи бессрочных контрактов. |
| exchanges.stock_vol_excluded | number | USD | 24h-объём контрактов, привязанных к акциям, не включённый в `total_vol`. |
| funding | object | — | Блок или значение ставки финансирования. |
| funding.weighted_pct | number | % | Текущая ставка финансирования криптовалютных бессрочных контрактов в USDT, взвешенная по открытому интересу, в процентах за интервал финансирования (ставки не приводятся к 8 часам). |
| funding.top_pos | array | — | Три самые высокие текущие ставки финансирования среди бессрочных контрактов в USDT с открытым интересом не менее 300,000 USD. |
| funding.top_pos[] | object | — | Один контракт: `base` (монета), `ex` (отображаемое название биржи) и `rate_pct`. |
| funding.top_pos[].base | string | — | Символ базового актива. |
| funding.top_pos[].ex | string | — | Идентификатор биржи в нижнем регистре. |
| funding.top_pos[].rate_pct | number | % | Текущая ставка финансирования контракта в процентах за его собственный интервал финансирования. |
| funding.top_neg | array | — | Три самые низкие (наиболее отрицательные) текущие ставки финансирования среди бессрочных контрактов в USDT с открытым интересом не менее 300,000 USD. |
| funding.top_neg[] | object | — | Один контракт: `base` (монета), `ex` (отображаемое название биржи) и `rate_pct`. |
| funding.top_neg[].base | string | — | Символ базового актива. |
| funding.top_neg[].ex | string | — | Идентификатор биржи в нижнем регистре. |
| funding.top_neg[].rate_pct | number | % | Текущая ставка финансирования контракта в процентах за его собственный интервал финансирования. |
| funding.intervals | object | — | Интервалы. |
| funding.intervals.h1_pct | number | % | Доля контрактов, по которым расчёт финансирования за последние 24 часа проходил 16 раз или более (относятся к часовым). |
| funding.intervals.h4_pct | number | % | Доля контрактов, по которым расчёт финансирования за последние 24 часа проходил от 5 до 15 раз (относятся к 4-часовым). |
| funding.intervals.h8_pct | number | % | Доля контрактов, по которым расчёт финансирования за последние 24 часа проходил менее 5 раз (относятся к 8-часовым). |
| oi | object | — | Открытый интерес. |
| oi.total | number | — | Всего. |
| oi.chg24_pct | number | % | Изменение суммарного открытого интереса относительно почасового снимка примерно 24 часами ранее по контрактам, присутствующим в обоих; null, если снимка нет. |
| oi.gainers | array | — | Наибольший рост. |
| oi.gainers[] | object | — | Наибольший рост. |
| oi.gainers[].base | string | — | Символ базового актива. |
| oi.gainers[].oi | number | — | Открытый интерес. |
| oi.gainers[].chg_pct | number | % | Изменение в процентах. |
| oi.losers | array | — | Наибольшее падение. |
| oi.losers[] | object | — | Наибольшее падение. |
| oi.losers[].base | string | — | Символ базового актива. |
| oi.losers[].oi | number | — | Открытый интерес. |
| oi.losers[].chg_pct | number | % | Изменение в процентах. |
| oi.top_ex | array | — | Три биржи с наибольшим открытым интересом. |
| oi.top_ex[] | object | — | Одна биржа: `name`, `oi` (USD) и `share_pct` (% от `oi.total`). |
| oi.top_ex[].name | string | — | Название. |
| oi.top_ex[].oi | number | — | Открытый интерес. |
| oi.top_ex[].share_pct | number | % | Доля в общем значении. |
| market | object | — | Рынок. |
| market.total_oi | number | — | Общий открытый интерес. |
| market.liq_total | number | USD | Ликвидации лонгов и шортов в сумме за последние 24 часа, без контрактов, привязанных к акциям. |
| market.liq_long | number | — | Ликвидированные лонги. |
| market.liq_short | number | — | Ликвидированные шорты. |
| market.up_cnt | number | count | Число монет из топ-500 по капитализации, у которых изменение цены за 24h положительное. |
| market.down_cnt | number | count | Число монет из топ-500 по капитализации, у которых изменение цены за 24h отрицательное. |
| market.btc_dom_pct | number | % | Капитализация BTC ÷ общая капитализация отслеживаемых монет × 100; null, если снимок капитализации недоступен. |
| stocks | object | — | Бессрочные контракты, привязанные к акциям, с тикером за последние 12 часов: число базовых активов, контрактов, бирж, 24h-объём и топ-3 базовых актива. |
| stocks.underlyings | number | — | Символы базовых активов. |
| stocks.contracts | number | — | Строки по контрактам. |
| stocks.vol | number | — | Объём. |
| stocks.exchanges | number | — | Биржи. |
| stocks.top3 | array | — | Три первые записи. |
| stocks.top3[] | object | — | Три первые записи. |
| stocks.top3[].u | string | — | Тикер базовой акции или ETF. |
| stocks.top3[].vol | number | — | Объём. |
| preipo | object | — | Базовые активы pre-IPO (синтетические) среди контрактов, привязанных к акциям: количество, 24h-объём, самая высокая цена и самый широкий ценовой спред. |
| preipo.underlyings | number | — | Символы базовых активов. |
| preipo.vol | number | — | Объём. |
| preipo.top_price | object | — | Базовый актив pre-IPO с самой высокой ценой контракта, взвешенной по объёму (`u`, `price`); null, если ни один не торгуется. |
| preipo.top_price.u | string | — | Название этого базового актива. |
| preipo.top_price.price | number | — | Последняя цена в валюте котировки (USD или USDT, если не указано иное). |
| preipo.max_spread | object | — | Базовый актив pre-IPO с самым большим разрывом цен между его контрактами (`u`, `spread_pct`, `pmin`, `pmax`); null, если ни у одного нет двух контрактов. |
| preipo.max_spread.u | string | — | Название этого базового актива. |
| preipo.max_spread.spread_pct | number | % | (`pmax` − `pmin`) ÷ `pmin` × 100. |
| preipo.max_spread.pmin | number | USD | Самая низкая текущая цена контракта на базовый актив среди бирж. |
| preipo.max_spread.pmax | number | USD | Самая высокая текущая цена контракта на базовый актив среди бирж. |
Сформировано 2026-11-11 23:01 UTC; использовано реальных ответов: 1.
Пример ответа
/api/content/summary · Реальный ответ, получен 2026-11-13 03:59:32 UTC. Длинные массивы и словари сокращены для отображения: oi.losers: элементов было 3; oi.top_ex: элементов было 3; oi.gainers: элементов было 3; stocks.top3: элементов было 3; exchanges.top3: элементов было 3; funding.top_neg: элементов было 3.
- "success"true
- "now"1794542372009
- "exchanges"
- "count"25
- "total_vol"176285468302.16
- "total_oi"107132161363.71
- "total_contracts"10843
- "top3"
- "dex_share_vol_pct"8.3
- "dex_share_oi_pct"11.3
- "stock_vol_excluded"41399911752.17
- "funding"
- "weighted_pct"0.0045
- "top_pos"
- "top_neg"
- "intervals"
- "oi"
- "total"107132161363.71
- "chg24_pct"-3.93
- "gainers"
- "losers"
- "top_ex"
- "market"
- "total_oi"107132161363.71
- "liq_total"1363492414.84
- "liq_long"1267532610.54
- "liq_short"95959804.3
- "up_cnt"150
- "down_cnt"327
- "btc_dom_pct"57.4
- "stocks"
- "underlyings"648
- "contracts"2338
- "vol"41305485625.189865
- "exchanges"18
- "top3"
- "preipo"
- "underlyings"3
- "vol"2217117745.7
- "top_price"
- "max_spread"
Сведения
- Аутентификация
- Не требуется. Публичный эндпоинт.
- Лимит запросов
- 1200 запросов в минуту на один IP
- Серверный кеш
- 10m
- Пограничный микрокеш
- 10s
- Частота обновления
- тикеры — раз в 1 min; OI / финансирование — раз в 5 min; кеш API 600 s
- Окно
- 24h
- Источники данных
- Сводные показатели по всему сайту (доли бирж в объёме и OI, экстремумы финансирования, лидеры изменения OI, ликвидации, статистика контрактов на токенизированные акции и pre-IPO), агрегированные самостоятельно из биржевых данных; доминирование BTC и число выросших и упавших монет — от стороннего агрегатора рыночных данных.
- Покрытие бирж
- Все собираемые площадки деривативов; контракты на токенизированные акции исключены из криптовалютных итогов
- Пагинация
- нет
- Единицы измерения
- USD; percentages
- Метод расчёта
- funding.weighted_pct = SUM(rate * oi) / SUM(oi) * 100 over USDT perpetuals refreshed within 3h (not normalized to 8h); oi.chg24_pct compares contracts present both now and 24h ago
- Метки времени
- Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
- Формат ответа
- json
- Стабильность
- Бета
Текущий статус
Доступность за последние 30 дней
Пройдено 99.75% из 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. | Зависит от сообщения; считайте запрос неудачным. |
Попробовать
/api/content/summaryДоступенПараметров нет.
https://www.coinboss.com/api/content/summaryДругие эндпоинты этой категории
- Матрица качества данных (представление коллекторов) /api/sd/quality
- Каталог API /api/meta/catalog
- Журнал изменений и политика версионирования /api/meta/changelog
- Документация эндпоинта /api/meta/endpoint
- Документ OpenAPI /api/meta/openapi
- Матрица качества данных /api/meta/quality
- Статус сервиса /api/meta/status
- Проверка, известен ли платформе символ монеты /api/coin-exists
- Соответствие символа монеты пути к локально размещённой иконке /api/coin-icons
- Агрегированная сводка для страницы монеты /api/content/coin
- Сводка по разделам сайта /api/content/summary
- Таблица курсов фиатных валют /api/currency/fx
- Соответствие идентификатора биржи пути к локально размещённой иконке /api/exchange-icons
- Проверка работоспособности /api/health
- Статистика для страниц исследований /api/research/stats