/api/coins/all
GETДоступен

Полный список монет

Полный список монет (цена, капитализация, иконка)

GET/api/coins/all
Записи монет, не обновлявшиеся более 48 часов, возвращаются с `market_cap` и `mcap_rank`, равными `null`, и с `is_stale: true` — после всех актуальных строк; остальные поля таких строк сохраняют последнее сохранённое значение. Правило дублируется в поле `stale_rule`.

Запрос

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

ИмяТипОбязательныйПо умолчаниюДопустимые значенияОписание
limitintegerНеобязательный0≤ 20000Число строк; 0 = без ограничения. Пример: 100
offsetintegerНеобязательный0—Смещение пагинации.
hasMcapstringНеобязательный—1=1 — только монеты с капитализацией.

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

curl -s "https://www.coinboss.com/api/coins/all?limit=100"

Поля ответа

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

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
totalnumber—Всего.
returnednumbercountЧисло монет в `data` для этого запроса (после применения `limit`/`offset`); `total` — размер всего списка.
stale_ruleobject—Правило, применяемое к монетам, справочные данные которых давно не обновлялись.
stale_rule.threshold_hoursnumberhМонета считается устаревшей, если её справочные данные старше указанного числа часов.
stale_rule.basisstring—Цена фьючерса минус спотовая цена либо блок базиса.
stale_rule.nulled_fieldsarray—Поля, которые для устаревших монет возвращаются как `null` вместо неактуального значения.
stale_rule.nulled_fields[]string—Имя поля.
stale_rule.flagstring—Имя булева поля строки, которым помечается устаревшая монета (`is_stale`).
stale_rule.stale_returnednumbercountЧисло устаревших монет в этом ответе.
dataarray—Полезные данные.
data[]object—Полезные данные.
data[].coinstring—Символ монеты в верхнем регистре (например, BTC).
data[].namestring—Название.
data[].image_urlstring—Путь к иконке на том же источнике (same-origin), которую отдаёт CoinBoss; null, если проверенной иконки нет.
data[].pricestring(decimal)—Последняя цена в валюте котировки (USD или USDT, если не указано иное).
data[].market_capstring(decimal)—Рыночная капитализация.
data[].mcap_ranknumber—Ранг по рыночной капитализации.
data[].change_pctstring(decimal)%Изменение в процентах.
data[].volume_usdstring(decimal)USDОбъём (номинал в USD).
data[].circulating_supplystring(decimal)coinПредложение монеты в обращении по данным стороннего источника, десятичная строка; null, если значение не сообщается.
data[].total_supplystring(decimal)—Общее предложение в монетах.
data[].max_supplystring(decimal)|null—Максимальное предложение в монетах; null, если оно не ограничено или неизвестно.
data[].athstring(decimal)USDИсторический максимум цены монеты по данным стороннего источника, десятичная строка.
data[].ath_datestring—Момент достижения исторического максимума из `ath`, ISO 8601 UTC.
data[].high_24hstring(decimal)—Максимум за 24h.
data[].low_24hstring(decimal)—Минимум за 24h.

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

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

/api/coins/all?limit=100 · Реальный ответ, получен 2026-11-13 03:57:28 UTC. Длинные массивы и словари сокращены для отображения: data: элементов было 100.

  • {
    • "success": true,
    • "total": 20484,
    • "returned": 100,
    • "stale_rule": {
      • "threshold_hours": 48,
      • "basis": "coins.updated_at",
      • "nulled_fields": [ … 2 ],
      • "flag": "is_stale",
      • "stale_returned": 0
      },
    • "data": [
      • { … 15 },
      • { … 15 }
      ]
    }

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
2m
Пограничный микрокеш
10s
Частота обновления
полный список — раз в 6 h, топ-2500 — ежечасно; кеш API 120 s
Окно
последнее значение; изменение за 24h (сторонний агрегатор рыночных данных)
Источники данных
Полный справочник монет (цена, капитализация, ранг, предложение) из API рынков стороннего агрегатора рыночных данных.
Покрытие бирж
полный список монет стороннего агрегатора рыночных данных (около 20 400 строк на момент автопроверки), включая монеты без капитализации
Пагинация
limit (0 = без ограничения, макс. 20000) + offset; фильтр hasMcap; возвращается total
Сортировка
по убыванию капитализации (строки без капитализации — в конце)
Единицы измерения
USD
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный

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

ДоступенПроверено: 2026-11-13 03:57:28 UTCHTTP 20031 msСхема совпадает

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

Пройдено 99.76% из 411 проверок

Ошибки

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

Код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/coins/allДоступен
Параметры

integer · по умолчанию 0 · макс. 20000 — Row count; 0 = unlimited.

integer · по умолчанию 0 — Pagination offset.

string — =1 only coins with a market cap.

URL запросаhttps://www.coinboss.com/api/coins/all?limit=100
Выберите эндпоинт и нажмите «Отправить запрос». Здесь появятся ответ, заголовки и время выполнения.