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

История спотовых ETF

Дневной ряд запасов, чистых активов или чистого потока по одному активу (сумма по охваченным фондам) либо по отдельному фонду. Для каждой точки указано, сколько фондов в неё входит.

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

Запрос

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

ИмяТипОбязательныйПо умолчаниюДопустимые значенияОписание
assetstringОбязательный—BTC, ETH, SOL, HYPEБазовый актив, без учёта регистра. `coin` принимается как псевдоним. Пример: BTC
metricstringОбязательный—holdings, aum, flowВозвращаемый ряд: запасы (в монетах), чистые активы (USD) или чистый поток (USD). Пример: flow
rangestringНеобязательный30d30d, 90d, allПериод выборки.
tickerstringНеобязательный——Тикер фонда, зарегистрированного для актива (например, `ARKB`). По умолчанию: сумма по всем покрытым фондам. Для незарегистрированного тикера возвращается 404; для зарегистрированного фонда, данные которого собрать нельзя, возвращается 200 с `series: null`.

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

curl -s "https://www.coinboss.com/api/sd/etf/history?asset=BTC&metric=flow"

Поля ответа

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

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
schemastring—Идентификатор схемы этого ответа. Меняется только тогда, когда у существующего поля меняется смысл или тип.
nownumbermsВремя сервера в момент формирования ответа.
assetstring—Базовый актив.
metricstring—Ряд, выбранный параметром `metric`.
rangestring—Применённый период выборки.
tickerstring|null—Тикер фонда.
unitstring—Единица значений ряда: `coin` или `USD`.
funds_totalnumber—Фонды, зарегистрированные для актива.
funds_in_seriesarray—Фонды, которые входят в ряд.
funds_in_series[]string—Фонды, которые входят в ряд.
first_date_by_fundobject—Первая доступная дата по каждому фонду (ключ — тикер). динамические ключи: ARKB,EZBC
first_date_by_fund.{*}string—Первая доступная дата по каждому фонду (ключ — тикер).
pointsnumber—Точки ряда, от старых к новым.
seriesarray—Дневные точки, от старых к новым; `null`, если данные фонда собрать нельзя.
series[]object—Дневные точки, от старых к новым; `null`, если данные фонда собрать нельзя.
series[].datestring—Отчётная дата эмитента для точки.
series[].valuenumber—Значение выбранной метрики, просуммированное по фондам, присутствующим на эту дату.
series[].fundsnumber—Одна строка на каждый зарегистрированный фонд, включая фонды, данные которых собрать нельзя. может отсутствовать
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.valuestring—Пояснение к формуле для `value`, обычный текст.
method.fundsstring—Пояснение к формуле для `funds`, обычный текст.
method.multi_daystring—Пояснение к формуле для `multi_day`, обычный текст.
method.history_startstring—Пояснение к формуле для `history_start`, обычный текст.
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; использовано реальных ответов: 3.

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

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

  • {
    • "success": true,
    • "schema": "coinboss.sd.etf/1",
    • "now": 1794542297946,
    • "asset": "BTC",
    • "metric": "flow",
    • "range": "30d",
    • "ticker": null,
    • "unit": "USD",
    • "funds_total": 12,
    • "funds_in_series": [
      • "ARKB",
      • "BITB",
      • "BTCO",
      • "EZBC",
      • "HODL"
      ],
    • "first_date_by_fund": {
      • "ARKB": "2026-10-14",
      • "BITB": "2026-11-11"
      },
    • "points": 21,
    • "series": [
      • { … 3 },
      • { … 3 }
      ],
    • "coverage": {
      • "included_exchanges": [ … 5 ],
      • "unavailable": [ … 2 ],
      • "stale_excluded": []
      },
    • "method": {
      • "value": "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…",
      • "funds": "number of funds contributing to that date; the aggregate is only comparable across dates with the same contributing funds (history starts on different dates per…",
      • "multi_day": "true when a contributing flow spans more than one trading day because the issuer history has no row for the day(s) in between",
      • "history_start": "issuer-provided official history is back-filled where it exists (21Shares valuation history, Franklin price history); other issuers start on the first collectio…"
      },
    • "meta": {
      • "schema": "coinboss.sd.etf/1",
      • "source": [ … 2 ],
      • "observed_at": 1794441600000,
      • "received_at": 1794537318126,
      • "fetched_at": 1794542297946,
      • "window": "30d",
      • "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=ETH&range=90d&metric=aum2005 msПройдено PARTIAL
asset=BTC&metric=holdings&ticker=ARKB2004 msПройдено FRESH
asset=BTC4001 msПройдено возвращает ожидаемую ошибку

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

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
5m
Пограничный микрокеш
10s
Частота обновления
Три цикла коллектора в сутки (02:35, 10:35, 16:35 UTC). Эмитенты публикуют данные один раз за торговый день США, обычно вечером в день торгов.
Окно
30d / 90d / all, одна точка на каждую отчётную дату эмитента.
Источники данных
Ежедневные раскрытия, публикуемые самими эмитентами фондов (запасы, чистые активы, паи в обращении, NAV); их собирает и хранит CoinBoss (sd_etf_fund_daily). Чистый поток CoinBoss рассчитывает по этим раскрытиям.
Покрытие бирж
Покрыты только фонды, эмитент которых публикует машиночитаемые ежедневные данные. `funds_total` и `funds_covered` показывают, сколько их; каждый непокрытый фонд указан в `coverage.unavailable` с причиной. Итоги — это суммы только по покрытым фондам (`totals_scope = "covered_funds_only"`), а не по всему рынку.
Пагинация
Пагинации нет; `range` ограничивает число точек.
Сортировка
По возрастанию даты.
Единицы измерения
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.
Метод расчёта
A point sums the funds that have a row on that date; `funds` is that count. Points with different `funds` are not directly comparable. Flow is bucketed by its booking date.
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный
Доступен с
2026-11-11

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

ЧастичноПроверено: 2026-11-13 04:02:51 UTCHTTP 2001 msСхема совпадаетВозраст самой новой точки данных: 88m

Эндпоинт сообщает качество данных 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/historyЧастично
Параметры

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

string — Series to return: holdings (coin), net assets (USD) or net flow (USD).

string · по умолчанию 30d — Look-back range.

string — Fund ticker registered for the asset (for example `ARKB`). Default: all covered funds summed. An unregistered ticker returns 404; a registered fund that cannot be collected returns 200 with `series: null`.

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