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.

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
}

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

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 ditambah-ke-aset dan boleh-didagangkan, 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://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 ditambah-ke-aset dan boleh-didagangkan — 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.