암호화폐 상장 공지 API

암호화폐 거래소 상장 공지 및 공시를 위한 실시간 WebSocket API입니다. 연결하여 Binance, Upbit, Bithumb 상장 공지의 구조화된 JSON 알림을 받으십시오.

API 개요

CryptoListing.ws는 여러 암호화폐 거래소의 실시간 상장 공지 및 공시를 스트리밍하는 두 개의 WebSocket 디스패치 엔드포인트를 제공합니다. 이 API는 신규 거래소 상장 공지를 가능한 한 빠르게 수신해야 하는 자동화 트레이딩 시스템을 위해 설계되었습니다. 동일한 API 키가 두 엔드포인트 모두에서 인증되므로 — 봇의 위치에 따라 선택하십시오.

메시지 형식

모든 공지 메시지에는 티커, 거래소, 상장 유형, 그리고 마이크로초 정밀도의 타임스탬프 3개가 포함됩니다:

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

상장 유형

거래소 필터링

도쿄 엔드포인트에서 ?cex= 쿼리 파라미터를 사용해 특정 거래소만 구독하십시오. 서울 엔드포인트는 이미 Upbit 공지만 전용으로 스트리밍하므로 필터는 선택 사항입니다.

wss://cryptolisting.ws                       // 도쿄: 모든 거래소 (Binance, Upbit, Bithumb)
wss://cryptolisting.ws?cex=binance             // 도쿄: binance 전용
wss://cryptolisting.ws?cex=binance,upbit       // 도쿄: binance + upbit
wss://kr.cryptolisting.ws                    // 서울: Upbit 전용 (한국에서 초고속)

지연 측정

모든 공지에는 UNIX epoch 기준 마이크로초 단위의 타임스탬프 2개가 포함됩니다. 지연을 계산하십시오:

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

이 상장 공지 API를 선택해야 하는 이유

REST 기반 폴링 API나 Telegram 봇과 달리, 저희 WebSocket API는 상장 공지가 감지되는 즉시 전달합니다. 제로카피 브로드캐스트 방식이므로 공지 메시지는 한 번만 직렬화되어 모든 구독자에게 공유됩니다 — 클라이언트별 직렬화 오버헤드가 없습니다. 이 아키텍처는 구독자 수와 관계없이 일관된 초고속 디스패치 지연을 달성합니다. 거래소별 자세한 내용을 확인하십시오: Binance 상장 공지, Upbit 상장 공지, Bithumb 상장 공지.

자주 묻는 질문

API는 어떤 프로토콜을 사용합니까?

TLS 1.2+ 상의 WebSocket (RFC 6455)입니다. 인증은 업그레이드 요청의 X-API-Key HTTP 헤더로 수행됩니다. 메시지는 바이너리 프레임에 담긴 UTF-8 JSON입니다. 동일한 API 키가 두 엔드포인트 모두에서 인증됩니다 — 거래하는 거래소가 아니라 봇의 위치에 따라 선택하십시오.

어떤 거래소가 지원됩니까?

Binance(현물 상장, 선물 상장, 상장 폐지, HODLer 에어드랍, Monitoring Tag extend / remove), Upbit 및 Bithumb(KRW 마켓 현물 상장, 유의 종목 지정 해제, 현물 상장 폐지 — 한국 유의 종목 지정 라이프사이클 중 트레이딩에 활용 가능한 단계)입니다. 구독자 수요에 따라 거래소가 추가됩니다. 도쿄 엔드포인트에서 ?cex= 쿼리 파라미터로 필터링하십시오.

어떻게 인증합니까?

WebSocket 업그레이드 요청에 X-API-Key 헤더를 포함하십시오. Telegram @CLWfeed으로 문의하여 키를 받으십시오. 동일한 키가 두 엔드포인트 모두에서 작동합니다. 코드 예제는 인증 문서를 참고하십시오.

메시지 지연은 얼마입니까?

디스패치 지연은 초고속입니다. 각 공지에는 마이크로초 정밀도의 detectedTimestampUs 및 dispatchTimestampUs 필드가 담겨 있어 종단 간 성능을 직접 측정할 수 있습니다. 네트워크 지연은 봇의 위치에 따라 달라집니다: AWS 도쿄(ap-northeast-1a - apne1-az4)의 호스트는 도쿄 엔드포인트까지, AWS 서울(ap-northeast-2c - apne2-az3)의 호스트는 서울 Upbit 엔드포인트까지 가장 낮은 종단 간 지연을 얻습니다.

두 엔드포인트는 어떻게 다릅니까?

wss://cryptolisting.ws(도쿄)는 전체 피드를 스트리밍하는 기본 글로벌 엔드포인트입니다. wss://kr.cryptolisting.ws(서울)는 Upbit만 스트리밍하며 한국에 코로케이션된 트레이딩 봇에 최적화되어 있습니다 — 감지 측의 서울→도쿄 네트워크 홉을 제거합니다. 연결 상한과 레이트 리미트는 엔드포인트별로 독립 관리됩니다.

연결이 끊기면 어떻게 됩니까?

서버는 30초마다 하트비트를 전송하며, 클라이언트도 동일한 주기로 WebSocket ping을 보내야 합니다. 연결이 끊기면 지수 백오프로 재연결하십시오(일반적으로 1초에서 시작해 최대 30초까지 두 배씩 증가). 연결이 끊긴 동안 발생한 상장은 재전송되지 않습니다 — 과거 감지 내역은 최근 감지를 참고하십시오.