Penyenaraian Kripto API Pengumuman

WebSocket API masa nyata untuk pengumuman dan notis penyenaraian bursa kripto. Sambung dan terima amaran JSON berstruktur untuk notis penyenaraian Binance, Upbit, Bithumb.

Gambaran keseluruhan API

CryptoListing.ws menyediakan dua titik akhir penghantaran WebSocket yang menstrim pengumuman dan notis penyenaraian masa nyata dari pelbagai bursa mata wang kripto. API ini direka untuk sistem trading automatik yang memerlukan pemberitahuan pengumuman penyenaraian bursa baharu sepantas mungkin. Kunci API yang sama mengesahkan pada kedua-dua titik akhir — pilih mengikut lokasi bot anda.

Format mesej

Setiap mesej pengumuman mengandungi ticker, bursa, jenis penyenaraian, dan tiga cap masa berketepatan mikrosaat:

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

Jenis penyenaraian

Penapisan bursa

Gunakan parameter pertanyaan ?cex= pada titik akhir Tokyo untuk melanggan bursa tertentu sahaja. Titik akhir Seoul sudah pun menstrim pengumuman Upbit secara eksklusif, jadi penapis adalah pilihan di sana.

wss://cryptolisting.ws                       // Tokyo: semua bursa (Binance, Upbit, Bithumb)
wss://cryptolisting.ws?cex=binance             // Tokyo: binance sahaja
wss://cryptolisting.ws?cex=binance,upbit       // Tokyo: binance + upbit
wss://kr.cryptolisting.ws                    // Seoul: Upbit sahaja (ultra-pantas dari Korea)

Pengukuran kependaman

Setiap pengumuman menyertakan dua cap masa dalam mikrosaat sejak epoch UNIX. Kira kependaman anda:

dispatch_delay  = dispatchTimestampUs - detectedTimestampUs
network_delay   = your_receive_time  - dispatchTimestampUs
total_latency   = your_receive_time  - detectedTimestampUs

Mengapa memilih API pengumuman penyenaraian ini?

Tidak seperti API polling berasaskan REST atau bot Telegram, WebSocket API kami menghantar notis penyenaraian pada saat ia dikesan. Siaran zero-copy bermakna mesej pengumuman disirikan sekali dan dikongsi merentasi semua pelanggan — tiada beban pensirian bagi setiap klien. Seni bina ini mencapai kependaman penghantaran ultra-pantas yang konsisten tanpa mengira bilangan pelanggan. Baca lebih lanjut tentang bursa tertentu: notis penyenaraian Binance, pengumuman penyenaraian Upbit, notis penyenaraian Bithumb.

Soalan lazim

Apakah protokol yang digunakan API ini?

WebSocket (RFC 6455) melalui TLS 1.2+. Pengesahan dilakukan melalui pengepala HTTP X-API-Key pada permintaan naik taraf. Mesej ialah JSON UTF-8 dalam bingkai binari. Kunci API yang sama mengesahkan pada kedua-dua titik akhir — pilih mengikut lokasi bot anda, bukan mengikut bursa yang anda dagangkan.

Bursa manakah yang disokong?

Binance (penyenaraian spot, penyenaraian futures, penyahsenaraian, HODLer airdrop, Monitoring Tag extend / remove), Upbit dan Bithumb (penyenaraian spot pasaran KRW, pelepasan amaran, dan penyahsenaraian spot — peringkat kitar hayat amaran Korea yang boleh diambil tindakan dagangan). Lebih banyak bursa ditambah berdasarkan permintaan pelanggan. Gunakan parameter pertanyaan ?cex= pada titik akhir Tokyo untuk menapis.

Bagaimana saya mengesahkan?

Sertakan pengepala X-API-Key dalam permintaan naik taraf WebSocket. Dapatkan kunci anda dengan menghubungi kami di Telegram di @CLWfeed. Kunci yang sama berfungsi pada kedua-dua titik akhir. Lihat dokumentasi Pengesahan untuk contoh kod.

Apakah kependaman mesej?

Kependaman penghantaran adalah ultra-pantas. Setiap pengumuman membawa medan detectedTimestampUs dan dispatchTimestampUs berketepatan mikrosaat supaya anda boleh mengukur prestasi hujung-ke-hujung secara bebas. Kependaman rangkaian bergantung pada lokasi bot anda: hos di AWS Tokyo (ap-northeast-1a - apne1-az4) mendapat kependaman hujung-ke-hujung terendah ke titik akhir Tokyo, dan hos di AWS Seoul (ap-northeast-2c - apne2-az3) ke titik akhir Upbit Seoul.

Bagaimanakah kedua-dua titik akhir berbeza?

wss://cryptolisting.ws (Tokyo) menstrim suapan penuh dan merupakan titik akhir global lalai. wss://kr.cryptolisting.ws (Seoul) menstrim Upbit sahaja dan dioptimumkan untuk bot trading yang diko-lokasikan di Korea — ia menghapuskan lompatan rangkaian Seoul→Tokyo pada bahagian pengesanan. Had sambungan dan had kadar dijejak secara bebas bagi setiap titik akhir.

Apakah yang berlaku jika sambungan terputus?

Pelayan menghantar heartbeat setiap 30 saat; klien harus menghantar ping WebSocket pada kadans yang sama. Apabila terputus, sambung semula dengan backoff eksponen (biasanya bermula pada 1s, berganda sehingga 30s). Penyenaraian yang dipancarkan semasa anda terputus TIDAK dimainkan semula — untuk jejak audit pengesanan lalu, lihat pengesanan terkini.