API Crypto.com

Crypto.com

지원되는 API

WebSocket API: websocket 서버에 연결하고 실시간 시장 데이터 업데이트, 계정 변경 등을 제공합니다.
REST API: HTTP 요청을 보내 시장 데이터를 가져오고, 주문하고, 계정 데이터를 가져옵니다...

Properties

채널 유형을 선택하려면 Channel 속성을 사용하십시오:

cccMarket: public 시장 데이터를 위해 Market WebSocket API에 연결합니다.
cccUser: 비공개 계정 데이터를 위한 User WebSocket API에 연결합니다(인증 필요).

CryptoCom 속성에서 다음 속성을 구성할 수 있습니다.

ApiKey: Crypto.com 계정에서 새 api 키를 요청하고, 그 값을 이 속성에 복사하기만 하면 됩니다. private 채널 및 인증된 REST API 호출에 필요합니다.
ApiSecret: api의 비밀 값입니다.
Resubscribe: 활성화되면 재연결 후 클라이언트가 연결 해제 전에 활성 상태였던 채널을 자동으로 다시 구독합니다(기본적으로 false).

연결

클라이언트가 Crypto.com 서버에 성공적으로 연결되면 OnConnect 이벤트가 발생합니다. OnConnect 이벤트가 발생한 후, Crypto.com 서버로/로부터 메시지를 보내고 받기 시작할 수 있습니다. User 채널에 연결하는 경우, 프라이빗 채널을 구독하기 전에 OnCryptoComAuthentication 이벤트가 발생할 때까지 기다리고 success 매개변수가 true인지 확인해야 합니다.


oClient := TsgcWebSocketClient.Create(nil);
oCryptoCom := TsgcWS_API_CryptoCom.Create(nil);
oCryptoCom.Client := oClient;
oCryptoCom.CryptoCom.ApiKey := 'your_api_key';
oCryptoCom.CryptoCom.ApiSecret := 'your_api_secret';
oCryptoCom.Channel := cccMarket;
oClient.Active := True;
procedure OnConnect(Connection: TsgcWSConnection);
begin
  DoLog('#CryptoCom Connected');
end;

Events

Crypto.com 클라이언트는 연결 흐름을 제어하고 WebSocket 서버에서 전송된 데이터를 가져오기 위해 다음 이벤트를 구현합니다:

OnConnect: websocket 클라이언트가 WebSocket Server에 연결할 때 발생합니다.
OnDisconnect: websocket 클라이언트가 WebSocket Server에서 연결을 끊을 때 발생합니다.
OnCryptoComAuthentication: 클라이언트가 Private WebSocket Server에 대해 인증할 때 발생합니다.
OnCryptoComSubscribe: 클라이언트가 websocket 채널에 구독할 때 발생합니다.
OnCryptoComUnSubscribe: 클라이언트가 websocket 채널에서 구독을 취소할 때.
OnCryptoComData: 클라이언트가 서버로부터 데이터를 수신할 때 발생합니다.
OnCryptoComError: Crypto.com websocket 연결 중 오류가 발생할 때.
OnCryptoComHTTPException: REST 요청 중에 오류가 있을 때 발생합니다.

WebSocket API

websocket 피드는 주문 및 거래에 대한 실시간 시장 데이터 업데이트를 제공합니다.

다음 Market 채널(공개)을 구독할 수 있습니다:

메서드	설명
SubscribeTicker	instrument의 ticker 스트림을 구독합니다. 실시간 가격 및 거래량 데이터를 제공합니다.
SubscribeTrade	상품의 최근 거래 스트림을 구독합니다.
SubscribeCandlestick	캔들스틱 스트림을 구독합니다. 여러 간격(예: 5m, 15m, 30m, 1h, 4h, 1D)을 지원합니다.
SubscribeBook	order book 스트림을 구독합니다. 구성 가능한 depth 레벨을 지원합니다(예: 10, 50).

다음 User 채널(비공개, 인증 필요)을 구독할 수 있습니다:

메서드	설명
SubscribeOrders	주문 업데이트를 구독합니다. 선택적으로 instrument 이름으로 필터링합니다.
SubscribeUserTrades	사용자 거래 업데이트를 구독합니다. 선택적으로 상품 이름으로 필터링할 수 있습니다.
SubscribeBalance	계정의 잔액 업데이트를 구독합니다.

아래에서 시장 채널을 구독하는 예제를 확인하십시오.


procedure OnConnect(Connection: TsgcWSConnection);
begin
  oCryptoCom.SubscribeTicker('BTC_USDT');
  oCryptoCom.SubscribeBook('BTC_USDT', '10');
end;

REST API

REST API는 시장 및 비공개 계정에서 데이터를 요청하는 Public 및 Private 메서드를 제공합니다. 구성 요소의 REST_API 속성을 통해 REST API에 액세스하십시오.

메서드	공개 / 비공개	설명
GetInstruments	Public	사용 가능한 상품 목록을 가져옵니다.
GetTicker	Public	하나 또는 모든 instrument에 대한 ticker 정보를 가져옵니다.
GetOrderBook	Public	instrument의 호가창을 가져옵니다.
GetTrades	Public	상품에 대한 가장 최근 거래를 가져옵니다.
GetCandlestick	Public	상품의 candlestick/kline 데이터를 가져옵니다.
CreateOrder	Private	새 주문을 생성합니다. 지정가 및 시장가 주문을 지원합니다.
CancelOrder	Private	기존 주문을 취소합니다.
CancelAllOrders	Private	instrument에 대한 모든 미체결 주문을 취소합니다.
GetOpenOrders	Private	미체결 주문 목록을 가져옵니다.
GetOrderDetail	Private	특정 주문의 세부 정보를 가져옵니다.
GetOrderHistory	Private	주문 기록을 가져옵니다.
GetAccountSummary	Private	계정 요약 정보를 가져옵니다.

아래에서 REST API 사용 예제를 확인하십시오.


oCryptoCom := TsgcWS_API_CryptoCom.Create(nil);
oCryptoCom.CryptoCom.ApiKey := 'your_api_key';
oCryptoCom.CryptoCom.ApiSecret := 'your_api_secret';
// Get instruments
oCryptoCom.REST_API.GetInstruments;
// Create an order
oCryptoCom.REST_API.CreateOrder('BTC_USDT', 'BUY', 'MARKET', '', '0.001');
// Get account summary
oCryptoCom.REST_API.GetAccountSummary;