24h出来高—建玉—24h清算$1.36B24hロング/ショート—BTCドミナンス—ETHドミナンス—
アプリ
言語 ▾
¥ JPY ▾
/api/sd/funding
GET利用可能

1銘柄の資金調達率

自社データ層：1銘柄の資金調達率（8h正規化、加重平均）

GET/api/sd/funding

リクエスト

クエリパラメータ

名前型必須デフォルト指定可能な値説明
coinstring必須——銘柄シンボル。未指定の場合は400。エイリアス：`base`。 例: BTC

リクエスト例

curl -s "https://www.coinboss.com/api/sd/funding?coin=BTC"

レスポンスフィールド

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

フィールド型単位説明
successboolean—リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。
coinstring—銘柄シンボル（大文字。例：BTC）。
nownumbermsレスポンスを生成した時点のサーバー時刻。
unitstring—このレスポンス内のすべてのレートフィールドの単位：`fraction`（0.0001 = 0.01 %）。
avg_8hnumberfraction per 8h8h正規化レートの単純平均。1取引所につき1契約。
oi_weighted_8hnumberfraction per 8h8h正規化レートの建玉加重平均。
apr_pctnumber% per year単純な年率換算：8hレート × 3 × 365 × 100。
apr_basisstring—代表値の`apr_pct`がどの集計値に基づいているか。
n_exchangesnumber—集計に寄与した取引所の数。
n_normalizednumber—資金調達間隔が判明しており、8hに正規化できた取引所。
n_unknown_intervalnumber—資金調達間隔が不明なため、集計値から除外された取引所。
settled_cum_7dobject—過去7日間に実際に決済された資金調達率の合計を、決済履歴のある取引所間で平均した値。
settled_cum_7d.avgnumberfraction取引所間の単純平均。
settled_cum_7d.oi_weightednumberfraction建玉加重平均。
settled_cum_7d.nnumber—ウィンドウ全体のデータが揃っている取引所。
settled_cum_30dobject—同上（30日間）。
settled_cum_30d.avgnumberfraction取引所間の単純平均。
settled_cum_30d.oi_weightednumberfraction建玉加重平均。
settled_cum_30d.nnumber—ウィンドウ全体のデータが揃っている取引所。
by_exchangearray—取引所ごとに1行：その銘柄の主要契約（建玉が最大のもの）。
by_exchange[]object—取引所別の内訳。
by_exchange[].exchangestring—取引所ID（小文字。例：`binance`）。
by_exchange[].symbolstring—CoinBossが正規化した銘柄シンボル（例：BTCUSDT）。
by_exchange[].marginstring—証拠金通貨の区分。
by_exchange[].kindstring—種類。
by_exchange[].primaryboolean—集計値においてその取引所を代表する契約の場合はtrue。
by_exchange[].ratenumber—取引所が公表する現在期間の資金調達率。
by_exchange[].interval_hnumberh資金調達間隔。
by_exchange[].rate_8hnumber—8時間に正規化したレート：rate × 8 / interval_h。
by_exchange[].apr_pctnumber% per year年率換算のパーセント値。
by_exchange[].next_funding_timenumber|nullms次回の決済時刻。
by_exchange[].next_derivedboolean—次回の決済時刻が取引所の公表値ではなく、間隔から導出された場合はtrue。
by_exchange[].predicted_ratenull—取引所が公表している場合は、次回期間の参考レート。それ以外はnull。
by_exchange[].oi_usdnumber|nullUSDUSD建て想定元本での建玉。
by_exchange[].updated_atnumbermsこの行が最後に更新された時刻。
by_exchange[].age_snumbersこの行が最後に更新されてからの経過秒数。
by_exchange[].is_staleboolean—行が鮮度ウィンドウより古い場合はtrue。鮮度切れの行は合計に使用されません。
by_exchange[].settledobject|null—この契約の実際の決済記録。取引所に公開の履歴がない場合はnull。
by_exchange[].settled.last_ratenumber—直近の決済のレート。 省略される場合あり
by_exchange[].settled.last_timenumberms直近の決済の時刻。 省略される場合あり
by_exchange[].settled.interval_hnumberh資金調達間隔。 省略される場合あり
by_exchange[].settled.cum_7dnumber—過去7日間の決済済みレートの合計。 省略される場合あり
by_exchange[].settled.n_7dnumber—過去7日間に確認された決済回数。 省略される場合あり
by_exchange[].settled.n_7d_expectednumber—この間隔で7日間に見込まれる決済回数。 省略される場合あり
by_exchange[].settled.cum_7d_completeboolean—7日間のウィンドウ内に欠落した決済がない場合はtrue。 省略される場合あり
by_exchange[].settled.cum_30dnumber—過去30日間の決済済みレートの合計。 省略される場合あり
by_exchange[].settled.n_30dnumber—過去30日間に確認された決済回数。 省略される場合あり
by_exchange[].settled.n_30d_expectednumber—この間隔で30日間に見込まれる決済回数。 省略される場合あり
by_exchange[].settled.cum_30d_completeboolean—30日間のウィンドウ内に欠落した決済がない場合はtrue。 省略される場合あり
by_exchange[].settled.history_fromnumbermsこの契約について保持している最も古い決済記録。 省略される場合あり
other_contractsarray—同じ銘柄のその他の契約（USDC建て、コイン証拠金型など）。集計値には含まれません。
other_contracts[]object—取引所の追加の資金調達契約（コイン証拠金型、USDC建てなど）1件。その取引所の代表契約ではなく、集計値から除外されます。
other_contracts[].exchangestring—取引所ID（小文字。例：`binance`）。
other_contracts[].symbolstring—CoinBossが正規化した銘柄シンボル（例：BTCUSDT）。
other_contracts[].marginstring—証拠金通貨の区分。
other_contracts[].kindstring—種類。
other_contracts[].primaryboolean—集計値においてその取引所を代表する契約の場合はtrue。
other_contracts[].ratenumber—取引所が公表する現在期間の資金調達率。
other_contracts[].interval_hnumber|nullh資金調達間隔。
other_contracts[].rate_8hnumber|null—8時間に正規化したレート：rate × 8 / interval_h。
other_contracts[].apr_pctnumber|null% per year年率換算のパーセント値。
other_contracts[].next_funding_timenumber|nullms次回の決済時刻。
other_contracts[].next_derivedboolean—次回の決済時刻が取引所の公表値ではなく、間隔から導出された場合はtrue。
other_contracts[].predicted_ratenumber|null—取引所が公表している場合は、次回期間の参考レート。それ以外はnull。
other_contracts[].oi_usdnumber|nullUSDUSD建て想定元本での建玉。
other_contracts[].updated_atnumbermsこの行が最後に更新された時刻。
other_contracts[].age_snumbersこの行が最後に更新されてからの経過秒数。
other_contracts[].is_staleboolean—行が鮮度ウィンドウより古い場合はtrue。鮮度切れの行は合計に使用されません。
other_contracts[].settledobject|null—この契約の実際の決済記録。取引所に公開の履歴がない場合はnull。
other_contracts[].settled.last_ratenumber—直近の決済のレート。 省略される場合あり
other_contracts[].settled.last_timenumberms直近の決済の時刻。 省略される場合あり
other_contracts[].settled.interval_hnumberh資金調達間隔。 省略される場合あり
other_contracts[].settled.cum_7dnumber—過去7日間の決済済みレートの合計。 省略される場合あり
other_contracts[].settled.n_7dnumber—過去7日間に確認された決済回数。 省略される場合あり
other_contracts[].settled.n_7d_expectednumber—この間隔で7日間に見込まれる決済回数。 省略される場合あり
other_contracts[].settled.cum_7d_completeboolean—7日間のウィンドウ内に欠落した決済がない場合はtrue。 省略される場合あり
other_contracts[].settled.cum_30dnumber—過去30日間の決済済みレートの合計。 省略される場合あり
other_contracts[].settled.n_30dnumber—過去30日間に確認された決済回数。 省略される場合あり
other_contracts[].settled.n_30d_expectednumber—この間隔で30日間に見込まれる決済回数。 省略される場合あり
other_contracts[].settled.cum_30d_completeboolean—30日間のウィンドウ内に欠落した決済がない場合はtrue。 省略される場合あり
other_contracts[].settled.history_fromnumbermsこの契約について保持している最も古い決済記録。 省略される場合あり
coverageobject—上記の数値に含まれるものと含まれないもの。他のソースと合計値を比較する前に、まずこの内容を比較してください。
coverage.settle_history_exchangesarray—実際の決済記録を収集している取引所。
coverage.settle_history_exchanges[]string—この銘柄について、実際の資金調達決済レコードを収集している取引所のID。
coverage.no_settle_historyarray—決済履歴の公開ソースがない取引所。これらの`settled`はnullになります。
coverage.no_settle_history[]string—決済履歴が収集されていない代表契約の取引所ID。そのため、その`settled`ブロックはnullになります。
coverage.unknown_intervalarray—資金調達間隔を判定できなかった行。 この表の生成に使用したサンプルでは空
coverage.no_liveness_excludedarray—契約に取引の兆候がない（最近のティッカー、建玉、気配値がない）ため除外された行。 この表の生成に使用したサンプルでは空
methodobject—このレスポンスで使用した計算式を平文で記述したもの。
method.ratestring—取引所が公表する現在期間の資金調達率。
method.rate_8hstring—8時間に正規化したレート：rate × 8 / interval_h。
method.apr_pctstring% per year年率換算のパーセント値。
method.aggregatestring—取引所横断の集計値。
method.settledstring—この契約の実際の決済記録。取引所に公開の履歴がない場合はnull。
method.predicted_ratestring—取引所が公表している場合は、次回期間の参考レート。それ以外はnull。
method.livenessstring—稼働していない契約を除外するルール（平文）：資金調達率の行は、1h以内のティッカー、3h以内の建玉、または3h以内のその契約自身の価格のいずれかがある場合にのみ算入されます。

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

レスポンス例

/api/sd/funding?coin=BTC · 実際のレスポンス（2026-11-13 03:57:42 UTCに取得）。 長い配列とマップは表示用に短縮しています：by_exchangeは23件; other_contractsは18件; coverage.settle_history_exchangesは16件。

  • {
    • "success": true,
    • "coin": "BTC",
    • "now": 1794542262267,
    • "unit": "fraction",
    • "avg_8h": 0.00006731782608695654,
    • "oi_weighted_8h": 0.00005745116946489526,
    • "apr_pct": 6.2909,
    • "apr_basis": "oi_weighted_8h",
    • "n_exchanges": 23,
    • "n_normalized": 23,
    • "n_unknown_interval": 0,
    • "settled_cum_7d": {
      • "avg": 0.0016089506666666666,
      • "oi_weighted": 0.0015317230977727185,
      • "n": 15
      },
    • "settled_cum_30d": {
      • "avg": 0.0066857086666666675,
      • "oi_weighted": 0.006362887957085279,
      • "n": 15
      },
    • "by_exchange": [
      • { … 17 },
      • { … 17 }
      ],
    • "other_contracts": [
      • { … 17 },
      • { … 17 }
      ],
    • "coverage": {
      • "settle_history_exchanges": [ … 8 ],
      • "no_settle_history": [ … 7 ],
      • "unknown_interval": [],
      • "no_liveness_excluded": []
      },
    • "method": {
      • "rate": "current funding-period rate as published by the exchange (charged at next settlement; may change until then)",
      • "rate_8h": "rate × 8 / interval_h (rows with unknown interval excluded from aggregates)",
      • "apr_pct": "per exchange: rate_8h × 3 × 365 × 100; headline apr_pct = oi_weighted_8h × 3 × 365 × 100 (falls back to avg_8h when no OI weights; see apr_basis). Simple annual…",
      • "aggregate": "one contract per exchange (largest OI); avg_8h = simple mean; oi_weighted_8h = Σ(rate_8h × oi_usd)/Σoi_usd",
      • "settled": "actual settlement records collected from each exchange funding-history endpoint; cum = Σ settled rates in window",
      • "predicted_rate": "exchange-published indicative/next-period rate where available",
      • "liveness": "a funding row is used only if the same contract on the same exchange has a ticker within 1h, open interest within 3h, or a self-collected quote within 3h; rows …"
      }
    }

検証済みサンプル

上の例に加えて、プローブは以下のパラメータでもこのエンドポイントを呼び出し、毎回スキーマを検証しています。

パラメータHTTPレイテンシ結果
coin=ETH20043 ms合格
coin=SOL20044 ms合格
coin=ARKM20041 ms合格
—4001 ms合格 想定どおりのエラーを返す

2026-11-13 03:57:42 UTCにチェック

詳細

認証
不要。公開エンドポイントです。
レート制限
IPごとに毎分1200リクエスト
サーバーキャッシュ
20s
エッジマイクロキャッシュ
10s
更新頻度
ほとんどの取引所は60 sごと（ティッカーと同時に書き込み。binanceは専用の60 sジョブ）。残りの資金調達率ジョブとコイン証拠金型契約は5 minごと。決済記録は1時間ごと
ウィンドウ
最新スナップショット（ティッカー/OIが稼働中の契約における、4 h以内の資金調達率の行）。7 dおよび30 dの決済済み合計
データソース
自社のコレクターが24の無期限先物取引所（binance、okx、bybit、bitget、gate、hyperliquidなど）の公開REST APIからポーリングした現在の資金調達率です。
取引所カバレッジ
現在のレートは24取引所。決済履歴は16取引所（binance、okx、bybitのコイン証拠金型無期限先物は別途保持）
単位
unit = 'fraction' (0.0001 = 0.01%); rate_8h normalized to 8 h; apr_pct in percent; times in Unix ms
算出方法
one contract per exchange (largest OI); rate_8h = rate x 8 / interval_hours; avg_8h = simple mean; oi_weighted_8h = SUM(rate_8h x oi_usd) / SUM(oi_usd); apr_pct = rate_8h x 3 x 365 x 100; settled 7 d / 30 d = SUM of settlement records with a completeness flag (>= 90% of expected settlements)
タイムスタンプ
フィールドの説明に別途記載がない限り、Unixエポックミリ秒（UTC）
レスポンス形式
json
安定性
安定版
提供開始
2026-11-11

ライブステータス

利用可能2026-11-13 03:57:42 UTCにチェックHTTP 20052 msスキーマ一致最新データポイントは1s前

可用性（過去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/sd/funding利用可能
パラメータ

string — Coin symbol; 400 when missing. Alias: `base`.

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