GET可用
Pre-IPO 合約報價
Pre-IPO 合約報價
GET
/api/preipo/list請求
此端點不接受任何參數。
請求範例
curl -s "https://www.coinboss.com/api/preipo/list"回應欄位
欄位表由真實回應產生,因此列出的正是端點實際回傳的內容。路徑中的 a[] 代表陣列元素,{*} 代表以動態名稱(例如幣種或交易所)為鍵的物件。
| 欄位 | 型別 | 單位 | 說明 |
|---|---|---|---|
| success | boolean | — | 請求成功時為 true。失敗時回應內容為 `{ success: false, code, error, request_id }`。 |
| now | number | ms | 建立回應時的伺服器時間。 |
| source | string | — | 數值的來源。 |
| totals | object | — | 合計。 |
| totals.volume_24h | number | — | 24h 成交量。 |
| totals.underlyings | number | — | 標的代號。 |
| totals.contracts | number | — | 各合約的資料列。 |
| totals.exchanges | number | — | 交易所。 |
| count | number | — | 項目數。 |
| data | array | — | 回應主體資料。 |
| data[] | object | — | 回應主體資料。 |
| data[].underlying | string | — | 標的股票/指數/商品的代號。 |
| data[].name | string | — | 名稱。 |
| data[].type | string | — | 類型。 |
| data[].exchanges | number | — | 交易所。 |
| data[].volume_24h | number | — | 24h 成交量。 |
| data[].oi_usd | number | USD | 持倉量,以 USD 名義價值計。 |
| data[].price_avg | number | — | 跨交易所平均價格。 |
| data[].change_24h | number | — | 24h 漲跌幅。 |
| data[].price_min | number | USD | 上架此 pre-IPO 合約的各交易所中最低的最新價(超過 12 小時的行情不計);沒有任何交易所有價格時為 null。 |
| data[].price_max | number | USD | 上架此 pre-IPO 合約的各交易所中最高的最新價(超過 12 小時的行情不計);沒有任何交易所有價格時為 null。 |
| data[].markets | array | — | 市場。 |
| data[].markets[] | object | — | 市場。 |
| data[].markets[].exchange | string | — | 交易所 ID,小寫(例如 `binance`)。 |
| data[].markets[].symbol | string | — | 經 CoinBoss 正規化的交易品種代號(例如 BTCUSDT)。 |
| data[].markets[].price | number | — | 以計價貨幣表示的最新價格(除非另有註明,否則為 USD 或 USDT)。 |
| data[].markets[].change_pct | number|null | % | 漲跌幅(百分比)。 |
| data[].markets[].volume_24h | number | — | 24h 成交量。 |
| data[].markets[].funding | number | — | 資金費率區塊或數值。 |
| data[].markets[].oi_usd | number|null | USD | 持倉量,以 USD 名義價值計。 |
產生於 2026-11-11 23:00 UTC,依據 1 筆真實回應。
回應範例
/api/preipo/list · 真實回應,擷取於 2026-11-13 03:58:45 UTC。 較長的陣列與對應表已截短顯示:data 原有 3 個項目; data[].markets 原有 13 個項目。
- "success"true
- "now"1794542325199
- "source""in-house collection"
- "totals"
- "volume_24h"2217092315.81
- "underlyings"3
- "contracts"43
- "exchanges"18
- "count"3
- "data"
詳細資訊
- 身分驗證
- 無。公開端點。
- 速率限制
- 每個 IP 每分鐘 1200 次請求
- 伺服器快取
- 60s
- 邊緣微快取
- 10s
- 更新頻率
- 合約登錄表每 24 h;行情每 1 min;API 快取 60 s
- 時間視窗
- 24h
- 資料來源
- 加密貨幣交易所上架的 Pre-IPO(合成)永續合約,依標的彙總自交易所公開行情。
- 交易所覆蓋範圍
- 探測時為 18 家交易所上的 3 個標的/43 個合約
- 分頁
- 無
- 排序
- volume_24h 降冪
- 單位
- USD; change in percent
- 計算方法
- price and change are volume-weighted across exchanges; price_min / price_max show cross-exchange dispersion
- 時間戳記
- Unix epoch 毫秒(UTC),除非欄位說明另有註明
- 回應格式
- json
- 穩定性
- 穩定版
即時狀態
可用檢查於 2026-11-13 03:58:45 UTCHTTP 2004 ms結構描述相符
近 30 天可用率
409 次檢查中有 100% 通過
錯誤
所有端點的失敗回應都採用同一種結構。完整清單請見錯誤頁面。 錯誤與速率限制 →
| 錯誤碼 | HTTP | 意義 | 處理方式 |
|---|---|---|---|
| INVALID_PARAM | 400 | 缺少必填參數,或某個值不被接受。已知時,`param` 會指出是哪個參數。 | 請勿原樣重試;請修正請求。 |
| UNAUTHORIZED | 401 | 已送出 `CB-API-KEY` 標頭,但金鑰未知或已撤銷。公開資料不需要金鑰——請移除該標頭或改用有效的金鑰。 | 請勿原樣重試。 |
| FORBIDDEN | 403 | 此路由不屬於公開 API(內部或僅限帳戶使用)。 | 請勿重試。 |
| NOT_FOUND | 404 | 未知的路由,或所請求的幣種/交易所/基金不存在。 | 請勿重試;請對照目錄檢查路徑與識別碼。 |
| RATE_LIMITED | 429 | 請求數超過每分鐘上限。`Retry-After` 會指出需等待的秒數。 | 等待 `Retry-After` 指定的時間後,再以退避策略重試。 |
| INTERNAL | 500 | 非預期的伺服器錯誤。訊息刻意保持籠統;回報時請附上 `request_id`。 | 幾秒後重試一次;若問題持續,請附上請求 ID 回報。 |
| UPSTREAM_FAILED | 503 | 此端點背後的資料來源未及時回應。不會以過期或替代的數字代替回傳。 | 以退避策略重試;並查看狀態頁面。 |
| UNAVAILABLE | 501 / 503 | 資料集暫時尚未就緒(快取預熱中),或此端點目前尚無合法的公開來源。 | 稍後重試;目錄會標示出設計上即無法使用的端點。 |
| REQUEST_FAILED | 200 | 部分舊版端點會以 HTTP 200 回應但帶有 `success: false`。請務必檢查 `success`,而不只是 HTTP 狀態碼。 | 視訊息而定;請當作失敗的請求處理。 |
試用
GET
/api/preipo/list可用參數
無參數。
請求 URL
https://www.coinboss.com/api/preipo/list選擇一個端點並按下「送出請求」。回應內容、標頭與耗時會顯示在這裡。
此分類的其他端點
- 傳統金融永續合約爆倉總覽 /api/liquidations/tradfi
- 時間視窗內有爆倉的傳統金融標的清單 /api/liquidations/tradfi-asset-list
- 傳統金融永續合約各標的爆倉排行 /api/liquidations/tradfi-assets
- 傳統金融永續合約的各交易所爆倉拆分 /api/liquidations/tradfi-exchanges
- 傳統金融永續合約爆倉資料流 /api/liquidations/tradfi-feed
- 傳統金融永續合約的最大爆倉單 /api/liquidations/tradfi-largest
- 傳統金融永續合約的多時間視窗爆倉總額 /api/liquidations/tradfi-overview
- 單一傳統金融標的的爆倉總覽 /api/liquidations/tradfi-symbol
- 單一傳統金融標的的爆倉時間序列 /api/liquidations/tradfi-symbol-chart
- 單一傳統金融標的的各交易所爆倉拆分 /api/liquidations/tradfi-symbol-exchanges
- 單一傳統金融標的的最大爆倉單 /api/liquidations/tradfi-symbol-largest
- 有爆倉歷史的傳統金融標的 /api/liquidations/tradfi-symbols
- 傳統金融爆倉表 /api/liquidations/tradfi-table
- 傳統金融永續合約的爆倉總額時間序列 /api/liquidations/tradfi-total-chart
- Pre-IPO 合約報價 /api/preipo/list
- 股票標的清單 /api/stock-detail-list
- 股票標的詳情 /api/stock-detail/:underlying
- 股票交易品種清單 /api/stocks/list
- 交易所上架的股票永續合約/代幣化股票 /api/tabs17/exchange-stocks
- 加密概念股報價 /api/tabs17/stocks