加密货币上币 公告 API

面向加密货币交易所上币公告与通知的实时 WebSocket API。连接后即可接收 Binance、Upbit、Bithumb 和 Robinhood 上币公告的结构化 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
}

listingType 的完整最新取值列表见消息参考文档。

交易所过滤

在东京端点上使用 ?cex= 查询参数即可仅订阅特定交易所。首尔端点推送 Upbit 与 Bithumb，因此同样的过滤参数在那里同样适用。Robinhood 仅由美国端点 wss://us.cryptolisting.ws 提供，该端点不承载其他任何交易所。

wss://cryptolisting.ws                       // 东京：Binance、Upbit、Bithumb — Robinhood 在 wss://us.cryptolisting.ws
wss://cryptolisting.ws?cex=binance             // 东京：仅 binance
wss://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 上币公告。

常见问题

该 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（加入资产与可交易事件，由 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://cryptolisting.ws（东京）分发完整推送，是默认的全球端点。wss://kr.cryptolisting.ws（首尔）分发 Upbit 与 Bithumb，并针对同机房部署在韩国的交易机器人做了优化——它在检测侧消除了首尔→东京的网络跳转。wss://us.cryptolisting.ws（N. Virginia）仅分发 Robinhood——加入资产与可交易事件——面向交易 Robinhood 的机器人。连接数上限与速率限制按每个端点独立计算。

如果连接断开会怎样？

服务器每 30 秒发送一次心跳；客户端应以相同的节奏发送 WebSocket ping。断开时，请使用指数退避重连（通常从 1 秒起，翻倍至最多 30 秒）。断连期间发出的上币消息不会被补发——如需过往检测记录的审计追溯，请参阅最新检测。