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

Ikhtisar API

CryptoListing.ws menyediakan tiga 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 ketiga 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
}

Daftar lengkap dan terbaru nilai listingType didokumentasikan di referensi pesan.

Pemfilteran bursa

Gunakan parameter query ?cex= pada endpoint Tokyo untuk berlangganan hanya bursa tertentu. Endpoint Seoul membawa Upbit dan Bithumb, jadi filter yang sama berlaku di sana. Robinhood hanya disajikan oleh endpoint 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: hanya binance
wss://cryptolisting.ws?cex=binance,upbit       // Tokyo: binance + upbit
wss://kr.cryptolisting.ws                    // Seoul: Upbit + Bithumb (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 ketiga 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), dan Robinhood (event penambahan ke aset dan dapat diperdagangkan, disajikan dari wss://us.cryptolisting.ws). 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 ketiga 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, host di AWS Seoul (ap-northeast-2c - apne2-az3) ke endpoint Seoul, yang membawa Upbit dan Bithumb, dan host di AWS N. Virginia (us-east-1a - use1-az1) ke endpoint AS, yang membawa Robinhood.

Apa perbedaan ketiga endpoint?

wss://cryptolisting.ws (Tokyo) men-streaming feed lengkap dan merupakan endpoint global default. wss://kr.cryptolisting.ws (Seoul) men-streaming Upbit dan Bithumb dan dioptimalkan untuk bot trading yang co-located di Korea — menghilangkan hop jaringan Seoul→Tokyo di sisi deteksi. wss://us.cryptolisting.ws (N. Virginia) men-streaming hanya Robinhood — event penambahan ke aset dan dapat diperdagangkan — untuk bot yang trading Robinhood. 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.