加密貨幣上幣 公告 API

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

API 概覽

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

本 API 適合誰

• 交易機器人與量化團隊：需要對上幣、下幣與警示事件作出反應，並需要機器可讀的觸發訊號。
• 提醒產品與儀表板的開發者：希望涵蓋 Binance、Upbit、Bithumb 與 Robinhood，而不必為每家交易所個別維護串接。
• 研究人員：需要附時間戳的公告歷史，可使用免費的 JSON 資料與最新上幣存檔，每則公告都有附價格反應圖的獨立頁面。
• 不寫機器人？你需要的可能只是提醒：關注免費的 Telegram 頻道或 X 上的 @cryptolistingws (EN)。

免費選項

• SpeedTrial —— 免費 WebSocket 金鑰，接入正式資料流，帶 +1 ms 禮讓延遲；代幣代號與標題會被隱藏。用於基準測試。金鑰效期 15 天，可申請續期。
• FreeDelayed —— WebSocket 金鑰，提供含代幣代號與標題的完整資料，延遲 +240 ms。首月免費，之後每月 200 USDT，含所有交易所。
• 公開 JSON 資料 —— 以靜態檔案提供近期公告，無需金鑰。不是即時資料流。
• Telegram 頻道與 X 帳號 —— 供人閱讀的免費提醒。

付費檔位 —— Basic（+20 ms）與 Premium（無延遲）—— 依交易所、按月以 USDT 計價：請參閱價格與價格計算機。無論免費或付費，所有金鑰都在 Telegram 申請核發，沒有自助註冊。

自行建置，還是使用本 API

你也可以自行蒐集交易所公告。這表示要為每家交易所建置並執行蒐集程式，解析以多種語言寫給人看的公告標題，為每類公告分類，並在格式變動時讓一切日夜不停地運作。如果你只交易一家交易所，並希望完全掌控自己的系統，這是合理的選擇。

如果你需要一條連線涵蓋多家交易所、代幣代號與事件類型已擷取的穩定資料結構、已分類的下幣與解除警示事件，以及 Robinhood 事件，就用本 API。

訊息格式

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

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

listingType 的完整最新取值列表見訊息參考文檔。

交易所過濾

在東京端點上使用 ?cex= 查詢引數，即可僅訂閱特定交易所。首爾端點承載 Upbit 與 Bithumb，因此同樣的過濾引數在那裡也適用。Robinhood 僅由美國端點 wss://us.cryptolisting.ws 提供，該端點不承載任何其他交易所。

wss://jp.cryptolisting.ws                    // 東京：Binance、Upbit、Bithumb — Robinhood 在 wss://us.cryptolisting.ws
wss://jp.cryptolisting.ws?cex=binance        // 東京：僅 Binance
wss://jp.cryptolisting.ws?cex=binance,upbit  // 東京：Binance + Upbit
wss://kr.cryptolisting.ws                    // 首爾：Upbit + Bithumb（韓國本地極速）

延遲測量

每條公告都包含兩個以微秒為單位的 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 上幣通知。

正在開發機器人？請參考逐步的 Python Binance 上幣狙擊機器人教學 (EN)。另有 Python Upbit 與 Bithumb 上幣機器人教學 (EN)。完整 API 參考涵蓋 WebSocket API (EN)、訊息結構 (EN) 以及 Python、Node.js、Go、Rust 程式碼範例 (EN)。

常見問題

API 使用什麼協議？

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

支援哪些交易所？

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

如何認證？

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

訊息延遲是多少？

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

三個端點有何區別？

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

如果連線中斷會怎樣？

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