Crypto Listing API Pengumuman

WebSocket API real-time untuk pengumuman dan pemberitahuan listing bursa kripto. Hubungkan dan terima peringatan JSON terstruktur untuk pemberitahuan listing Binance, Upbit, Bithumb.

Ikhtisar API

CryptoListing.ws menyediakan dua endpoint dispatch WebSocket yang men-streaming pengumuman dan pemberitahuan listing real-time dari berbagai bursa kriptokurensi. API ini dirancang untuk sistem trading otomatis yang membutuhkan notifikasi tercepat atas pengumuman listing bursa baru. API key yang sama mengautentikasi di kedua endpoint — pilih berdasarkan lokasi bot Anda.

Format pesan

Setiap pesan pengumuman berisi ticker, bursa, jenis listing, dan tiga timestamp presisi mikrodetik:

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

Jenis listing

Pemfilteran bursa

Gunakan parameter query ?cex= pada endpoint Tokyo untuk berlangganan hanya bursa tertentu. Endpoint Seoul sudah men-streaming pengumuman Upbit secara eksklusif, jadi filter di sana opsional.

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

Pengukuran latency

Setiap pengumuman menyertakan dua timestamp dalam mikrodetik sejak UNIX epoch. Hitung latency Anda:

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

Kenapa memilih API pengumuman listing ini?

Berbeda dengan API polling berbasis REST atau bot Telegram, WebSocket API kami mengirim pemberitahuan listing tepat saat terdeteksi. Broadcast zero-copy berarti pesan pengumuman diserialisasi sekali dan dibagikan ke semua pelanggan — tanpa overhead serialisasi per klien. Arsitektur ini mencapai latency dispatch ultra-cepat yang konsisten berapa pun jumlah pelanggan. Baca selengkapnya tentang bursa tertentu: pemberitahuan listing Binance, pengumuman listing Upbit, pemberitahuan listing Bithumb.

FAQ

Protokol apa yang digunakan API ini?

WebSocket (RFC 6455) di atas TLS 1.2+. Autentikasi dilakukan via header HTTP X-API-Key pada permintaan upgrade. Pesan berupa JSON UTF-8 dalam frame biner. API key yang sama mengautentikasi di kedua endpoint — pilih berdasarkan lokasi bot Anda, bukan berdasarkan bursa yang Anda trading.

Bursa apa saja yang didukung?

Binance (listing spot, listing futures, delisting, HODLer airdrop, Monitoring Tag extend / remove), Upbit dan Bithumb (listing spot pasar KRW, pencabutan peringatan, dan delisting spot — tahap-tahap siklus caution Korea yang dapat ditindaklanjuti untuk trading). Bursa lain ditambahkan berdasarkan permintaan pelanggan. Gunakan parameter query ?cex= pada endpoint Tokyo untuk memfilter.

Bagaimana cara mengautentikasi?

Sertakan header X-API-Key pada permintaan upgrade WebSocket. Dapatkan key Anda dengan menghubungi kami di Telegram di @CLWfeed. Key yang sama berlaku di kedua endpoint. Lihat dokumen Autentikasi untuk contoh kode.

Berapa latency pesannya?

Latency dispatch ultra-cepat. Setiap pengumuman membawa field detectedTimestampUs dan dispatchTimestampUs berpresisi mikrodetik sehingga Anda bisa mengukur kinerja end-to-end secara independen. Latency jaringan bergantung pada lokasi bot Anda: host di AWS Tokyo (ap-northeast-1a - apne1-az4) mendapatkan latency end-to-end terendah ke endpoint Tokyo, dan host di AWS Seoul (ap-northeast-2c - apne2-az3) ke endpoint Upbit Seoul.

Apa perbedaan kedua endpoint?

wss://cryptolisting.ws (Tokyo) men-streaming feed lengkap dan merupakan endpoint global default. wss://kr.cryptolisting.ws (Seoul) men-streaming hanya Upbit dan dioptimalkan untuk bot trading yang co-located di Korea — menghilangkan hop jaringan Seoul→Tokyo di sisi deteksi. Batas koneksi dan rate limit dilacak secara independen per endpoint.

Apa yang terjadi jika koneksi terputus?

Server mengirim heartbeat setiap 30 detik; klien harus mengirim ping WebSocket pada irama yang sama. Saat terputus, sambungkan kembali dengan exponential backoff (biasanya mulai dari 1 dtk, berlipat ganda hingga 30 dtk). Listing yang dipancarkan saat Anda terputus TIDAK diputar ulang — untuk jejak audit deteksi masa lalu, lihat deteksi terbaru.