暗号資産上場 アナウンス API

暗号資産取引所の上場アナウンスと通知のためのリアルタイム WebSocket API。接続すれば、Binance、Upbit、Bithumb の上場通知に関する構造化 JSON アラートを受信できます。

API の概要

CryptoListing.ws は、複数の暗号資産取引所からのリアルタイム上場アナウンスと通知をストリーミングする2 つの WebSocket ディスパッチエンドポイントを提供します。この API は、新しい取引所上場アナウンスを可能な限り最速で通知する必要がある自動取引システム向けに設計されています。同じ API キーで両方のエンドポイントを認証できます — ボットの所在地で選んでください。

メッセージ形式

すべてのアナウンスメッセージには、ティッカー、取引所、上場種別、そして 3 つのマイクロ秒精度のタイムスタンプが含まれます：

{
  "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 エポックからのマイクロ秒単位のタイムスタンプが 2 つ含まれます。ご自身のレイテンシを計算してください：

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 Airdrop、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 エンドポイントへ最も低いエンドツーエンドレイテンシを得られます。

2 つのエンドポイントはどう違いますか？

wss://cryptolisting.ws（東京）はフルフィードをストリーミングする既定のグローバルエンドポイントです。wss://kr.cryptolisting.ws（ソウル）は Upbit のみをストリーミングし、韓国にコロケーションされた取引ボット向けに最適化されています — 検出側でソウル → 東京のネットワークホップを排除します。接続上限とレート制限はエンドポイントごとに独立して管理されます。

接続が切れたらどうなりますか？

サーバーは 30 秒ごとにハートビートを送信します。クライアントは同じ間隔で WebSocket ping を送信すべきです。切断時は指数バックオフ（通常は 1 秒から開始し、30 秒まで倍増）で再接続してください。切断中に配信された上場は再送されません — 過去の検出の監査証跡は 最新の検出 をご覧ください。