콘텐츠로 이동

시작하기

cTrader Open API는 cTrader 백엔드에 연결된 사용자 정의 애플리케이션을 개발할 수 있는 서비스입니다. 이 문서는 SDK에 대한 정보, 구조화된 튜토리얼, 코드 스니펫 등을 포함하여 필요한 모든 정보를 제공합니다.

Open API란 무엇인가요?

cTrader Open API는 cTrader ID(cTID)를 가진 누구나 cTrader 백엔드로 정보를 보내고 받을 수 있는 애플리케이션을 만들 수 있는 서비스입니다. 이 API를 사용하여 거래 중심의 앱이나 서비스를 개발하거나 기존 솔루션과 cTrader 백엔드를 통합할 수 있습니다.

이 API를 사용하려면 cTrader 백엔드로 메시지를 보내고 받아야 합니다. 이는 JSON 객체 또는 Google Protocol Buffers (Protobufs)를 보내고 받는 방식으로 이루어집니다. 이 두 데이터 직렬화 및 역직렬화 방법은 언어 중립적이므로 API와 상호작용하기 위해 원하는 프로그래밍 언어를 사용할 수 있습니다.

메시지 이름

이 문서가 특정 메시지(예: ProtoOAApplicationAuthReq)를 참조할 때는 메시지 이름 앞에 ProtoOA...가 붙은 Protobuf 표기법을 사용합니다.

cTrader Open API는 cTrader 제휴 중개인에 등록된 누구나 사용할 수 있습니다.

사용 사례

cTrader Open API와 상호작용할 때 만들 수 있는 몇 가지 애플리케이션은 다음과 같습니다:

  • 특정 중개인과 새로운 계정을 생성하도록 새로운 사용자를 유도하는 사용자 정의 거래 애플리케이션.
  • 새로운 거래를 했을 때 팔로워들에게 자동으로 알려주는 Telegram 봇.
  • 사용자가 가장 최근에 열은 다섯 개의 포지션의 현재 손익을 표시하는 웨어러블용 앱.
  • 생성형 AI 서비스를 사용하여 시장 개요를 제공하는 모바일 앱.

보시다시피, cTrader Open API는 소셜적으로 참여하고 팔로워들과 상호작용하고자 하는 전문 트레이더에게 완벽합니다.

필수 기능

cTrader Open API가 코드로 할 수 있는 작업의 비전체 목록은 다음과 같습니다:

  • 실시간 시장 데이터에 접속하세요.
  • 공식 cTrader 애플리케이션에서 허용되는 모든 유형의 거래 작업을 수행합니다.
  • 과거, 현재 및 예정된 작업(거래, 주문 및 포지션 포함)에 대한 정보를 검색하고 처리합니다.

이용 약관에 표시된 대로, 이 API는 cTID를 가진 누구나 액세스할 수 있으며, 기본적으로 모든 cTrader 제휴 중개인의 모든 거래 계정에서 지원됩니다.

속도 제한

cTrader 백엔드에 대해 특정 요청을 수행할 수 있는 빈도에 몇 가지 제한이 있음을 유의하세요.

  • 비역사적 데이터 요청에 대해 연결당 초당 최대 50회 요청을 수행할 수 있습니다.
  • 역사적 데이터 요청에 대해 연결당 초당 최대 5회 요청을 수행할 수 있습니다.

데모 및 라이브 거래

cTrader Open API를 사용하여 데모 및 라이브 계정을 대신하여 거래할 수 있습니다.

개발 및 테스트를 위해 데모 계정을 사용하고, cTrader Open API와의 통합이 의도한 대로 작동하는지 확인한 후 라이브 계정으로 전환할 것을 권장합니다. 그러나 엄격한 제한은 없으며, 라이브 계정에서 개발 및 테스트를 시작하도록 자유롭게 선택할 수 있습니다.

SDKs

Open API와 통합할 때 데이터 직렬화 및 역직렬화를 위해 JSON 또는 Protobufs를 사용할 수 있습니다.

cTrader Open API를 구현하기 위해 어떤 언어든 사용할 수 있습니다. 그러나 Protobufs를 사용할 계획이라면, Spotware에서 공식적으로 SDK를 지원하는 언어를 사용할 것을 강력히 권장합니다. 현재까지 이러한 언어는 다음과 같습니다.

위에 나열된 모든 공식 SDK는 cTrader Open API 구현을 가능한 한 원활하게 만들어주는 도우미 메서드와 클래스를 포함하고 있습니다.

JSON을 사용할 계획이라면, 직렬화 및 역직렬화 처리가 비교적 간단하기 때문에 우리의 SDK를 사용할 필요가 없습니다.