/api/stock-detail/:underlying
GETДоступен

Сведения о базовой акции

Сведения о базовой акции (котировки контрактов по биржам)

GET/api/stock-detail/:underlying

Запрос

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

ИмяТипОбязательныйПо умолчаниюДопустимые значенияОписание
underlying pathstringОбязательный——Тикер базового актива (приводится к верхнему регистру); 404, если данных нет. Пример: SOXL

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

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

curl -s "https://www.coinboss.com/api/stock-detail/SOXL"

Поля ответа

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

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
nownumbermsВремя сервера в момент формирования ответа.
sourcestring—Откуда взято значение.
dataobject—Полезные данные.
data.underlyingstring—Символ базовой акции / индекса / сырьевого товара.
data.namestring—Название.
data.typestring—Тип.
data.price_avgnumber—Средняя цена по площадкам.
data.change_24hnumber—Изменение за 24h.
data.high_24hnumber—Максимум за 24h.
data.low_24hnumber—Минимум за 24h.
data.volume_24hnumber—Объём за 24h.
data.oi_usdnumberUSDОткрытый интерес (номинал в USD).
data.funding_weightednumberfractionСреднее текущих ставок финансирования бирж, взвешенное по открытому интересу; каждая ставка — за собственный интервал финансирования; null, если ни одна биржа не сообщает открытый интерес.
data.exchangesnumber—Биржи.
data.marketsarray—Рынки.
data.markets[]object—Рынки.
data.markets[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
data.markets[].symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
data.markets[].pricenumber—Последняя цена в валюте котировки (USD или USDT, если не указано иное).
data.markets[].change_pctnumber|null%Изменение в процентах.
data.markets[].volume_24hnumber—Объём за 24h.
data.markets[].fundingnumber—Блок или значение ставки финансирования.
data.markets[].funding_interval_hnumberhИнтервал финансирования.
data.markets[].oi_usdnumber|nullUSDОткрытый интерес (номинал в USD).
data.long_shortarray—Блок лонг/шорт.
data.long_short[]object—Блок лонг/шорт.
data.long_short[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
data.long_short[].symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
data.long_short[].ratio_typestring—Что учитывает соотношение: `account` (все счета), `topacc` (счета топ-трейдеров), `position` (размер позиций) или `taker` (объём покупок и продаж тейкеров).
data.long_short[].long_rationumber%Последняя доля лонгов (для `taker` — доля покупок тейкеров) по этой бирже и контракту; `long_ratio` + `short_ratio` = 100.
data.long_short[].short_rationumber%Последняя доля шортов (для `taker` — доля продаж тейкеров) по этой бирже и контракту; `long_ratio` + `short_ratio` = 100.
data.liquidationsobject—Ликвидации по этому базовому активу (включая псевдонимы) на всех биржах по окнам `h1`, `h4`, `h12`, `h24`, а также `count_24h`.
data.liquidations.h1object—Номинальная стоимость, ликвидированная за последний 1 час, в USD, с разбивкой на `long`, `short` и `total`.
data.liquidations.h1.longnumber—Значение стороны лонг.
data.liquidations.h1.shortnumber—Значение стороны шорт.
data.liquidations.h1.totalnumber—Всего.
data.liquidations.h4object—Номинальная стоимость, ликвидированная за последние 4 часа, в USD, с разбивкой на `long`, `short` и `total`.
data.liquidations.h4.longnumber—Значение стороны лонг.
data.liquidations.h4.shortnumber—Значение стороны шорт.
data.liquidations.h4.totalnumber—Всего.
data.liquidations.h12object—Номинальная стоимость, ликвидированная за последние 12 часов, в USD, с разбивкой на `long`, `short` и `total`.
data.liquidations.h12.longnumber—Значение стороны лонг.
data.liquidations.h12.shortnumber—Значение стороны шорт.
data.liquidations.h12.totalnumber—Всего.
data.liquidations.h24object—Значение за 24 часа.
data.liquidations.h24.longnumber—Значение стороны лонг.
data.liquidations.h24.shortnumber—Значение стороны шорт.
data.liquidations.h24.totalnumber—Всего.
data.liquidations.count_24hnumber—Количество за 24 часа.
data.klinesarray—Свечи.
data.klines[]object—Свечи.
data.klines[].tnumbermsМетка времени.
data.klines[].onumberUSDЦена открытия дневной свечи, начинающейся в момент `t` (UTC).
data.klines[].hnumberUSDМаксимальная цена дневной свечи, начинающейся в момент `t` (UTC).
data.klines[].lnumberUSDМинимальная цена дневной свечи, начинающейся в момент `t` (UTC).
data.klines[].cnumberUSDЦена закрытия дневной свечи, начинающейся в момент `t` (UTC); пока текущий день не завершён — последняя цена.
data.klines[].vnumber—Значение.

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

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

/api/stock-detail/SOXL · Реальный ответ, получен 2026-11-13 04:03:14 UTC. Длинные массивы и словари сокращены для отображения: data.klines: элементов было 180; data.markets: элементов было 17; data.long_short: элементов было 16.

  • {
    • "success": true,
    • "now": 1794542594660,
    • "source": "in-house collection",
    • "data": {
      • "underlying": "SOXL",
      • "name": "Direxion Semiconductor Bull 3x",
      • "type": "etf",
      • "price_avg": 63.41251867448196,
      • "change_24h": 1.2395980314621862,
      • "high_24h": 69.02,
      • "low_24h": 58.4,
      • "volume_24h": 10951946654.019999,
      • "oi_usd": 515358908.96,
      • "funding_weighted": 0.000009575856229677082,
      • "exchanges": 17,
      • "markets": [ … 2 ],
      • "long_short": [ … 2 ],
      • "liquidations": { … 5 },
      • "klines": [ … 2 ]
      }
    }

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
60s
Пограничный микрокеш
10s
Частота обновления
тикеры — раз в 1 min; OI / финансирование — раз в 5 min; кеш API 60 s
Окно
ликвидации за 1h / 4h / 12h / 24h; до 180 дневных свечей
Источники данных
Сведения об одном базовом активе токенизированных акций/TradFi: контракты по биржам, финансирование, OI, лонг/шорт, ликвидации и дневные свечи — всё по биржевым данным, собранным самостоятельно.
Покрытие бирж
Базовые активы из собственного реестра токенизированных акций; 404, если ничего не найдено
Пагинация
нет
Единицы измерения
USD; funding as decimal rate per interval
Метод расчёта
funding_weighted = OI-weighted mean of raw rates (not normalized to 8h); quotes deviating more than 10% from the median with zero volume are dropped
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный

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

ДоступенПроверено: 2026-11-13 03:58:45 UTCHTTP 20076 msСхема совпадаетВозраст самой новой точки данных: 4h

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

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

Ошибки

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

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

string — Underlying ticker (upper-cased); 404 when no data.

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