/api/home/macro-cards
GETДоступенБета

Макрокарточки главной страницы

Макрокарточки главной страницы (фондовые индексы, доллар, золото и др.)

GET/api/home/macro-cards

Запрос

У этого эндпоинта нет параметров.

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

curl -s "https://www.coinboss.com/api/home/macro-cards"

Поля ответа

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

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
updated_atnumbermsВремя последнего обновления этой строки.
mcapobject—Рыночная капитализация.
mcap.latestnumber—Самая последняя запись.
mcap.datestring—Календарная дата (UTC).
mcap.chg24h_pctnumber%Изменение за 24h в процентах.
mcap.sparkarray—Короткие недавние ряды для спарклайнов.
mcap.spark[]number—Короткие недавние ряды для спарклайнов.
mcap.has_cmcboolean—true, если хотя бы одна точка `spark` взята из дозаполненной сторонней истории, а не из собственных дневных снимков сайта.
volumeobject—Объём.
volume.futuresnumber—Блок или значение фьючерсного рынка.
volume.spotnumber—Блок или значение спотового рынка.
volume.tsnumbermsМетка времени.
volume.sparkarray—Короткие недавние ряды для спарклайнов.
volume.spark[]object—Короткие недавние ряды для спарклайнов.
volume.spark[].tnumbermsМетка времени.
volume.spark[].fnumberUSDСреднее показаний 24h-объёма фьючерсов внутри этого 3-часового интервала.
volume.spark[].snumberUSDСреднее показаний 24h-объёма спота внутри этого 3-часового интервала.
btc_candlesarray—Свечи BTC для наложения.
btc_candles[]array—Свечи BTC для наложения.
btc_candles[][]number—Свечи BTC для наложения.
fngobject—Карточка индекса страха и жадности: последнее значение `value`, его метка `cls` и `spark` из недавних дневных значений; null, если данных нет.
fng.valuenumber—Значение.
fng.clsstring—Текстовая метка последнего значения индекса страха и жадности, например `Fear` или `Greed`.
fng.sparkarray—Короткие недавние ряды для спарклайнов.
fng.spark[]number—Короткие недавние ряды для спарклайнов.
stablecoinobject—Карточка стейблкоинов: общая стоимость в обращении в USD (`total`), число стейблкоинов (`count`) и её изменение за 24h и 7d.
stablecoin.totalnumber—Всего.
stablecoin.countnumber—Число элементов.
stablecoin.chg24h_pctnumber%Изменение за 24h в процентах.
stablecoin.chg7d_pctnumber%Изменение за 7 дней в процентах.
liqobject—Значение или блок ликвидаций.
liq.totalnumber—Всего.
liq.longnumber—Значение стороны лонг.
liq.shortnumber—Значение стороны шорт.
liq.chg24h_pctnumber%Изменение за 24h в процентах.
liq.sparkarray—Короткие недавние ряды для спарклайнов.
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": [ … 8 ],
      • "has_cmc": false
      },
    • "volume": {
      • "futures": 216570771117.84,
      • "spot": 66073226871.26,
      • "ts": 1794541800000,
      • "spark": [ … 2 ]
      },
    • "btc_candles": [
      • [ … 5 ],
      • [ … 5 ]
      ],
    • "fng": {
      • "value": 20,
      • "cls": "Extreme Fear",
      • "spark": [ … 8 ]
      },
    • "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": [ … 8 ]
      }
    }

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
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
Стабильность
Бета

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

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

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

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

Ошибки

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

КодHTTPЗначениеЧто делать
INVALID_PARAM400Отсутствует обязательный параметр, или значение не принимается. `param` называет параметр, если он известен.Не повторяйте запрос без изменений; исправьте его.
UNAUTHORIZED401Заголовок `CB-API-KEY` был отправлен, но ключ неизвестен или отозван. Для публичных данных ключ не нужен — уберите заголовок или используйте действительный ключ.Не повторяйте запрос без изменений.
FORBIDDEN403Маршрут не входит в публичный API (внутренний или только для аккаунта).Не повторяйте запрос.
NOT_FOUND404Неизвестный маршрут, либо запрошенная монета / биржа / фонд не существует.Не повторяйте запрос; сверьте путь и идентификаторы с каталогом.
RATE_LIMITED429Запросов больше, чем позволяет поминутный лимит. `Retry-After` указывает, сколько секунд нужно подождать.Дождитесь истечения `Retry-After`, затем повторите запрос с нарастающей задержкой.
INTERNAL500Непредвиденная ошибка сервера. Сообщение намеренно общее; при обращении указывайте `request_id`.Повторите запрос один раз через несколько секунд; если ошибка сохраняется, сообщите о ней, указав ID запроса.
UPSTREAM_FAILED503Источник данных, стоящий за этим эндпоинтом, не ответил вовремя. Устаревшие или подменные значения вместо него не возвращаются.Повторите запрос с нарастающей задержкой; проверьте страницу статуса.
UNAVAILABLE501 / 503Набор данных временно не готов (прогрев кеша), либо у эндпоинта пока нет законного публичного источника.Повторите запрос позже; каталог помечает эндпоинты, недоступные по проектному решению.
REQUEST_FAILED200Некоторые более старые эндпоинты отвечают HTTP 200 с `success: false`. Всегда проверяйте `success`, а не только статус HTTP.Зависит от сообщения; считайте запрос неудачным.

Попробовать

GET/api/home/macro-cardsДоступен
Параметры

Параметров нет.

URL запросаhttps://www.coinboss.com/api/home/macro-cards
Выберите эндпоинт и нажмите «Отправить запрос». Здесь появятся ответ, заголовки и время выполнения.