Объём 24ч—Открытый интерес—Ликвидации 24ч$1.36BЛонг/Шорт 24ч—Доминация BTC—Доминация ETH—
Приложение
Язык ▾
₽ RUB ▾
/api/sd/etf/overview
GETЧастичноPARTIAL

Обзор спотовых ETF (раскрытия эмитентов)

Запасы, чистые активы и чистый поток спотовых крипто-ETF по одному активу — сумма по фондам, данные которых CoinBoss может собрать из раскрытий эмитентов, с полным списком фондов и причиной отсутствия каждого неучтённого фонда.

GET/api/sd/etf/overview
Частичное покрытие. Частичное покрытие: несколько крупных эмитентов не предоставляют публичного машиночитаемого раскрытия, которое можно собирать с сервера. Их фонды указаны как недоступные, а итоги охватывают только остальные фонды. Сверьте `funds_covered` / `funds_total`, прежде чем сравнивать итоги с другими источниками.

Запрос

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

ИмяТипОбязательныйПо умолчаниюДопустимые значенияОписание
assetstringОбязательный—BTC, ETH, SOL, HYPEБазовый актив, без учёта регистра. `coin` принимается как псевдоним. Пример: BTC

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

curl -s "https://www.coinboss.com/api/sd/etf/overview?asset=BTC"

Поля ответа

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

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
schemastring—Идентификатор схемы этого ответа. Меняется только тогда, когда у существующего поля меняется смысл или тип.
nownumbermsВремя сервера в момент формирования ответа.
assetstring—Базовый актив.
as_ofstring—Самая поздняя отчётная дата эмитента среди покрытых фондов.
as_of_minstring—Самая ранняя отчётная дата эмитента среди покрытых фондов.
expected_as_ofstring—Последний торговый день США, срок публикации за который уже истёк.
totals_scopestring—Всегда `covered_funds_only`: итоги не являются итогами по всему рынку.
funds_totalnumber—Фонды, зарегистрированные для актива.
funds_coverednumber—Фонды с актуальными данными эмитента.
holdings_coin_totalnumbercoinЗапасы в монетах, просуммированные по покрытым фондам.
holdings_fundsnumber—Фонды, включённые в `holdings_coin_total`.
aum_usd_totalnumberUSDЧистые активы, просуммированные по покрытым фондам.
aum_fundsnumber—Фонды, включённые в `aum_usd_total`.
net_flow_usdnumberUSDЧистый выпуск / погашение паёв, просуммированные по фондам, дата потока которых равна `net_flow_as_of`. Метод CoinBoss.
net_flow_as_ofstring—Дата, на которую учитывается чистый поток.
net_flow_funds_coverednumber—Фонды, включённые в `net_flow_usd`.
net_flow_fundsarray—Тикеры, включённые в `net_flow_usd`.
net_flow_funds[]string—Тикеры, включённые в `net_flow_usd`.
net_flow_missingarray—Покрытые фонды, не включённые в `net_flow_usd`, с указанием причины для каждого.
net_flow_missing[]object—Покрытые фонды, не включённые в `net_flow_usd`, с указанием причины для каждого.
net_flow_missing[].tickerstring—Тикер фонда.
net_flow_missing[].reasonstring—Машиночитаемый код причины.
net_flow_missing[].flow_as_ofstring|null—Дата, на которую учитывается поток.
fundsarray—Одна строка на каждый зарегистрированный фонд, включая фонды, данные которых собрать нельзя.
funds[]object—Одна строка на каждый зарегистрированный фонд, включая фонды, данные которых собрать нельзя.
funds[].tickerstring—Тикер фонда.
funds[].issuerstring—Идентификатор эмитента фонда.
funds[].namestring—Название фонда.
funds[].statusstring—OK, STALE, ERROR или UNAVAILABLE.
funds[].as_of_datestring|null—Отчётная дата эмитента для строки.
funds[].holdings_coinnumber|nullcoinЧисло монет в запасах по раскрытию эмитента.
funds[].holdings_usdnumber|nullUSDРыночная стоимость запасов по раскрытию эмитента.
funds[].ref_pricenumber|nullUSDРеференсная цена за монету, используемая эмитентом.
funds[].aum_usdnumber|nullUSDЧистые активы фонда.
funds[].aum_srcstring|null—Как получены чистые активы: `reported`, `nav_x_shares` или `holdings_mv_sum`.
funds[].shares_outnumber|nullsharesПаи в обращении.
funds[].shares_srcstring|null—Как получено число паёв в обращении: `reported` либо вывод из чистых активов и NAV.
funds[].navnumber|nullUSDСтоимость чистых активов на пай.
funds[].market_pricenumber|nullUSDРыночная цена закрытия за пай.
funds[].premium_pctnumber|null%Премия (+) или дисконт (−) рыночной цены к NAV в том виде, в каком их публикует эмитент.
funds[].fee_pctnumber|null%Комиссия спонсора за год; `null`, если она не публикуется.
funds[].flow_usdnumber|nullUSDЧистый выпуск / погашение паёв фонда на дату потока. Метод CoinBoss.
funds[].flow_sharesnumber|nullsharesИзменение числа паёв в обращении.
funds[].flow_coinnullcoinИзменение запасов в монетах; включает начисление комиссии, уплачиваемой в монете; только для справки.
funds[].flow_methodstring|null—Использованная формула: `shares_x_nav` или `aum_nav_ratio_t1`.
funds[].flow_as_ofstring|null—Дата, на которую учитывается поток.
funds[].flow_obs_datestring|null—Отчётная дата более новой из двух использованных строк.
funds[].flow_prev_datestring|null—Отчётная дата более старой из двух использованных строк.
funds[].flow_notestring|null—Почему поток отсутствует или имеет особый статус (например, `no_previous_row`, `multi_day_gap`).
funds[].is_staleboolean|null—True, если данные старше своего окна актуальности.
funds[].source_urlstring|null—Эндпоинт эмитента, из которого собрана строка (только для сведений о происхождении данных).
funds[].observed_atnumber|nullmsМетка времени, указанная источником для данных.
funds[].received_atnumber|nullmsВремя получения данных коллектором CoinBoss.
funds[].unavailable_reasonstring|null—Код причины, если данные фонда собрать нельзя.
funds[].unavailable_detailstring|null—Объяснение, если данные фонда собрать нельзя.
coverageobject—Что входит и что не входит в эти значения. Сверьтесь с этим блоком, прежде чем сравнивать итоги с другим источником.
coverage.included_exchangesarray—Источники, актуальные данные которых учтены.
coverage.included_exchanges[]string—Источники, актуальные данные которых учтены.
coverage.unavailablearray—Источники, которые не удалось включить, с указанием причины для каждого. Они никогда не учитываются как 0.
coverage.unavailable[]object—Источники, которые не удалось включить, с указанием причины для каждого. Они никогда не учитываются как 0.
coverage.unavailable[].exchangestring—Идентификатор биржи (в нижнем регистре).
coverage.unavailable[].issuerstring—Идентификатор эмитента фонда.
coverage.unavailable[].reasonstring—Машиночитаемый код причины.
coverage.unavailable[].detailstring—Понятное человеку объяснение причины.
coverage.stale_excludedarray—Строки, не учтённые потому, что их последнее обновление выходит за окно актуальности. пусто в образцах, по которым построена таблица
methodobject—Текстовое описание формул, использованных для этого ответа, по одной записи на поле.
method.holdings_coin_totalstring—Пояснение к формуле для `holdings_coin_total`, обычный текст.
method.aum_usd_totalstring—Пояснение к формуле для `aum_usd_total`, обычный текст.
method.net_flow_usdstring—Пояснение к формуле для `net_flow_usd`, обычный текст.
method.net_flow_missingstring—Пояснение к формуле для `net_flow_missing`, обычный текст.
method.flow_coinstring—Пояснение к формуле для `flow_coin`, обычный текст.
method.premium_pctstring—Пояснение к формуле для `premium_pct`, обычный текст.
method.is_stalestring—Пояснение к формуле для `is_stale`, обычный текст.
method.unitsstring—Пояснение к формуле для `units`, обычный текст.
metaobject—Происхождение данных и актуальность этого ответа.
meta.schemastring—Идентификатор схемы этого ответа. Меняется только тогда, когда у существующего поля меняется смысл или тип.
meta.sourcearray—Публичные эндпоинты источников, из которых собраны данные.
meta.source[]object—Публичные эндпоинты источников, из которых собраны данные.
meta.source[].exchangestring—Идентификатор биржи (в нижнем регистре).
meta.source[].endpointstring—Публичный эндпоинт источника, который читает коллектор (показан для сведений о происхождении данных; клиенты его не вызывают).
meta.observed_atnumbermsМетка времени, указанная источником для данных.
meta.received_atnumbermsВремя получения данных коллектором CoinBoss.
meta.fetched_atnumbermsВремя формирования этого ответа.
meta.windowstring—Временное окно, которое охватывают значения.
meta.qualitystring—FRESH, PARTIAL, STALE, BROKEN или UNAVAILABLE — оценка по меткам времени данных и покрытию.
meta.is_staleboolean—True, если данные старше своего окна актуальности.
meta.cache_ttl_snumbersВремя жизни кеша этого ответа.
meta.fallbackstring—Что возвращает эндпоинт при сбое коллектора или источника.

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

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

/api/sd/etf/overview?asset=BTC · Реальный ответ, получен 2026-11-13 04:02:51 UTC. Длинные массивы и словари сокращены для отображения: funds: элементов было 12; meta.source: элементов было 5; coverage.unavailable: элементов было 7.

  • {
    • "success": true,
    • "schema": "coinboss.sd.etf/1",
    • "now": 1794542298326,
    • "asset": "BTC",
    • "as_of": "2026-11-12",
    • "as_of_min": "2026-11-11",
    • "expected_as_of": "2026-11-11",
    • "totals_scope": "covered_funds_only",
    • "funds_total": 12,
    • "funds_covered": 5,
    • "holdings_coin_total": 89855.4854312,
    • "holdings_funds": 5,
    • "aum_usd_total": 6204214916.33,
    • "aum_funds": 4,
    • "net_flow_usd": 0,
    • "net_flow_as_of": "2026-11-11",
    • "net_flow_funds_covered": 3,
    • "net_flow_funds": [
      • "ARKB",
      • "BTCO",
      • "HODL"
      ],
    • "net_flow_missing": [
      • { … 3 },
      • { … 3 }
      ],
    • "funds": [
      • { … 30 },
      • { … 30 }
      ],
    • "coverage": {
      • "included_exchanges": [ … 5 ],
      • "unavailable": [ … 2 ],
      • "stale_excluded": []
      },
    • "method": {
      • "holdings_coin_total": "sum of issuer-reported coin holdings over covered (non-stale) funds only; NOT a whole-market total, see funds_covered/funds_total",
      • "aum_usd_total": "sum of fund net assets (USD) over covered funds; aum_src per fund: reported | nav_x_shares (NAV x shares outstanding) | holdings_mv_sum (sum of issuer holdings …",
      • "net_flow_usd": "own method, per fund between two consecutive issuer as-of rows: shares_x_nav = (shares_out[t] - shares_out[t-1]) x NAV[t], dated t; aum_nav_ratio_t1 (issuer pub…",
      • "net_flow_missing": "covered funds not included in net_flow_usd and why: no_previous_row (needs two consecutive issuer rows), t1_booking_available_next_trading_day (Franklin: flow o…",
      • "flow_coin": "holdings_coin[t] - holdings_coin[t-1]; includes daily sponsor-fee accrual paid in coin, informational only",
      • "premium_pct": "issuer-reported premium/discount to NAV in percent; null when the issuer does not publish it",
      • "is_stale": "fund as_of_date older than the trading day before expected_as_of (expected_as_of = latest NYSE trading day whose T+1 16:00 UTC publication deadline has passed)",
      • "units": "holdings in coins; aum/flow in USD; nav/market_price in USD per share; fee_pct/premium_pct in percent"
      },
    • "meta": {
      • "schema": "coinboss.sd.etf/1",
      • "source": [ … 2 ],
      • "observed_at": 1794441600000,
      • "received_at": 1794537318126,
      • "fetched_at": 1794542298326,
      • "window": "latest",
      • "quality": "PARTIAL",
      • "is_stale": false,
      • "cache_ttl_s": 300,
      • "fallback": "collector failure keeps the last issuer row with its real as_of_date; a fund whose as_of_date is more than 1 trading day behind the expected as-of is flagged is…"
      }
    }

Проверенные образцы

Помимо примера выше, автопроверка вызывает этот эндпоинт с указанными параметрами и каждый раз сверяет схему.

ПараметрыHTTPЗадержкаРезультат
asset=ETH2004 msПройдено PARTIAL
asset=SOL2004 msПройдено PARTIAL
asset=HYPE2002 msПройдено PARTIAL
—4001 msПройдено возвращает ожидаемую ошибку

Проверено: 2026-11-13 03:58:18 UTC

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
5m
Пограничный микрокеш
10s
Частота обновления
Три цикла коллектора в сутки (02:35, 10:35, 16:35 UTC). Эмитенты публикуют данные один раз за торговый день США, обычно вечером в день торгов.
Окно
Последняя отчётная дата эмитента по каждому фонду (`as_of`, `as_of_min`); `expected_as_of` — последний торговый день США, срок публикации за который уже истёк.
Источники данных
Ежедневные раскрытия, публикуемые самими эмитентами фондов (запасы, чистые активы, паи в обращении, NAV); их собирает и хранит CoinBoss (sd_etf_fund_daily). Чистый поток CoinBoss рассчитывает по этим раскрытиям.
Покрытие бирж
Покрыты только фонды, эмитент которых публикует машиночитаемые ежедневные данные. `funds_total` и `funds_covered` показывают, сколько их; каждый непокрытый фонд указан в `coverage.unavailable` с причиной. Итоги — это суммы только по покрытым фондам (`totals_scope = "covered_funds_only"`), а не по всему рынку.
Единицы измерения
Amounts in USD; holdings in units of the underlying coin; NAV and market price in USD per share; `premium_pct` and `fee_pct` in percent.
Метод расчёта
Funds that disclose shares outstanding: flow = (shares[t] − shares[t−1]) × NAV[t]. Funds that disclose only net assets and NAV: flow = AUM[t] × NAV[t−1] ÷ NAV[t] − AUM[t−1], booked on t−1. A fund enters `net_flow_usd` only when its flow date equals `net_flow_as_of`; the others are listed in `net_flow_missing`.
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный
Доступен с
2026-11-11

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

ЧастичноПроверено: 2026-11-13 03:58:18 UTCHTTP 2004 msСхема совпадаетВозраст самой новой точки данных: 83m

Эндпоинт сообщает качество данных PARTIAL — Частичное покрытие: несколько крупных эмитентов не предоставляют публичного машиночитаемого раскрытия, которое можно собирать с сервера. Их фонды указаны как недоступные, а итоги охватывают только остальные фонды. Сверьте `funds_covered` / `funds_total`, прежде чем сравнивать итоги с другими источниками.

Доступность за последние 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/sd/etf/overviewЧастично
Параметры

string — Underlying asset, case-insensitive. `coin` is accepted as an alias.

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