암호화폐 상장 공지 API

암호화폐 거래소 상장 공지 및 공시를 위한 실시간 WebSocket API입니다. 연결하여 Binance, Upbit, Bithumb 및 Robinhood 상장 공지의 구조화된 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
}

listingType 값의 전체 최신 목록은 메시지 레퍼런스에 정리되어 있습니다.

거래소 필터링

도쿄 엔드포인트에서 ?cex= 쿼리 파라미터를 사용해 특정 거래소만 구독하십시오. 서울 엔드포인트는 Upbit와 Bithumb을 함께 제공하므로 동일한 필터를 그대로 사용하실 수 있습니다. Robinhood는 미국 엔드포인트 wss://us.cryptolisting.ws에서만 제공되며, 이 엔드포인트는 다른 거래소를 제공하지 않습니다.

wss://cryptolisting.ws                       // 도쿄: Binance, Upbit, Bithumb — Robinhood는 wss://us.cryptolisting.ws에서 제공
wss://cryptolisting.ws?cex=binance             // 도쿄: binance 전용
wss://cryptolisting.ws?cex=binance,upbit       // 도쿄: binance + upbit
wss://kr.cryptolisting.ws                    // 서울: Upbit + Bithumb (한국에서 초고속)

지연 측정

모든 공지에는 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 마켓 현물 상장, 유의 종목 지정 해제, 현물 상장 폐지 — 한국 유의 종목 지정 라이프사이클 중 트레이딩에 활용 가능한 단계), 그리고 Robinhood(자산 추가 및 거래 가능 이벤트, wss://us.cryptolisting.ws에서 제공)입니다. 구독자 수요에 따라 거래소가 추가됩니다. 도쿄 엔드포인트에서 ?cex= 쿼리 파라미터로 필터링하십시오.

어떻게 인증합니까?

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

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

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

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

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

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

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