24h出来高—建玉—24h清算$1.36B24hロング/ショート—BTCドミナンス—ETHドミナンス—
アプリ
言語 ▾
¥ JPY ▾
/api/sd/etf/history
GET一部PARTIAL

現物ETFの履歴

1資産（カバー対象ファンドの合計）または単一ファンドの保有量、純資産、ネットフローの日次系列です。各データポイントには、含まれるファンド数が示されます。

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を返します。登録済みでも収集できないファンドは、`series: null`とともに200を返します。

リクエスト例

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

レスポンスフィールド

フィールド表は実際のレスポンスから生成しているため、エンドポイントが返す内容をそのまま反映しています。パスでは、配列の要素をa[]、銘柄や取引所などの動的な名前をキーとするオブジェクトを{*}で表します。

フィールド型単位説明
successboolean—リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。
schemastring—このレスポンスのスキーマID。既存フィールドの意味または型が変わった場合にのみ変更されます。
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—登録済みファンドごとに1行。収集できないファンドも含みます。 省略される場合あり
coverageobject—数値に含まれるものと含まれないもの。他のソースと合計値を比較する前に、まずこの内容を比較してください。
coverage.included_exchangesarray—鮮度内のデータが算入されているソース。
coverage.included_exchanges[]string—鮮度内のデータが算入されているソース。
coverage.unavailablearray—算入できなかったソース。それぞれ理由が付きます。0としてカウントされることはありません。
coverage.unavailable[]object—算入できなかったソース。それぞれ理由が付きます。0としてカウントされることはありません。
coverage.unavailable[].exchangestring—取引所ID（小文字）。
coverage.unavailable[].issuerstring—ファンドの発行体ID。
coverage.unavailable[].reasonstring—機械可読な理由コード。
coverage.unavailable[].detailstring—人が読める形式での理由の説明。
coverage.stale_excludedarray—最終更新が鮮度ウィンドウの外にあるため除外された行。 この表の生成に使用したサンプルでは空
methodobject—このレスポンスで使用した計算式を平文で記述したもの。フィールドごとに1エントリー。
method.valuestring—`value`の計算式に関する注記（平文）。
method.fundsstring—`funds`の計算式に関する注記（平文）。
method.multi_daystring—`multi_day`の計算式に関する注記（平文）。
method.history_startstring—`history_start`の計算式に関する注記（平文）。
metaobject—このレスポンスのデータリネージと鮮度。
meta.schemastring—このレスポンスのスキーマID。既存フィールドの意味または型が変わった場合にのみ変更されます。
meta.sourcearray—データの収集元である上流の公開エンドポイント。
meta.source[]object—データの収集元である上流の公開エンドポイント。
meta.source[].exchangestring—取引所ID（小文字）。
meta.source[].endpointstring—コレクターが読み取るソースの公開エンドポイント（データリネージのために表示。クライアントが呼び出すことはありません）。
meta.observed_atnumbermsソースがデータに付与したタイムスタンプ。
meta.received_atnumbermsCoinBossのコレクターがデータを受信した時刻。
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にチェック

詳細

認証
不要。公開エンドポイントです。
レート制限
IPごとに毎分1200リクエスト
サーバーキャッシュ
5m
エッジマイクロキャッシュ
10s
更新頻度
コレクターは1日3回巡回します（02:35、10:35、16:35 UTC）。発行体は米国の取引日ごとに1回、通常は取引日の夕方に公表します。
ウィンドウ
30d / 90d / all。発行体の基準日ごとに1ポイント。
データソース
ファンドの発行体自身が公表する日次開示（保有量、純資産、発行済口数、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 UTCにチェックHTTP 2001 msスキーマ一致最新データポイントは88m前

エンドポイントが報告するデータ品質はPARTIALです — 部分的なカバレッジ：複数の大手発行体は、サーバーから収集できる機械可読な公開開示を提供していません。それらのファンドは利用不可として記載され、合計値は残りのファンドのみを対象とします。他のソースと合計値を比較する前に、`funds_covered` / `funds_total`を確認してください。

可用性（過去30日間）

408回のチェック中100%が合格

エラー

失敗した呼び出しは、すべてのエンドポイントで共通の形式で返されます。一覧はエラーページにあります。 エラーとレート制限 →

コードHTTP意味対処方法
INVALID_PARAM400必須パラメータが不足しているか、値が受け付けられません。該当するパラメータが特定できる場合は、`param`にその名前が入ります。そのまま再試行せず、リクエストを修正してください。
UNAUTHORIZED401`CB-API-KEY`ヘッダーが送信されましたが、キーが不明か失効済みです。公開データにキーは不要です。ヘッダーを外すか、有効なキーを使用してください。そのまま再試行しないでください。
FORBIDDEN403このルートは公開APIに含まれません（内部用またはアカウント専用）。再試行しないでください。
NOT_FOUND404不明なルートであるか、リクエストされた銘柄 / 取引所 / ファンドが存在しません。再試行せず、パスと識別子をカタログと照合してください。
RATE_LIMITED429リクエスト数が1分あたりの上限を超えました。`Retry-After`に待機すべき秒数が示されます。`Retry-After`で示された時間だけ待ってから、バックオフ付きで再試行してください。
INTERNAL500予期しないサーバーエラーです。メッセージは意図的に汎用的な内容にしています。報告の際は`request_id`を引用してください。数秒後に1回だけ再試行してください。解消しない場合は、リクエストIDを添えて報告してください。
UPSTREAM_FAILED503このエンドポイントの背後にあるデータソースが時間内に応答しませんでした。鮮度切れの数値や代替の数値を代わりに返すことはありません。バックオフ付きで再試行し、ステータスページを確認してください。
UNAVAILABLE501 / 503データセットが一時的に準備できていない（キャッシュのウォームアップ中）か、このエンドポイントに適法な公開ソースがまだありません。時間をおいて再試行してください。仕様上利用できないエンドポイントは、カタログに明示されています。
REQUEST_FAILED200一部の古いエンドポイントは、HTTP 200で`success: false`を返します。HTTPステータスだけでなく、必ず`success`を確認してください。メッセージによって異なります。失敗したリクエストとして扱ってください。

試してみる

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`.

リクエストURLhttps://www.coinboss.com/api/sd/etf/history?asset=BTC&metric=flow
エンドポイントを選択して「リクエストを送信」を押してください。レスポンス、ヘッダー、所要時間がここに表示されます。