/api/stock-detail/:underlying
GET利用可能

株式原資産の詳細

株式原資産の詳細(取引所別の契約気配値)

GET/api/stock-detail/:underlying

リクエスト

クエリパラメータ

名前型必須デフォルト指定可能な値説明
underlying pathstring必須——原資産ティッカー(大文字に変換)。データがない場合は404。 例: SOXL

「path」と表示されたパラメータはURLの一部です。

リクエスト例

curl -s "https://www.coinboss.com/api/stock-detail/SOXL"

レスポンスフィールド

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

フィールド型単位説明
successboolean—リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。
nownumbermsレスポンスを生成した時点のサーバー時刻。
sourcestring—値の取得元。
dataobject—ペイロード。
data.underlyingstring—原資産である株式 / 指数 / コモディティのシンボル。
data.namestring—名前。
data.typestring—種別。
data.price_avgnumber—取引所横断の平均価格。
data.change_24hnumber—24h変化。
data.high_24hnumber—24h高値。
data.low_24hnumber—24h安値。
data.volume_24hnumber—24h出来高。
data.oi_usdnumberUSDUSD建て想定元本での建玉。
data.funding_weightednumberfraction各取引所の現在の資金調達率の建玉加重平均。各レートはその取引所の資金調達間隔あたりの値です。建玉を報告する取引所がない場合はnull。
data.exchangesnumber—取引所。
data.marketsarray—市場。
data.markets[]object—市場。
data.markets[].exchangestring—取引所ID(小文字。例:`binance`)。
data.markets[].symbolstring—CoinBossが正規化した銘柄シンボル(例:BTCUSDT)。
data.markets[].pricenumber—建値通貨での直近価格(特記がない限りUSDまたはUSDT)。
data.markets[].change_pctnumber|null%変化率(%)。
data.markets[].volume_24hnumber—24h出来高。
data.markets[].fundingnumber—資金調達率のブロックまたは値。
data.markets[].funding_interval_hnumberh資金調達間隔。
data.markets[].oi_usdnumber|nullUSDUSD建て想定元本での建玉。
data.long_shortarray—ロング/ショートのブロック。
data.long_short[]object—ロング/ショートのブロック。
data.long_short[].exchangestring—取引所ID(小文字。例:`binance`)。
data.long_short[].symbolstring—CoinBossが正規化した銘柄シンボル(例:BTCUSDT)。
data.long_short[].ratio_typestring—比率の集計対象:`account`(全アカウント)、`topacc`(トップトレーダーのアカウント)、`position`(ポジションサイズ)、`taker`(テイカーの買い出来高と売り出来高)のいずれか。
data.long_short[].long_rationumber%この取引所と契約の最新のロング割合(`taker`の場合はテイカー買いの割合)。`long_ratio` + `short_ratio` = 100。
data.long_short[].short_rationumber%この取引所と契約の最新のショート割合(`taker`の場合はテイカー売りの割合)。`long_ratio` + `short_ratio` = 100。
data.liquidationsobject—この原資産(エイリアスを含む)の全取引所の清算。ウィンドウ`h1`、`h4`、`h12`、`h24`別で、`count_24h`も含みます。
data.liquidations.h1object—直近1時間に清算された想定元本(USD)。`long`、`short`、`total`に分かれます。
data.liquidations.h1.longnumber—ロング側の値。
data.liquidations.h1.shortnumber—ショート側の値。
data.liquidations.h1.totalnumber—合計。
data.liquidations.h4object—直近4時間に清算された想定元本(USD)。`long`、`short`、`total`に分かれます。
data.liquidations.h4.longnumber—ロング側の値。
data.liquidations.h4.shortnumber—ショート側の値。
data.liquidations.h4.totalnumber—合計。
data.liquidations.h12object—直近12時間に清算された想定元本(USD)。`long`、`short`、`total`に分かれます。
data.liquidations.h12.longnumber—ロング側の値。
data.liquidations.h12.shortnumber—ショート側の値。
data.liquidations.h12.totalnumber—合計。
data.liquidations.h24object—24時間の値。
data.liquidations.h24.longnumber—ロング側の値。
data.liquidations.h24.shortnumber—ショート側の値。
data.liquidations.h24.totalnumber—合計。
data.liquidations.count_24hnumber—24時間の件数。
data.klinesarray—ローソク足。
data.klines[]object—ローソク足。
data.klines[].tnumbermsタイムスタンプ。
data.klines[].onumberUSD`t`(UTC)に始まる日足の始値。
data.klines[].hnumberUSD`t`(UTC)に始まる日足の高値。
data.klines[].lnumberUSD`t`(UTC)に始まる日足の安値。
data.klines[].cnumberUSD`t`(UTC)に始まる日足の終値。当日がまだ終了していない間は最新価格です。
data.klines[].vnumber—値。

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

レスポンス例

/api/stock-detail/SOXL · 実際のレスポンス(2026-11-13 04:03:14 UTCに取得)。 長い配列とマップは表示用に短縮しています:data.klinesは180件; data.marketsは17件; data.long_shortは16件。

  • {
    • "success": true,
    • "now": 1794542594660,
    • "source": "in-house collection",
    • "data": {
      • "underlying": "SOXL",
      • "name": "Direxion Semiconductor Bull 3x",
      • "type": "etf",
      • "price_avg": 63.41251867448196,
      • "change_24h": 1.2395980314621862,
      • "high_24h": 69.02,
      • "low_24h": 58.4,
      • "volume_24h": 10951946654.019999,
      • "oi_usd": 515358908.96,
      • "funding_weighted": 0.000009575856229677082,
      • "exchanges": 17,
      • "markets": [ … 2 ],
      • "long_short": [ … 2 ],
      • "liquidations": { … 5 },
      • "klines": [ … 2 ]
      }
    }

詳細

認証
不要。公開エンドポイントです。
レート制限
IPごとに毎分1200リクエスト
サーバーキャッシュ
60s
エッジマイクロキャッシュ
10s
更新頻度
ティッカーは1 minごと。OI/資金調達率は5 minごと。APIキャッシュ60 s
ウィンドウ
清算は1h / 4h / 12h / 24h。日足は最大180本
データソース
トークン化株式/伝統金融の原資産1つの詳細です。取引所別の契約、資金調達率、OI、ロング/ショート、清算、日足を含み、いずれも自社で収集した取引所データに基づきます。
取引所カバレッジ
自社のトークン化株式レジストリにある原資産。該当がない場合は404
ページネーション
なし
単位
USD; funding as decimal rate per interval
算出方法
funding_weighted = OI-weighted mean of raw rates (not normalized to 8h); quotes deviating more than 10% from the median with zero volume are dropped
タイムスタンプ
フィールドの説明に別途記載がない限り、Unixエポックミリ秒(UTC)
レスポンス形式
json
安定性
安定版

ライブステータス

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

可用性(過去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/stock-detail/:underlying利用可能
パラメータ

string — Underlying ticker (upper-cased); 404 when no data.

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