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 dan Robinhood.

Gambaran keseluruhan API

CryptoListing.ws menyediakan tiga 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 ketiga-tiga titik akhir — pilih mengikut lokasi bot anda.

Untuk siapa API ini

• Bot dagangan dan pasukan kuantitatif yang bertindak balas terhadap peristiwa penyenaraian, penyahsenaraian dan amaran serta memerlukan pencetus yang boleh dibaca mesin.
• Pembangun produk amaran dan papan pemuka yang meliputi Binance, Upbit, Bithumb dan Robinhood tanpa menyelenggara integrasi berasingan bagi setiap bursa.
• Penyelidik yang memerlukan sejarah pengumuman bercap masa: suapan JSON percuma dan arkib penyenaraian terkini, dengan halaman dan carta reaksi harga bagi setiap pengumuman.
• Tidak menulis bot? Mungkin anda hanya mahukan amarannya: ikuti saluran Telegram percuma atau @cryptolistingws di X (EN).

Pilihan percuma

• SpeedTrial — kunci WebSocket percuma pada suapan pengeluaran dengan kelewatan budi bahasa +1 ms; ticker dan tajuk disembunyikan. Dibina untuk penanda aras. Kunci 15 hari, boleh diperbaharui atas permintaan.
• FreeDelayed — kunci WebSocket dengan suapan penuh, termasuk ticker dan tajuk, dan kelewatan +240 ms. Percuma untuk bulan pertama, kemudian 200 USDT/bulan dengan semua bursa disertakan.
• Suapan JSON awam — pengumuman terkini dalam fail statik, tanpa kunci. Bukan strim masa nyata.
• Saluran Telegram dan akaun X — amaran percuma untuk dibaca.

Pelan berbayar — Basic (+20 ms) dan Premium (tanpa kelewatan) — dikenakan harga bagi setiap bursa dan setiap bulan dalam USDT: lihat harga dan kalkulator harga. Setiap kunci, percuma atau berbayar, dikeluarkan atas permintaan di Telegram — tiada pendaftaran layan diri.

Bina sendiri atau guna API ini

Anda boleh mengumpul pengumuman bursa sendiri. Ini bermakna membina dan menjalankan pengumpul bagi setiap bursa, menghurai tajuk notis yang ditulis untuk manusia dalam beberapa bahasa, mengelaskan setiap jenis notis, dan memastikan semuanya terus berjalan siang dan malam apabila format berubah. Ia pilihan yang munasabah jika anda berdagang di satu bursa dan mahu menguasai keseluruhan sistem sendiri.

Gunakan API ini jika anda mahukan beberapa bursa dalam satu sambungan, skema stabil dengan ticker dan jenis peristiwa yang telah diekstrak, penyahsenaraian dan pelepasan amaran yang telah dikelaskan, serta peristiwa Robinhood.

Format mesej

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

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

Senarai penuh dan terkini nilai listingType didokumenkan dalam rujukan mesej.

Penapisan bursa

Gunakan parameter pertanyaan ?cex= pada titik akhir Tokyo untuk melanggan bursa tertentu sahaja. Titik akhir Seoul membawa Upbit dan Bithumb, jadi penapis yang sama terpakai di sana. Robinhood disajikan hanya oleh titik akhir AS, wss://us.cryptolisting.ws, yang tidak membawa bursa lain.

wss://jp.cryptolisting.ws                    // Tokyo: Binance, Upbit, Bithumb — Robinhood ada di wss://us.cryptolisting.ws
wss://jp.cryptolisting.ws?cex=binance        // Tokyo: binance sahaja
wss://jp.cryptolisting.ws?cex=binance,upbit  // Tokyo: binance + upbit
wss://kr.cryptolisting.ws                    // Seoul: Upbit + Bithumb (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.

Sedang membina bot? Ikuti tutorial langkah demi langkah bot sniper penyenaraian Binance dengan Python (EN). Terdapat juga tutorial bot penyenaraian Upbit & Bithumb dengan Python (EN). Rujukan API penuh merangkumi API WebSocket (EN), skema mesej (EN) dan contoh kod Python, Node.js, Go dan Rust (EN).

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 ketiga-tiga 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), dan Robinhood (peristiwa Robinhood Listing dan Robinhood Live, disajikan dari wss://us.cryptolisting.ws). 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 ketiga-tiga 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, hos di AWS Seoul (ap-northeast-2c - apne2-az3) ke titik akhir Seoul, yang membawa Upbit dan Bithumb, dan hos di AWS N. Virginia (us-east-1a - use1-az1) ke titik akhir AS, yang membawa Robinhood.

Bagaimanakah ketiga-tiga titik akhir berbeza?

wss://jp.cryptolisting.ws (Tokyo) menstrim suapan penuh dan merupakan titik akhir global lalai. wss://kr.cryptolisting.ws (Seoul) menstrim Upbit dan Bithumb serta dioptimumkan untuk bot trading yang diko-lokasikan di Korea — ia menghapuskan lompatan rangkaian Seoul→Tokyo pada bahagian pengesanan. wss://us.cryptolisting.ws (N. Virginia) menstrim Robinhood sahaja — peristiwa Robinhood Listing dan Robinhood Live — untuk bot yang berdagang Robinhood. 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.