어떤 API를 사용해야 할까요? REST 대 WebSocket

최종 업데이트: 2025년 8월 8일

당사의 API는 플랫폼과 프로그래밍 방식으로 상호 작용하는 방법을 제공하지만, 두 플랫폼 모두 두 가지 다른 인터페이스를 제공합니다. Spot에서는 REST와 WebSocket(v1v2)을, Futures에서도 REST 및 WebSocket API를 모두 제공합니다. 때로는 특정 작업에 가장 적합한 인터페이스를 선택하는 것이 어려운 결정이 될 수 있습니다.

REST와 WebSocket의 차이점

Spot에서 REST와 WebSocket은 모두 동일한 시장 데이터(오더북, 거래 내역 등)와 동일한 계정 데이터(계정 잔액, 주문/거래 상태 등)를 제공하지만, 그 방식은 상당히 다릅니다.

REST는 호출/응답(질문/답변) 유형의 인터페이스를 제공하고 현재 데이터의 스냅샷을 제공하는 반면, WebSocket은 라이브 스트리밍 유형의 인터페이스를 제공하고 실시간 업데이트를 제공합니다.

비유하자면 사진과 비디오의 차이와 같습니다. 요청 시 사진은 피사체의 스냅샷을 제공하지만 추가 업데이트는 없으며, 비디오는 라이브 스트리밍 업데이트와 함께 피사체의 실시간 보기를 제공합니다.

구현 용이성

REST와 WebSocket 모두 구현하기 어렵지 않지만, 일반적으로 REST가 덜 복잡하여 개발 시간을 단축하고 후속 문제를 더 빠르게 해결할 수 있다고 알려져 있습니다.

REST는 모든 최신 프로그래밍 언어의 표준 라이브러리에 포함된 표준 HTTPS 요청을 기반으로 하며(그렇지 않더라도 처음부터 쉽게 코딩할 수 있음), WebSocket은 HTTPS에서 WSS 업그레이드를 기반으로 하므로 일반적으로 추가 타사 라이브러리(예: 당사의 Python용 권장 WebSocket 라이브러리)가 필요합니다.

당사의 API 지원 페이지는 REST와 WebSocket 모두에 대해 바로 사용할 수 있는 예제 코드를 제공하므로, 구현 용이성보다는 더 중요한 기준을 사용하여 인터페이스를 선택할 수 있습니다.

어떤 API 인터페이스를 사용해야 할까요? (REST 또는 WebSocket)

당면한 작업에 따라 REST만 사용하거나 WebSocket만 사용하거나, 또는 REST와 WebSocket을 조합하는 것이 최적의 선택이 될 수 있습니다.

가끔 시장 데이터 업데이트만 필요한 작업의 경우 REST가 선호되는 선택입니다. 예를 들어, 24시간마다 한 번만 시장 데이터가 필요한 일일 비용 평균화 봇은 실시간 스트리밍 시장 데이터가 필요 없으므로 REST 시장 데이터 엔드포인트가 충분히 적합할 것입니다.

가장 최신 시장 데이터가 필요한 작업의 경우 WebSocket이 선호되는 선택입니다. 예를 들어, 차익 거래 봇은 순간적인 가격 불일치를 활용하기 위해 여러 시장에서 실시간 시장 데이터가 필요하므로 WebSocket 시장 데이터 피드가 이상적인 선택이 될 것입니다.

대부분의 경우(대부분의 트레이딩 봇과 같이) REST와 WebSocket의 조합이 가장 효과적인 구현을 가능하게 합니다. 예를 들어, 모바일 앱은 차트를 위해 실시간 시장 데이터가 필요하지만, 계정 데이터는 가끔(예: 거래 또는 자금 이체 시)만 필요할 수 있으므로, WebSocket 시장 데이터 피드와 REST 주문/거래/자금 상태 엔드포인트를 함께 사용하는 것이 가장 효율적인 조합이 될 것입니다.

최적의 API 구현을 위한 조언을 얻는 방법

당사의 API 지원팀은 귀하의 API 구현에 대해 기꺼이 논의하고, 귀하의 의도된 사용 시나리오에 따라 당사 API를 사용하는 최적의 방법에 대한 제안을 드릴 것입니다.

더 많은 도움이 필요하신가요?