/api/etf/flows
GET利用可能

現物ETFの日次ネットフロー履歴

現物ETFの日次ネットフロー履歴(合計)

GET/api/etf/flows
第三者ソースが公表した日次フロー表を、CoinBossが保存したものです。発行体の開示からCoinBossが算出したフローは`/api/sd/etf/history`で取得できます。

リクエスト

クエリパラメータ

名前型必須デフォルト指定可能な値説明
assetstring任意BTCBTC, ETH, SOL, HYPE原資産。それ以外の値は400 `INVALID_PARAM`を返します。 例: BTC
daysstring任意0—遡及日数。0またはall = 全履歴。 例: 30

リクエスト例

curl -s "https://www.coinboss.com/api/etf/flows?asset=BTC&days=30"

レスポンスフィールド

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

フィールド型単位説明
successboolean—リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。
assetstring—資産シンボル。
daysnumber—日次の値、または日数。
unitstring—このオブジェクト内の値の単位。
countnumber—項目数。
latestobject—最新のレコード。
latest.datestring—暦日(UTC)。
latest.flownumber—当日の純設定 / 純解約フロー。
latest.aumnumber—運用資産残高。
latest.aum_lastnumbermillion USD資産の現物ETFを合算したAUMのうち、nullでない最新の値。`aum_as_of`時点の値で、`date`より古い場合があります。
latest.aum_as_ofstring—`aum_last`が対象とする取引日(YYYY-MM-DD)。
latest.cum_totalnumber—累計。
latest.sum_7dnumber—7日間の合計。
dataarray—ペイロード。
data[]object—ペイロード。
data[].datestring—暦日(UTC)。
data[].flownumber—当日の純設定 / 純解約フロー。
data[].cumnumber—上場以来の累計ネットフロー。
data[].aumnumber|null—運用資産残高。

2026-11-11 23:00 UTCに1件の実レスポンスから生成。

レスポンス例

/api/etf/flows?asset=BTC&days=30 · 実際のレスポンス(2026-11-13 03:58:18 UTCに取得)。 長い配列とマップは表示用に短縮しています:dataは30件。

  • {
    • "success": true,
    • "asset": "BTC",
    • "days": 30,
    • "unit": "million_usd",
    • "count": 30,
    • "latest": {
      • "date": "2026-11-12",
      • "flow": -47.7,
      • "aum": 98821.466,
      • "aum_last": 98821.466,
      • "aum_as_of": "2026-11-12",
      • "cum_total": 55106.874,
      • "sum_7d": -1411
      },
    • "data": [
      • { … 4 },
      • { … 4 }
      ]
    }

詳細

認証
不要。公開エンドポイントです。
レート制限
IPごとに毎分1200リクエスト
サーバーキャッシュ
5m
エッジマイクロキャッシュ
10s
更新頻度
1時間ごと(毎時15分)。ソースは米国の取引日ごとに1回公表します
ウィンドウ
デフォルトは上場以来の全履歴。`days=N`を指定すると直近N取引日を返します(累計は常に上場時から起算)
データソース
公開のETFフロートラッカーに基づく、米国の暗号資産現物ETFの日次ネットフローです。AUMは公開のマーケットデータサイトに基づきます。
取引所カバレッジ
BTC、ETH、SOL、HYPEの米国現物ETF(不明な資産はBTCにフォールバック)。XRPは収集していません。末尾の未公表の日は除外されます。
ソート
日付の昇順
単位
million USD (flow, cum, aum)
算出方法
Uses the source's daily TOTAL row; cum is the running sum since the first record; sum_7d is the sum of the last 7 trading days.
タイムスタンプ
フィールドの説明に別途記載がない限り、Unixエポックミリ秒(UTC)
レスポンス形式
json
安定性
安定版

ライブステータス

利用可能2026-11-13 03:58:18 UTCにチェックHTTP 2004 msスキーマ一致最新データポイントは28h前

可用性(過去30日間)

410回のチェック中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/etf/flows利用可能
パラメータ

string · デフォルト BTC — Underlying asset. Any other value returns 400 `INVALID_PARAM`.

string · デフォルト 0 — Look-back days; 0 or all = full history.

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