加密货币上币 公告 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 使用什么协议？

基于 TLS 1.2+ 的 WebSocket (RFC 6455)。认证通过升级请求中的 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 东京 (ap-northeast-1a - apne1-az4) 的主机到东京端点的端到端延迟最低，位于 AWS 首尔 (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 秒）。断连期间发出的上币消息不会被补发——如需过往检测记录的审计追溯，请参阅最新检测。