Kripto Listeleme Duyuru API

Kripto borsa listeleme duyuruları ve bildirimleri için gerçek zamanlı bir WebSocket API. Bağlanın ve Binance, Upbit, Bithumb listeleme bildirimleri için yapılandırılmış JSON uyarıları alın.

API'ye genel bakış

CryptoListing.ws, birden fazla kripto para borsasından gerçek zamanlı listeleme duyurularını ve bildirimlerini akıtan iki WebSocket dağıtım uç noktası sunar. API, yeni borsa listeleme duyurularının mümkün olan en hızlı bildirimine ihtiyaç duyan otomatik trading sistemleri için tasarlanmıştır. Aynı API anahtarı her iki uç noktada da kimlik doğrular — botunuzun konumuna göre seçin.

Mesaj formatı

Her duyuru mesajı; ticker'ı, borsayı, listeleme türünü ve mikrosaniye hassasiyetinde üç zaman damgasını içerir:

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

Listeleme türleri

Borsa filtreleme

Yalnızca belirli borsalara abone olmak için Tokyo uç noktasında ?cex= sorgu parametresini kullanın. Seoul uç noktası zaten yalnızca Upbit duyurularını akıttığından orada filtre opsiyoneldir.

wss://cryptolisting.ws                       // Tokyo: tüm borsalar (Binance, Upbit, Bithumb)
wss://cryptolisting.ws?cex=binance             // Tokyo: yalnızca binance
wss://cryptolisting.ws?cex=binance,upbit       // Tokyo: binance + upbit
wss://kr.cryptolisting.ws                    // Seoul: yalnızca Upbit (Kore'den ultra hızlı)

Gecikme ölçümü

Her duyuru, UNIX epoch'tan bu yana mikrosaniye cinsinden iki zaman damgası içerir. Gecikmenizi hesaplayın:

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

Neden bu listeleme duyurusu API'sini seçmelisiniz?

REST tabanlı polling API'lerinin veya Telegram botlarının aksine, WebSocket API'miz listeleme bildirimlerini tespit edildikleri anda teslim eder. Sıfır kopyalı yayın, duyuru mesajının bir kez seri hale getirilip tüm abonelerle paylaşıldığı anlamına gelir — istemci başına seri hale getirme yükü yoktur. Bu mimari, abone sayısından bağımsız olarak tutarlı ultra hızlı dağıtım gecikmesi sağlar. Belirli borsalar hakkında daha fazlası: Binance listeleme bildirimleri, Upbit listeleme duyuruları, Bithumb listeleme bildirimleri.

SSS

API hangi protokolü kullanır?

TLS 1.2+ üzerinden WebSocket (RFC 6455). Kimlik doğrulama, yükseltme isteğindeki X-API-Key HTTP başlığıyla yapılır. Mesajlar ikili çerçevelerde UTF-8 JSON'dur. Aynı API anahtarı her iki uç noktada da kimlik doğrular — trade ettiğiniz borsaya göre değil, botunuzun konumuna göre seçin.

Hangi borsalar destekleniyor?

Binance (spot listelemeler, vadeli listelemeler, delisting'ler, HODLer airdrop'lar, Monitoring Tag extend / remove), Upbit ve Bithumb (KRW piyasası spot listelemeleri, uyarı kaldırmaları ve spot delisting'ler — Kore uyarı yaşam döngüsünün trade edilebilir aşamaları). Abone talebine göre daha fazla borsa eklenir. Filtrelemek için Tokyo uç noktasında ?cex= sorgu parametresini kullanın.

Nasıl kimlik doğrularım?

WebSocket yükseltme isteğine X-API-Key başlığını ekleyin. Anahtarınızı almak için Telegram'da @CLWfeed ile iletişime geçin. Aynı anahtar her iki uç noktada da çalışır. Kod örnekleri için Kimlik Doğrulama dokümanlarına bakın.

Mesaj gecikmesi nedir?

Dağıtım gecikmesi ultra hızlıdır. Her duyuru, uçtan uca performansı bağımsız olarak ölçebilmeniz için mikrosaniye hassasiyetinde detectedTimestampUs ve dispatchTimestampUs alanlarını taşır. Ağ gecikmesi botunuzun konumuna bağlıdır: AWS Tokyo'daki (ap-northeast-1a - apne1-az4) sunucular Tokyo uç noktasına en düşük uçtan uca gecikmeyi, AWS Seoul'daki (ap-northeast-2c - apne2-az3) sunucular ise Seoul Upbit uç noktasına en düşük gecikmeyi elde eder.

İki uç nokta nasıl farklılaşır?

wss://cryptolisting.ws (Tokyo) tam feed'i akıtır ve varsayılan küresel uç noktadır. wss://kr.cryptolisting.ws (Seoul) yalnızca Upbit'i akıtır ve Kore'de aynı konumda barındırılan trading botları için optimize edilmiştir — tespit tarafındaki Seoul→Tokyo ağ atlamasını ortadan kaldırır. Bağlantı üst sınırları ve oran sınırları her uç nokta için bağımsız izlenir.

Bağlantı koparsa ne olur?

Sunucu her 30 saniyede bir heartbeat gönderir; istemciler aynı ritimde WebSocket ping'leri göndermelidir. Bağlantı koptuğunda, üstel geri çekilmeyle yeniden bağlanın (tipik olarak 1 sn'den başlayıp 30 sn'ye kadar ikiye katlanarak). Siz bağlantı dışındayken yayılan listelemeler tekrar GÖNDERİLMEZ — geçmiş tespitlerin denetim kaydı için son tespitlere bakın.