加密貨幣上幣 公告 API

一個面向加密貨幣交易所上幣公告與通知的即時 WebSocket API。連線後即可接收 Binance、Upbit、Bithumb 上幣通知的結構化 JSON 提醒。

API 概覽

CryptoListing.ws 提供兩個 WebSocket 派送端點，即時串流推送來自多家加密貨幣交易所的上幣公告與通知。此 API 專為需要以最快速度獲得新交易所上幣公告通知的自動化交易系統而設計。同一個 API 金鑰可在兩個端點上認證 — 按您機器人的位置選擇即可。

訊息格式

每條公告訊息都包含交易代號、交易所、上幣型別，以及三個微秒精度時間戳：

{
  "type": "announcement",
  "title": "Binance Will List TOKEN (TOKEN)",
  "ticker": "TOKEN",
  "publisher": "binance",
  "listingType": "spot_listing",
  "detectedTimestampUs": 1710345000005000,
  "dispatchTimestampUs": 1710345000006000
}

上幣型別

交易所過濾

在東京端點上使用 ?cex= 查詢引數，即可僅訂閱特定交易所。首爾端點已獨家推送 Upbit 公告，因此該過濾引數在那裡是可選的。

wss://cryptolisting.ws                       // 東京：所有交易所（Binance、Upbit、Bithumb）
wss://cryptolisting.ws?cex=binance             // 東京：僅 Binance
wss://cryptolisting.ws?cex=binance,upbit       // 東京：Binance + Upbit
wss://kr.cryptolisting.ws                    // 首爾：僅 Upbit（韓國本地極速）

延遲測量

每條公告都包含兩個以微秒為單位的 UNIX 紀元時間戳。計算您的延遲：

dispatch_delay  = dispatchTimestampUs - detectedTimestampUs
network_delay   = your_receive_time  - dispatchTimestampUs
total_latency   = your_receive_time  - detectedTimestampUs

為什麼選擇這個上幣公告 API？

與基於 REST 輪詢的 API 或 Telegram 機器人不同，我們的 WebSocket API 在上幣通知被檢測到的瞬間即時派送。零複製廣播意味著公告訊息只序列化一次，並在所有訂閱者之間共享 — 沒有按客戶端序列化的額外開銷。這種架構無論訂閱者數量多少，都能實現始終如一的極速派送延遲。深入瞭解各交易所：Binance 上幣通知、Upbit 上幣公告、Bithumb 上幣通知。

常見問題

API 使用什麼協議？

WebSocket (RFC 6455)，執行於 TLS 1.2+ 之上。認證透過升級請求中的 X-API-Key HTTP 標頭完成。訊息為二進位訊框中的 UTF-8 JSON。同一個 API 金鑰可在兩個端點上認證 — 按您機器人的位置選擇，而非按您交易的交易所。

支援哪些交易所？

Binance（現貨上幣、合約上幣、下幣、HODLer 空投、Monitoring Tag extend／remove）、Upbit 與 Bithumb（KRW 市場現貨上幣、解除警示與現貨下幣 — 韓國警示生命週期中可用於交易的階段）。我們會根據訂閱者需求新增更多交易所。在東京端點上使用 ?cex= 查詢引數進行過濾。

如何認證？

在 WebSocket 升級請求中加入 X-API-Key 標頭。在 Telegram 上聯絡 @CLWfeed 取得您的金鑰。同一個金鑰在兩個端點上均有效。程式碼範例請參閱認證文件。

訊息延遲是多少？

派送延遲極速。每條公告都帶有微秒精度的 detectedTimestampUs 與 dispatchTimestampUs 欄位，讓您可以自行測量端到端效能。網路延遲取決於您機器人的位置：位於 AWS Tokyo (ap-northeast-1a - apne1-az4) 的主機到東京端點的端到端延遲最低，位於 AWS Seoul (ap-northeast-2c - apne2-az3) 的主機到首爾 Upbit 端點的端到端延遲最低。

兩個端點有何區別？

wss://cryptolisting.ws（東京）推送完整資料流，是預設的全球端點。wss://kr.cryptolisting.ws（首爾）僅推送 Upbit，並為同機房部署在韓國的交易機器人最佳化 — 它消除了檢測側的 首爾→東京 網路跳轉。連線上限與速率限制按端點獨立計算。

如果連線中斷會怎樣？

伺服器每 30 秒傳送一次心跳；客戶端應以相同節奏傳送 WebSocket ping。斷線後，請以指數退避方式重連（通常從 1 秒開始，逐次翻倍至最高 30 秒）。斷線期間發出的上幣不會重播 — 若需過往檢測的審計記錄，請參閱最新檢測。