Объём 24ч—Открытый интерес—Ликвидации 24ч$1.36BЛонг/Шорт 24ч—Доминация BTC—Доминация ETH—
Приложение
Язык ▾
₽ RUB ▾
/api/rich-list/:chain/stat
GETДеградация

Статистика богатейших адресов в нескольких блокчейнах

Статистика богатейших адресов в нескольких блокчейнах

GET/api/rich-list/:chain/stat
Частичное покрытие. Источник рейтинга адресов перестал обновляться; возвращается последний снимок с его исходной меткой времени. Считайте данные историческими, пока метка времени снова не начнёт меняться.
Деградация. Возраст самой новой точки данных: 6145155 s (ожидается не более 259200 s)

Запрос

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

ИмяТипОбязательныйПо умолчаниюДопустимые значенияОписание
chain pathstringОбязательный—eth, tron, bsc, polygon, arbitrum, doge, ltc, dash, aptos, bch, avalanche, optimism, base, tonИдентификатор сети; 400, если не поддерживается. Пример: eth

Параметры с пометкой «path» являются частью URL.

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

curl -s "https://www.coinboss.com/api/rich-list/eth/stat"

Поля ответа

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

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
chainstring—Идентификатор сети.
availableboolean—Доступны ли данные.
unitstring—Единица значений в этом объекте.
snapshot_atnumbermsВремя снимка.
pricenumber—Последняя цена в валюте котировки (USD или USDT, если не указано иное).
dataarray—Полезные данные.
data[]object—Полезные данные.
data[].range_fromnumber—Первый ранг группы (адреса ранжированы по балансу, 1 = крупнейший).
data[].range_tonumber—Последний ранг группы; −1 обозначает открытую группу всех остальных адресов.
data[].address_countnumbercountЧисло адресов в группе; −1, если источник не даёт числа (открытая группа).
data[].holders_valuenumbercoinКоличество нативной монеты сети на адресах группы; 0 в открытой группе означает, что значение не опубликовано.
data[].holders_usdnumberUSD`holders_value` × цена монеты; null, если цена недоступна.
data[].percent_ratenumberfractionДоля предложения монеты, принадлежащая группе, в долях (0.13 = 13 %).

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

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

/api/rich-list/eth/stat · Реальный ответ, получен 2026-11-13 03:59:24 UTC. Длинные массивы и словари сокращены для отображения: data: элементов было 5.

  • {
    • "success": true,
    • "chain": "eth",
    • "available": true,
    • "unit": "ETH",
    • "snapshot_at": 1788397209000,
    • "price": 1941.76,
    • "data": [
      • { … 6 },
      • { … 6 }
      ]
    }

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
5m
Пограничный микрокеш
10s
Частота обновления
запланировано раз в 20 min, но примерно с 2026-09-03 каждый запуск завершается сбоем
Окно
последний сохранённый снимок (застыл примерно на 2026-09-03)
Источники данных
Распределение адресов по диапазонам баланса по сетям из источника, сбор с которого прекращён; больше не обновляется.
Покрытие бирж
Сети: eth, tron, bsc, polygon, arbitrum, doge, ltc, dash, aptos, bch, avalanche, optimism, base, ton; `available: false`, если у сети нет снимка. Данные устарели для всех сетей.
Сортировка
по возрастанию диапазона баланса
Единицы измерения
address count, coin amount and percent per balance band
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный

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

ДеградацияПроверено: 2026-11-13 03:59:24 UTCHTTP 2002 msСхема совпадаетВозраст самой новой точки данных: 71.1d

Возраст самой новой точки данных: 6145155 s (ожидается не более 259200 s)

Доступность за последние 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/rich-list/:chain/statДеградация
Параметры

string — Chain id; 400 if unsupported.

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