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

現物ETFの概要（発行体の開示情報）

1資産の暗号資産現物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—このレスポンスのスキーマID。既存フィールドの意味または型が変わった場合にのみ変更されます。
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—登録済みファンドごとに1行。収集できないファンドも含みます。
funds[]object—登録済みファンドごとに1行。収集できないファンドも含みます。
funds[].tickerstring—ファンドのティッカー。
funds[].issuerstring—ファンドの発行体ID。
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発行体が使用する1コインあたりの参照価格。
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|nullUSD1口あたりの純資産価値。
funds[].market_pricenumber|nullUSD1口あたりの市場終値。
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—使用した2行のうち、新しい方の基準日。
funds[].flow_prev_datestring|null—使用した2行のうち、古い方の基準日。
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|nullmsCoinBossのコレクターがデータを受信した時刻。
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—取引所ID（小文字）。
coverage.unavailable[].issuerstring—ファンドの発行体ID。
coverage.unavailable[].reasonstring—機械可読な理由コード。
coverage.unavailable[].detailstring—人が読める形式での理由の説明。
coverage.stale_excludedarray—最終更新が鮮度ウィンドウの外にあるため除外された行。 この表の生成に使用したサンプルでは空
methodobject—このレスポンスで使用した計算式を平文で記述したもの。フィールドごとに1エントリー。
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—このレスポンスのスキーマ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に4件の実レスポンスから生成。

レスポンス例

/api/sd/etf/overview?asset=BTC · 実際のレスポンス（2026-11-13 03:58:18 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にチェック

詳細

認証
不要。公開エンドポイントです。
レート制限
IPごとに毎分1200リクエスト
サーバーキャッシュ
5m
エッジマイクロキャッシュ
10s
更新頻度
コレクターは1日3回巡回します（02:35、10:35、16:35 UTC）。発行体は米国の取引日ごとに1回、通常は取引日の夕方に公表します。
ウィンドウ
ファンドごとの、発行体による最新の基準日（`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 UTCにチェックHTTP 2004 msスキーマ一致最新データポイントは83m前

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

可用性（過去30日間）

407回のチェック中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/overview一部
パラメータ

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

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