GET利用可能
マージン借入金利マトリックス
マージン借入金利マトリックス(銘柄 × 取引所)
GET
/api/margin-fee/matrix3時間より古いセルは`cells`内で`is_stale: true`が付き、6時間より古いセルは返されません。
リクエスト
クエリパラメータ
| 名前 | 型 | 必須 | デフォルト | 指定可能な値 | 説明 |
|---|---|---|---|---|---|
| vipLevel | integer | 任意 | 0 | ≥ 0 · ≤ 9 | VIPレベル(Binanceのみ)。対応範囲外の値は0として扱われます。 例: 0 |
リクエスト例
curl -s "https://www.coinboss.com/api/margin-fee/matrix?vipLevel=0"レスポンスフィールド
フィールド表は実際のレスポンスから生成しているため、エンドポイントが返す内容をそのまま反映しています。パスでは、配列の要素をa[]、銘柄や取引所などの動的な名前をキーとするオブジェクトを{*}で表します。
| フィールド | 型 | 単位 | 説明 |
|---|---|---|---|
| success | boolean | — | リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。 |
| exchanges | array | — | 取引所。 |
| exchanges[] | string | — | 取引所。 |
| data | array | — | ペイロード。 |
| data[] | object | — | ペイロード。 |
| data[].coin | string | — | 銘柄シンボル(大文字。例:BTC)。 |
| data[].daily | object | — | 日次の値。 |
| data[].daily.binance | number | — | 取引所`binance`の値(キーは取引所ID)。 |
| data[].daily.bitget | number | — | 取引所`bitget`の値(キーは取引所ID)。 |
| data[].daily.bybit | number | — | 取引所`bybit`の値(キーは取引所ID)。 省略される場合あり |
| data[].daily.gate | number | — | 取引所`gate`の値(キーは取引所ID)。 |
| data[].daily.okx | number | — | 取引所`okx`の値(キーは取引所ID)。 |
| data[].annual | object | — | 取引所別の年率換算マージン借入金利(日次金利 × 365)。小数で表します(0.0048 = 0.48 %)。キーは取引所IDで、6時間以内に更新されたセルのみを含みます。 |
| data[].annual.binance | number | — | 取引所`binance`の値(キーは取引所ID)。 |
| data[].annual.bitget | number | — | 取引所`bitget`の値(キーは取引所ID)。 |
| data[].annual.bybit | number | — | 取引所`bybit`の値(キーは取引所ID)。 省略される場合あり |
| data[].annual.gate | number | — | 取引所`gate`の値(キーは取引所ID)。 |
| data[].annual.okx | number | — | 取引所`okx`の値(キーは取引所ID)。 |
| data[].updated_at | number | ms | この行が最後に更新された時刻。 |
| data[].cells | object | — | マトリックスのセル。 動的キー: binance,bitget,gate,okx |
| data[].cells.{*} | object | — | マトリックスのセル。 |
| data[].cells.{*}.updated_at | number | ms | この行が最後に更新された時刻。 |
| data[].cells.{*}.is_stale | boolean | — | 行が鮮度ウィンドウより古い場合はtrue。鮮度切れの行は合計に使用されません。 |
| updated_at | number | ms | この行が最後に更新された時刻。 |
| vipLevel | number | — | Binanceの列が対象とするBinanceのVIPティア(0〜9)。リクエストの値をそのまま返します。その他の取引所は常に基本ティアの値を表示します。 |
| vipSupport | object | — | 取引所ごとに選択可能なVIPティア。キーは取引所IDで、含まれるのは`binance`のみです。値は鮮度内のデータがあるティアの一覧です。 |
| vipSupport.binance | array | — | 取引所`binance`の値(キーは取引所ID)。 |
| vipSupport.binance[] | number | — | 取引所`binance`の値(キーは取引所ID)。 |
| data_updated_at | number | ms | タイムスタンプ。 |
| stale_threshold_ms | number | ms | これより古い金利には`is_stale`のフラグが付きます。 |
| hide_threshold_ms | number | ms | これより古い金利はマトリックスから除かれ、`hidden_stale`に記載されます。 |
| stale_exchanges | array | — | 最新の金利が`stale_threshold_ms`より古い取引所。 |
| stale_exchanges[] | object | — | 取引所IDと、その最新の金利の時刻(`last_updated_at`、ms)。 |
| stale_exchanges[].exchange | string | — | 取引所ID(小文字。例:`binance`)。 |
| stale_exchanges[].last_updated_at | number | ms | タイムスタンプ。 |
| hidden_stale | array | — | `hide_threshold_ms`より古いためマトリックスから除かれた金利。 |
| hidden_stale[] | object | — | 除かれた金利1件の取引所、銘柄、時刻(`updated_at`、ms)。 |
| hidden_stale[].exchange | string | — | 取引所ID(小文字。例:`binance`)。 |
| hidden_stale[].coin | string | — | 銘柄シンボル(大文字。例:BTC)。 |
| hidden_stale[].updated_at | number | ms | この行が最後に更新された時刻。 |
| hidden_stale[].is_stale | boolean | — | 行が鮮度ウィンドウより古い場合はtrue。鮮度切れの行は合計に使用されません。 |
2026-11-11 23:00 UTCに1件の実レスポンスから生成。
レスポンス例
/api/margin-fee/matrix?vipLevel=0 · 実際のレスポンス(2026-11-13 03:57:32 UTCに取得)。 長い配列とマップは表示用に短縮しています:dataは14件; data[].cellsは5件; hidden_staleは15件; vipSupport.binanceは10件。
- "success"true
- "exchanges"
- "binance"
- "okx"
- "bybit"
- "bitget"
- "gate"
- "data"
- "updated_at"1794542252596
- "vipLevel"0
- "vipSupport"
- "binance"
- "data_updated_at"1794540604531
- "stale_threshold_ms"10800000
- "hide_threshold_ms"21600000
- "stale_exchanges"
- "hidden_stale"
詳細
- 認証
- 不要。公開エンドポイントです。
- レート制限
- IPごとに毎分1200リクエスト
- サーバーキャッシュ
- 60s
- エッジマイクロキャッシュ
- 10s
- 更新頻度
- 30 minごと。6 hより古い行は破棄。APIキャッシュ60 s
- ウィンドウ
- 現在のレート
- データソース
- 取引所・銘柄別のマージン借入金利です。各取引所の公開マージン金利エンドポイントから収集しています。
- 取引所カバレッジ
- 6取引所(binance、okx、bybit、bitget、gate、kucoin)× 14銘柄。vipLevel 0〜9はbinanceのみに適用
- ページネーション
- なし
- 単位
- daily rate and annualized rate as decimals
- 算出方法
- annual = daily * 365; gate publishes an annual rate, daily = annual / 365; binance rate is divided by 1.05 to remove the BNB-discount markup
- タイムスタンプ
- フィールドの説明に別途記載がない限り、Unixエポックミリ秒(UTC)
- レスポンス形式
- json
- 安定性
- 安定版
ライブステータス
利用可能2026-11-13 03:57:32 UTCにチェックHTTP 2003 msスキーマ一致最新データポイントは0s前
可用性(過去30日間)
411回のチェック中99.76%が合格
エラー
失敗した呼び出しは、すべてのエンドポイントで共通の形式で返されます。一覧はエラーページにあります。 エラーとレート制限 →
| コード | HTTP | 意味 | 対処方法 |
|---|---|---|---|
| INVALID_PARAM | 400 | 必須パラメータが不足しているか、値が受け付けられません。該当するパラメータが特定できる場合は、`param`にその名前が入ります。 | そのまま再試行せず、リクエストを修正してください。 |
| UNAUTHORIZED | 401 | `CB-API-KEY`ヘッダーが送信されましたが、キーが不明か失効済みです。公開データにキーは不要です。ヘッダーを外すか、有効なキーを使用してください。 | そのまま再試行しないでください。 |
| FORBIDDEN | 403 | このルートは公開APIに含まれません(内部用またはアカウント専用)。 | 再試行しないでください。 |
| NOT_FOUND | 404 | 不明なルートであるか、リクエストされた銘柄 / 取引所 / ファンドが存在しません。 | 再試行せず、パスと識別子をカタログと照合してください。 |
| RATE_LIMITED | 429 | リクエスト数が1分あたりの上限を超えました。`Retry-After`に待機すべき秒数が示されます。 | `Retry-After`で示された時間だけ待ってから、バックオフ付きで再試行してください。 |
| INTERNAL | 500 | 予期しないサーバーエラーです。メッセージは意図的に汎用的な内容にしています。報告の際は`request_id`を引用してください。 | 数秒後に1回だけ再試行してください。解消しない場合は、リクエストIDを添えて報告してください。 |
| UPSTREAM_FAILED | 503 | このエンドポイントの背後にあるデータソースが時間内に応答しませんでした。鮮度切れの数値や代替の数値を代わりに返すことはありません。 | バックオフ付きで再試行し、ステータスページを確認してください。 |
| UNAVAILABLE | 501 / 503 | データセットが一時的に準備できていない(キャッシュのウォームアップ中)か、このエンドポイントに適法な公開ソースがまだありません。 | 時間をおいて再試行してください。仕様上利用できないエンドポイントは、カタログに明示されています。 |
| REQUEST_FAILED | 200 | 一部の古いエンドポイントは、HTTP 200で`success: false`を返します。HTTPステータスだけでなく、必ず`success`を確認してください。 | メッセージによって異なります。失敗したリクエストとして扱ってください。 |
試してみる
GET
/api/margin-fee/matrix利用可能パラメータ
integer · デフォルト 0 · 最小 0 · 最大 9 — VIP level (Binance only). A value outside the supported range is treated as 0.
リクエストURL
https://www.coinboss.com/api/margin-fee/matrix?vipLevel=0エンドポイントを選択して「リクエストを送信」を押してください。レスポンス、ヘッダー、所要時間がここに表示されます。
このカテゴリの他のエンドポイント
- 銘柄ヒートマップデータ /api/coin-heatmap
- 全銘柄リスト /api/coins/all
- 銘柄検索 /api/coins/search
- 銘柄ページの取引所テーブル /api/currency/ex-table
- 銘柄の資金フロー /api/currency/flows
- ナビゲーション用の銘柄リスト /api/currency/list
- 1銘柄の取引所別市場 /api/currency/markets
- 銘柄詳細の概要 /api/currency/overview
- 銘柄の期間別価格パフォーマンス /api/currency/performance
- 1銘柄の現物テイカー純流入 /api/currency/spot-netflow
- マージン借入金利マトリックス /api/margin-fee/matrix
- マージン借入金利 /api/margin/rates
- 上昇・下落銘柄(出来高の下限あり) /api/market/gainers-losers
- 時価総額上位銘柄の値動きスナップショット /api/market/top-movers
- 月次/四半期/年次リターンマトリックス /api/p3/btc-returns
- 日次リターンマトリックス /api/p3/btc-returns-daily
- 週次リターンマトリックス /api/p3/btc-returns-weekly
- 上昇・下落銘柄(先物または現物) /api/p3/gainers-losers
- 1時間足ローソク足 /api/p3/klines
- ボラティリティ概要 /api/p3/volatility
- 1銘柄のボラティリティ履歴 /api/p3/volatility/series
- 現物銘柄のマーケットリスト /api/spot/coins
- 銘柄の出来高ページデータ /api/volume/coin