암호화폐 상장 공지 API

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

API 개요

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

이 API가 맞는 사람

• 상장, 상장 폐지, 유의 종목 이벤트에 반응하는 트레이딩 봇과 퀀트 팀 — 기계가 읽을 수 있는 트리거가 필요한 경우.
• 알림 서비스나 대시보드 개발자 — 거래소마다 연동을 따로 유지하지 않고 Binance, Upbit, Bithumb, Robinhood를 다루고 싶은 경우.
• 연구자 — 타임스탬프가 찍힌 공지 이력이 필요하다면 무료 JSON 피드와 최신 상장 아카이브를 이용하세요. 공지마다 가격 반응 차트가 있는 페이지가 있습니다.
• 봇을 만들지 않는다면? 알림만 필요할 가능성이 큽니다. 무료 Telegram 채널이나 X의 @cryptolistingws (EN)를 팔로우하세요.

무료 옵션

• SpeedTrial — 프로덕션 피드를 +1 ms 예의 지연으로 받는 무료 WebSocket 키. 티커와 제목은 가려집니다. 벤치마크용이며 15일 키, 요청 시 갱신.
• FreeDelayed — 티커와 제목을 포함한 전체 피드를 +240 ms 지연으로 받는 WebSocket 키. 첫 달 무료, 이후 모든 거래소 포함 월 200 USDT.
• 공개 JSON 피드 — 최근 공지를 담은 정적 파일, 키 불필요. 실시간 스트림은 아닙니다.
• Telegram 채널과 X 계정 — 사람이 읽는 무료 알림.

유료 등급 — Basic(+20 ms)과 Premium(지연 없음) — 은 거래소별·월별 USDT로 책정됩니다. 요금제와 요금 계산기를 확인하세요. 무료든 유료든 모든 키는 Telegram에서 요청 시 발급되며 셀프 가입은 없습니다.

직접 구축할 것인가, 이 API를 쓸 것인가

거래소 공지는 직접 수집할 수도 있습니다. 그러려면 거래소마다 수집기를 만들어 운영하고, 사람이 읽도록 여러 언어로 쓰인 공지 제목을 파싱하고, 공지 종류를 하나하나 분류하고, 형식이 바뀌어도 밤낮없이 계속 돌아가게 유지해야 합니다. 한 거래소만 거래하고 전체 시스템을 직접 관리하고 싶다면 합리적인 선택입니다.

여러 거래소를 하나의 연결로, 티커와 이벤트 유형이 이미 추출된 안정적인 스키마로, 상장 폐지와 유의 종목 해제가 분류된 상태로, 그리고 Robinhood 이벤트까지 원한다면 이 API가 맞습니다.

메시지 형식

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

{
  "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://jp.cryptolisting.ws                    // 도쿄: Binance, Upbit, Bithumb — Robinhood는 wss://us.cryptolisting.ws에서 제공
wss://jp.cryptolisting.ws?cex=binance        // 도쿄: binance 전용
wss://jp.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 상장 공지.

봇을 만들고 있다면 단계별 Python Binance 상장 스나이퍼 봇 튜토리얼 (EN)을 참고하세요. 파이썬으로 업비트·빗썸 상장 봇 만들기 튜토리얼도 있습니다. 전체 API 레퍼런스는 WebSocket API (EN), 메시지 스키마 (EN), Python·Node.js·Go·Rust 코드 예제 (EN)를 다룹니다.

자주 묻는 질문

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

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

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