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

ホームページ用マクロカード

ホームページ用マクロカード（株価指数、ドル、金など）

GET/api/home/macro-cards

リクエスト

このエンドポイントにパラメータはありません。

リクエスト例

curl -s "https://www.coinboss.com/api/home/macro-cards"

レスポンスフィールド

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

フィールド型単位説明
successboolean—リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。
updated_atnumbermsこの行が最後に更新された時刻。
mcapobject—時価総額。
mcap.latestnumber—最新のレコード。
mcap.datestring—暦日（UTC）。
mcap.chg24h_pctnumber%24hの変化率（%）。
mcap.sparkarray—スパークライン用の直近の短い系列。
mcap.spark[]number—スパークライン用の直近の短い系列。
mcap.has_cmcboolean—`spark`のいずれかのポイントが、サイト自身の日次スナップショットではなく、バックフィルした第三者の履歴に由来する場合はtrue。
volumeobject—出来高。
volume.futuresnumber—先物市場のブロックまたは値。
volume.spotnumber—現物市場のブロックまたは値。
volume.tsnumbermsタイムスタンプ。
volume.sparkarray—スパークライン用の直近の短い系列。
volume.spark[]object—スパークライン用の直近の短い系列。
volume.spark[].tnumbermsタイムスタンプ。
volume.spark[].fnumberUSDその3時間バケット内の24h先物出来高の値の平均。
volume.spark[].snumberUSDその3時間バケット内の24h現物出来高の値の平均。
btc_candlesarray—オーバーレイ用のBTCローソク足。
btc_candles[]array—オーバーレイ用のBTCローソク足。
btc_candles[][]number—オーバーレイ用のBTCローソク足。
fngobject—恐怖強欲指数カード：最新の`value`、そのラベル`cls`、直近の日次値の`spark`。データがない場合はnull。
fng.valuenumber—値。
fng.clsstring—恐怖強欲指数の最新値のテキストラベル。例：`Fear`、`Greed`。
fng.sparkarray—スパークライン用の直近の短い系列。
fng.spark[]number—スパークライン用の直近の短い系列。
stablecoinobject—ステーブルコインカード：流通総額（USD、`total`）、ステーブルコインの数（`count`）、その24hおよび7dの変化。
stablecoin.totalnumber—合計。
stablecoin.countnumber—項目数。
stablecoin.chg24h_pctnumber%24hの変化率（%）。
stablecoin.chg7d_pctnumber%7日間の変化率（%）。
liqobject—清算の値またはブロック。
liq.totalnumber—合計。
liq.longnumber—ロング側の値。
liq.shortnumber—ショート側の値。
liq.chg24h_pctnumber%24hの変化率（%）。
liq.sparkarray—スパークライン用の直近の短い系列。
liq.spark[]number—スパークライン用の直近の短い系列。

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

レスポンス例

/api/home/macro-cards · 実際のレスポンス（2026-11-13 03:59:25 UTCに取得）。 長い配列とマップは表示用に短縮しています：fng.sparkは30件; liq.sparkは57件; mcap.sparkは90件; btc_candlesは42件; volume.sparkは57件。

  • {
    • "success": true,
    • "updated_at": 1794542365066,
    • "mcap": {
      • "latest": 2476085584564.88,
      • "date": "2026-11-13",
      • "chg24h_pct": -3.19,
      • "spark": [ … 8 ],
      • "has_cmc": false
      },
    • "volume": {
      • "futures": 216570771117.84,
      • "spot": 66073226871.26,
      • "ts": 1794541800000,
      • "spark": [ … 2 ]
      },
    • "btc_candles": [
      • [ … 5 ],
      • [ … 5 ]
      ],
    • "fng": {
      • "value": 20,
      • "cls": "Extreme Fear",
      • "spark": [ … 8 ]
      },
    • "stablecoin": {
      • "total": 288099833329.21,
      • "count": 353,
      • "chg24h_pct": -0.53,
      • "chg7d_pct": -1.71
      },
    • "liq": {
      • "total": 1363532410.6799946,
      • "long": 1267567542.2399952,
      • "short": 95964868.44,
      • "chg24h_pct": 501.86,
      • "spark": [ … 8 ]
      }
    }

詳細

認証
不要。公開エンドポイントです。
レート制限
IPごとに毎分1200リクエスト
サーバーキャッシュ
2m
エッジマイクロキャッシュ
10s
更新頻度
時価総額は日次、出来高は10 minごと、ローソク足は5 minごと、恐怖強欲指数は日次、ステーブルコインは10 minごと。APIキャッシュ120 s
ウィンドウ
時価総額は90日間、出来高は7日間、BTCは4時間足、恐怖強欲指数は30日間、清算は24h
データソース
ホームページ用マクロカードです。時価総額合計（第三者のマーケットデータアグリゲーターによる時価総額の日次スナップショット）、先物出来高と清算（取引所データ）、BTCのローソク足（Binance）、恐怖強欲指数（alternative.me）、ステーブルコイン供給量（第三者ソース）で構成されます。
取引所カバレッジ
市場全体
ページネーション
なし
単位
USD; changes in percent; Fear & Greed 0-100
タイムスタンプ
フィールドの説明に別途記載がない限り、Unixエポックミリ秒（UTC）
レスポンス形式
json
安定性
ベータ

ライブステータス

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

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

パラメータはありません。

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