Макрокарточки главной страницы
Макрокарточки главной страницы (фондовые индексы, доллар, золото и др.)
/api/home/macro-cardsЗапрос
У этого эндпоинта нет параметров.
Пример запроса
curl -s "https://www.coinboss.com/api/home/macro-cards"Поля ответа
Таблица полей формируется из реальных ответов, поэтому в ней перечислено ровно то, что возвращает эндпоинт. В путях a[] обозначает элементы массива, а {*} — объекты с динамическим ключом, например монетой или биржей.
| Поле | Тип | Единица | Описание |
|---|---|---|---|
| success | boolean | — | true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`. |
| updated_at | number | ms | Время последнего обновления этой строки. |
| mcap | object | — | Рыночная капитализация. |
| mcap.latest | number | — | Самая последняя запись. |
| mcap.date | string | — | Календарная дата (UTC). |
| mcap.chg24h_pct | number | % | Изменение за 24h в процентах. |
| mcap.spark | array | — | Короткие недавние ряды для спарклайнов. |
| mcap.spark[] | number | — | Короткие недавние ряды для спарклайнов. |
| mcap.has_cmc | boolean | — | true, если хотя бы одна точка `spark` взята из дозаполненной сторонней истории, а не из собственных дневных снимков сайта. |
| volume | object | — | Объём. |
| volume.futures | number | — | Блок или значение фьючерсного рынка. |
| volume.spot | number | — | Блок или значение спотового рынка. |
| volume.ts | number | ms | Метка времени. |
| volume.spark | array | — | Короткие недавние ряды для спарклайнов. |
| volume.spark[] | object | — | Короткие недавние ряды для спарклайнов. |
| volume.spark[].t | number | ms | Метка времени. |
| volume.spark[].f | number | USD | Среднее показаний 24h-объёма фьючерсов внутри этого 3-часового интервала. |
| volume.spark[].s | number | USD | Среднее показаний 24h-объёма спота внутри этого 3-часового интервала. |
| btc_candles | array | — | Свечи BTC для наложения. |
| btc_candles[] | array | — | Свечи BTC для наложения. |
| btc_candles[][] | number | — | Свечи BTC для наложения. |
| fng | object | — | Карточка индекса страха и жадности: последнее значение `value`, его метка `cls` и `spark` из недавних дневных значений; null, если данных нет. |
| fng.value | number | — | Значение. |
| fng.cls | string | — | Текстовая метка последнего значения индекса страха и жадности, например `Fear` или `Greed`. |
| fng.spark | array | — | Короткие недавние ряды для спарклайнов. |
| fng.spark[] | number | — | Короткие недавние ряды для спарклайнов. |
| stablecoin | object | — | Карточка стейблкоинов: общая стоимость в обращении в USD (`total`), число стейблкоинов (`count`) и её изменение за 24h и 7d. |
| stablecoin.total | number | — | Всего. |
| stablecoin.count | number | — | Число элементов. |
| stablecoin.chg24h_pct | number | % | Изменение за 24h в процентах. |
| stablecoin.chg7d_pct | number | % | Изменение за 7 дней в процентах. |
| liq | object | — | Значение или блок ликвидаций. |
| liq.total | number | — | Всего. |
| liq.long | number | — | Значение стороны лонг. |
| liq.short | number | — | Значение стороны шорт. |
| liq.chg24h_pct | number | % | Изменение за 24h в процентах. |
| liq.spark | array | — | Короткие недавние ряды для спарклайнов. |
| liq.spark[] | number | — | Короткие недавние ряды для спарклайнов. |
Сформировано 2026-11-11 23:01 UTC; использовано реальных ответов: 1.
Пример ответа
/api/home/macro-cards · Реальный ответ, получен 2026-11-13 03:59:25 UTC. Длинные массивы и словари сокращены для отображения: fng.spark: элементов было 30; liq.spark: элементов было 57; mcap.spark: элементов было 90; btc_candles: элементов было 42; volume.spark: элементов было 57.
- "success"true
- "updated_at"1794542365066
- "mcap"
- "latest"2476085584564.88
- "date""2026-11-13"
- "chg24h_pct"-3.19
- "spark"
- "has_cmc"false
- "volume"
- "futures"216570771117.84
- "spot"66073226871.26
- "ts"1794541800000
- "spark"
- "btc_candles"
- "fng"
- "value"20
- "cls""Extreme Fear"
- "spark"
- "stablecoin"
- "total"288099833329.21
- "count"353
- "chg24h_pct"-0.53
- "chg7d_pct"-1.71
- "liq"
- "total"1363532410.6799946
- "long"1267567542.2399952
- "short"95964868.44
- "chg24h_pct"501.86
- "spark"
Сведения
- Аутентификация
- Не требуется. Публичный эндпоинт.
- Лимит запросов
- 1200 запросов в минуту на один IP
- Серверный кеш
- 2m
- Пограничный микрокеш
- 10s
- Частота обновления
- капитализация — ежедневно; объём — раз в 10 min; свечи — раз в 5 min; индекс страха и жадности — ежедневно; стейблкоины — раз в 10 min; кеш API 120 s
- Окно
- капитализация — 90 дней; объём — 7 дней; свечи BTC 4h; индекс страха и жадности — 30 дней; ликвидации — 24h
- Источники данных
- Макрокарточки главной страницы: общая капитализация рынка (дневной снимок капитализаций стороннего агрегатора рыночных данных), фьючерсный объём и ликвидации (биржевые данные), свечи BTC (Binance), индекс страха и жадности (alternative.me) и предложение стейблкоинов (сторонний источник).
- Покрытие бирж
- По всему рынку
- Пагинация
- нет
- Единицы измерения
- USD; changes in percent; Fear & Greed 0-100
- Метки времени
- Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
- Формат ответа
- json
- Стабильность
- Бета
Текущий статус
Доступность за последние 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. | Зависит от сообщения; считайте запрос неудачным. |
Попробовать
/api/home/macro-cardsДоступенПараметров нет.
https://www.coinboss.com/api/home/macro-cardsДругие эндпоинты этой категории
- Глобальные метрики деривативов /api/derivatives/global
- Пакет карточек индикаторов для главной страницы /api/home/indicator-cards
- Макрокарточки главной страницы /api/home/macro-cards
- Месячный спотовый объём BTC /api/indicators/cm/btc-spot-vol-monthly
- Месячный спотовый объём криптовалют /api/indicators/cm/crypto-spot-vol-monthly
- История общей капитализации крипторынка и капитализации основных монет /api/indicators/marketcap
- Капитализация крипторынка по типам активов /api/indicators/marketcap-type
- Агрегаты для бегущей строки главной страницы /api/market/home-ticker
- Обзор рынка деривативов /api/market/overview
- Дневное соотношение объёма бессрочных контрактов и спота /api/p3/perp-spot-ratio
- Объём бессрочных контрактов и спота /api/p3/perp-spot-volume
- Временной ряд объёма по всему рынку /api/p3/volume/history
- Обзор объёма /api/p3/volume/overview
- История общей капитализации стейблкоинов /api/stablecoins/chart
- Список стейблкоинов /api/stablecoins/list
- История доминирования BTC /api/volume/btc-dominance-series
- История глобального объёма спота / деривативов /api/volume/global-history