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

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

API の概要

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

プロパティ値
エンドポイント — 東京（グローバル）wss://jp.cryptolisting.ws — フルフィード（Binance、Upbit、Bithumb）、AWS Tokyo (ap-northeast-1a - apne1-az4)
エンドポイント — ソウル（韓国）wss://kr.cryptolisting.ws — Upbit + Bithumb、AWS Seoul (ap-northeast-2c - apne2-az3)。韓国拠点のボットにエンドツーエンドで超高速。
エンドポイント — N. Virginia（米国）wss://us.cryptolisting.ws — Robinhood のみ、AWS N. Virginia (us-east-1a - use1-az1)。
プロトコルWebSocket (RFC 6455)、TLS 1.2+
認証X-API-Key ヘッダー（すべてのエンドポイントで同一キー）
メッセージ形式バイナリフレーム、UTF-8 JSON
ディスパッチレイテンシ超高速（レート制限と接続上限はエンドポイントごとに独立して管理）
ハートビート30 秒ごと
取引所Binance、Upbit、Bithumb、Robinhood（今後追加予定）

この API が向いている人

  • 取引ボットやクオンツチーム — 上場、上場廃止、注意喚起のイベントに反応し、機械可読なトリガーが必要な場合。
  • アラート製品やダッシュボードの開発者 — 取引所ごとに連携を保守せずに Binance、Upbit、Bithumb、Robinhood を扱いたい場合。
  • 研究者 — タイムスタンプ付きの告知履歴が必要なら、無料の JSON フィードと最新の上場アーカイブを。告知ごとに価格反応チャート付きのページがあります。
  • ボットを作らない方へ。必要なのはおそらくアラートだけです。無料の Telegram チャンネルまたは X の @cryptolistingws (EN) をフォローしてください。

無料オプション

  • SpeedTrial — 本番フィードを +1 ms の猶予遅延で受け取る無料の WebSocket キー。ティッカーとタイトルは伏せ字。ベンチマーク用。15日間のキーで申請により更新可能。
  • FreeDelayed — ティッカーとタイトルを含む全フィードを +240 ms の遅延で受け取る WebSocket キー。初月無料、以降は全取引所込みで月額 200 USDT。
  • 公開 JSON フィード — 最近の告知をまとめた静的ファイル。キー不要。リアルタイムのストリームではありません。
  • Telegram チャンネルと X アカウント — 人が読むための無料アラート。

有料プラン — Basic（+20 ms）と Premium（遅延なし）— は取引所ごと・月ごとの USDT 建てです。料金と料金シミュレーターをご覧ください。無料・有料を問わず、キーはすべて Telegram で申請して発行され、セルフ登録はありません。

自作するか、この API を使うか

取引所の告知は自分で収集することもできます。その場合は、取引所ごとに収集プログラムを作って動かし、人が読むために複数の言語で書かれた告知タイトルを解析し、告知の種類ごとに分類し、形式が変わっても昼夜を問わず動かし続ける必要があります。1つの取引所だけを取引し、仕組み全体を自分で管理したい場合には妥当な選択です。

複数の取引所を1本の接続で、ティッカーとイベント種別が抽出済みの安定したスキーマで、上場廃止と注意喚起解除が分類された状態で、さらに Robinhood のイベントまで必要ならこの API が合います。

メッセージ形式

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

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

listingType の最新の全値一覧はメッセージリファレンスに記載されています。

取引所フィルタリング

東京エンドポイントで ?cex= クエリパラメータを使うと、特定の取引所のみを購読できます。ソウルエンドポイントは Upbit と Bithumb を配信しているため、同じフィルタがそちらでも利用できます。Robinhood は US エンドポイント 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 エポックからのマイクロ秒単位のタイムスタンプが 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 の上場通知。

ボットを作るなら、手順付きの 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 キーで 3 つすべてのエンドポイントを認証できます — 取引する取引所ではなく、ボットの所在地で選んでください。

どの取引所に対応していますか？

Binance（現物上場、先物上場、上場廃止、HODLer Airdrop、Monitoring Tag の extend / remove）、Upbit と Bithumb（KRW マーケットの現物上場、注意喚起の解除、現物上場廃止 — 韓国の注意喚起ライフサイクルのうち取引で行動可能な段階）、および Robinhood（Robinhood Listing と Robinhood Live のイベント、wss://us.cryptolisting.ws から配信）です。取引所は購読者の要望に応じて追加されます。東京エンドポイントで ?cex= クエリパラメータを使ってフィルタリングできます。

どうやって認証しますか？

WebSocket アップグレードリクエストに X-API-Key ヘッダーを含めてください。キーは Telegram の @CLWfeed までご連絡いただくと取得できます。同じキーが 3 つすべてのエンドポイントで機能します。コードサンプルは 認証ドキュメント をご覧ください。

メッセージのレイテンシはどれくらいですか？

ディスパッチレイテンシは超高速です。各アナウンスにはマイクロ秒精度の 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 を配信する US エンドポイントへ、最も低いエンドツーエンドレイテンシを得られます。

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

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 秒まで倍増）で再接続してください。切断中に配信された上場は再送されません — 過去の検出の監査証跡は 最新の検出 をご覧ください。

API キーを取得

始めるには Telegram でご連絡ください。プランを選ぶには 料金プラン を、詳しくは ドキュメント 全体をご覧ください。すぐに使えるアラートをご希望ですか？当社の Telegram または X の上場アラートチャンネルをフォローしてください。

Telegram で API キーを取得