API GateIO

Gate.io

지원되는 API

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

Properties

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

• giocSpot: Spot WebSocket API에 연결합니다.
• giocFutures: Futures WebSocket API에 연결합니다.

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

• ApiKey: Gate.io 계정에서 새 api key를 요청하고 값을 이 속성에 복사하기만 하면 됩니다. APIKey가 설정되면 클라이언트는 private 서버에 대해 인증합니다. 비어 있으면 public 채널만 사용할 수 있습니다.
• ApiSecret: api의 비밀 값입니다.
• Resubscribe: 활성화되면 재연결 후 클라이언트가 연결 해제 전에 활성 상태였던 채널을 자동으로 다시 구독합니다(기본적으로 false).

연결

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

oClient := TsgcWebSocketClient.Create(nil);
oGateIO := TsgcWS_API_GateIO.Create(nil);
oGateIO.Client := oClient;
oGateIO.GateIO.ApiKey := 'your_api_key';
oGateIO.GateIO.ApiSecret := 'your_api_secret';
oGateIO.GateIOChannel := giocSpot;
oClient.Active := True;
procedure OnConnect(Connection: TsgcWSConnection);
begin
  DoLog('#GateIO Connected');
end;

Events

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

• OnConnect: websocket 클라이언트가 WebSocket Server에 연결할 때 발생합니다.
• OnDisconnect: websocket 클라이언트가 WebSocket Server에서 연결을 끊을 때 발생합니다.
• OnGateIOAuthentication: 클라이언트가 비공개 WebSocket 서버에 대해 인증할 때 발생합니다.
• OnGateIOSubscribe: 클라이언트가 websocket 채널을 구독할 때.
• OnGateIOUnSubscribe: 클라이언트가 websocket 채널의 구독을 취소할 때.
• OnGateIOData: 클라이언트가 서버로부터 데이터를 받을 때.
• OnGateIOError: GateIO websocket 연결 중 오류가 발생할 때.
• OnGateIOHTTPException: REST 요청 중에 오류가 있을 때 발생합니다.

WebSocket API

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

다음 채널을 구독할 수 있습니다:

메서드	공개 또는 비공개	설명
SubscribeTicker	Public	심볼에 대한 ticker 스트림을 구독합니다.
SubscribeTrades	Public	최근 거래 스트림을 구독합니다.
SubscribeCandlesticks	Public	캔들스틱 스트림을 구독합니다. 여러 간격(예: 1m, 5m, 15m, 30m, 1h)을 지원합니다.
SubscribeOrderBook	Public	호가창 스트림을 구독합니다. 구성 가능한 depth 레벨과 업데이트 간격을 지원합니다.
SubscribeOrders	Private	주문 업데이트를 구독합니다. 인증이 필요합니다.
SubscribeBalances	Private	잔액 업데이트를 구독합니다. 인증이 필요합니다.

공개 websocket 채널을 구독하는 예제는 아래에서 확인하십시오.

procedure OnConnect(Connection: TsgcWSConnection);
begin
  oGateIO.SubscribeTicker('BTC_USDT');
  oGateIO.SubscribeOrderBook('BTC_USDT', '20', '100ms');
end;

REST API

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

메서드	공개 / 비공개	설명
GetCurrencyPairs	Public	사용 가능한 통화 쌍에 대한 정보를 가져옵니다.
GetTickers	Public	하나 또는 모든 통화 쌍에 대한 ticker 정보를 가져옵니다.
GetOrderBook	Public	통화 쌍에 대한 주문서를 가져옵니다.
GetCandlesticks	Public	통화 쌍에 대한 캔들스틱/kline 데이터를 가져옵니다.
GetTrades	Public	통화 쌍에 대한 가장 최근 거래를 가져옵니다.
PlaceOrder	Private	새 주문을 넣습니다. limit 및 market 주문을 지원합니다.
CancelOrder	Private	기존 주문을 취소합니다.
GetOrder	Private	특정 주문의 세부 정보를 가져옵니다.
GetOpenOrders	Private	미체결 주문 목록을 가져옵니다.
GetSpotAccounts	Private	spot 계정 정보를 가져옵니다.

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

oGateIO := TsgcWS_API_GateIO.Create(nil);
oGateIO.GateIO.ApiKey := 'your_api_key';
oGateIO.GateIO.ApiSecret := 'your_api_secret';
// Get tickers
oGateIO.REST_API.GetTickers('BTC_USDT');
// Place an order
oGateIO.REST_API.PlaceOrder('BTC_USDT', 'buy', '0.001', '50000', 'limit');