청산 및 가격 스트림

하나의 WebSocket 연결로 청산 체결 내역과 가격 업데이트를 푸시합니다. 구독 메시지는 없습니다. 서버는 연결 시 `history` 프레임과 `price_snapshot` 프레임을 보내고, 이후 `liquidation` 및 `price` 프레임을 발생하는 대로 전송합니다.

WSwss://www.coinboss.com/ws

요청

구독 메시지는 없습니다. 연결이 열리는 즉시 서버가 푸시를 시작합니다. 소켓이 닫히면 지연을 두고 재연결하고, 누락 구간은 HTTP로 백필하십시오.

요청 예시

# WebSocket needs a WS client; with websocat:
websocat "wss://www.coinboss.com/ws"

응답 필드

프레임 유형	전송 시점	구조
history	연결 시 한 번	{ "type": "history", "data": [ <liquidation>, ... ] }
price_snapshot	연결 시 한 번	{ "type": "price_snapshot", "data": { "<SYMBOL>": <price>, ... }, "ts": <ms> }
liquidation	청산이 발생할 때마다	{ "type": "liquidation", "data": <liquidation> }
price	가격이 변할 때마다	{ "type": "price", "symbol": "BTCUSDT", "price": <number>, "ts": <ms> }

응답 예시

마지막 성공 응답이 너무 커서 표시할 수 없어 예시를 저장하지 않았습니다. 플레이그라운드에서 엔드포인트를 호출해 보십시오.

상세 정보

인증: 없음. 공개 엔드포인트.
요청 한도: IP당 분당 1200회
서버 캐시: 캐시 안 함
갱신 주기: 실시간으로 푸시됩니다. `liquidation` 프레임은 거래소 청산 피드를, `price` 프레임은 선물 시세 업데이트를 따릅니다.
구간: `history`에는 연결 시점 기준 가장 최근의 청산 건이 들어 있으며, 나머지는 모두 실시간입니다.
데이터 소스: CoinBoss가 수집한 거래소 청산 피드; 선물 시세 스트림.
타임스탬프: `ts` / `timestamp`는 Unix epoch 밀리초(UTC)입니다.
응답 형식: json-frames
안정성: 안정

실시간 상태

사용 가능2026-11-13 03:53:49 UTC 점검HTTP 1014 ms스키마 미검사

최근 30일 가용성

점검 407회 중 100% 통과

오류

실패한 호출은 모든 엔드포인트에서 동일한 구조로 반환됩니다. 전체 목록은 오류 페이지에 있습니다. 오류 및 요청 한도 →

코드	HTTP	의미	대응 방법
INVALID_PARAM	400	필수 파라미터가 누락되었거나 허용되지 않는 값입니다. 문제가 된 파라미터를 알 수 있으면 `param`에 그 이름이 들어갑니다.	그대로 재시도하지 말고 요청을 수정하십시오.
UNAUTHORIZED	401	`CB-API-KEY` 헤더를 보냈지만 알 수 없거나 폐기된 키입니다. 공개 데이터에는 키가 필요 없으므로 헤더를 빼거나 유효한 키를 사용하십시오.	그대로 재시도하지 마십시오.
FORBIDDEN	403	해당 경로는 공개 API에 포함되지 않습니다(내부용 또는 계정 전용).	재시도하지 마십시오.
NOT_FOUND	404	알 수 없는 경로이거나, 요청한 코인 / 거래소 / 펀드가 존재하지 않습니다.	재시도하지 말고 경로와 식별자를 카탈로그와 대조해 확인하십시오.
RATE_LIMITED	429	요청 수가 분당 한도를 초과했습니다. `Retry-After`가 대기해야 할 초를 알려 줍니다.	`Retry-After`만큼 기다린 뒤 백오프를 적용해 재시도하십시오.
INTERNAL	500	예기치 않은 서버 오류입니다. 메시지는 의도적으로 일반적인 내용만 담습니다. 신고할 때 `request_id`를 인용하십시오.	몇 초 뒤 한 번 재시도하고, 계속되면 요청 ID와 함께 신고하십시오.
UPSTREAM_FAILED	503	이 엔드포인트의 데이터 소스가 제시간에 응답하지 않았습니다. 그 대신 만료된 수치나 대체 수치를 반환하는 일은 없습니다.	백오프를 적용해 재시도하고 상태 페이지를 확인하십시오.
UNAVAILABLE	501 / 503	데이터셋이 일시적으로 준비되지 않았거나(캐시 워밍 중) 엔드포인트에 아직 합법적인 공개 소스가 없습니다.	나중에 재시도하십시오. 설계상 사용 불가인 엔드포인트는 카탈로그에 표시되어 있습니다.
REQUEST_FAILED	200	일부 이전 엔드포인트는 HTTP 200에 `success: false`로 응답합니다. HTTP 상태만 보지 말고 항상 `success`를 확인하십시오.	메시지에 따라 다릅니다. 실패한 요청으로 처리하십시오.

직접 실행

WS/ws사용 가능

WebSocket 스트림입니다. 연결하면 실제 메시지가 도착하는 것을 볼 수 있으며, 메시지 25건을 받으면 연결이 자동으로 종료됩니다.

요청 URLwss://www.coinboss.com/ws

응답

엔드포인트를 선택하고 “요청 보내기”를 누르십시오. 응답, 헤더, 소요 시간이 여기에 표시됩니다.

청산 및 가격 스트림 /ws