API Bitget

Bitget

지원되는 API

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

Properties

BitgetChannel 속성을 사용하여 채널 유형을 선택하십시오:

• bgcSpot: Spot WebSocket API에 연결합니다.
• bgcFutures: Futures WebSocket API에 연결합니다.

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

• ApiKey: Bitget 계정에서 새 api 키를 요청하고, 그 값을 이 속성에 복사하기만 하면 됩니다. APIKey가 설정되면 클라이언트는 websocket private 서버에 연결합니다. 비어 있으면 WebSocket public 서버에 연결합니다.
• ApiSecret: api의 비밀 값입니다.
• Passphrase: 새 api 키를 생성할 때 정의된 사용자 지정 문자열입니다.
• Resubscribe: 활성화되면 재연결 후 클라이언트가 연결 해제 전에 활성 상태였던 채널을 자동으로 다시 구독합니다(기본적으로 false).

연결

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

oClient := TsgcWebSocketClient.Create(nil);
oBitget := TsgcWS_API_Bitget.Create(nil);
oBitget.Client := oClient;
oBitget.Bitget.ApiKey := 'your_api_key';
oBitget.Bitget.ApiSecret := 'your_api_secret';
oBitget.Bitget.Passphrase := 'your_passphrase';
oBitget.BitgetChannel := bgcSpot;
oClient.Active := True;
procedure OnConnect(Connection: TsgcWSConnection);
begin
  DoLog('#Bitget Connected');
end;

Events

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

• OnConnect: websocket 클라이언트가 WebSocket Server에 연결할 때 발생합니다.
• OnDisconnect: websocket 클라이언트가 WebSocket Server에서 연결을 끊을 때 발생합니다.
• OnBitgetAuthentication: 클라이언트가 Private WebSocket Server에 대해 인증할 때 발생합니다.
• OnBitgetSubscribe: 클라이언트가 websocket 채널을 구독할 때.
• OnBitgetUnSubscribe: 클라이언트가 websocket 채널에서 구독 해제할 때입니다.
• OnBitgetData: 클라이언트가 서버로부터 데이터를 받을 때입니다.
• OnBitgetError: Bitget websocket 연결 중 오류가 있을 때.
• OnBitgetHTTPException: REST 요청 중 오류가 있을 때.

WebSocket API

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

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

메서드	공개 또는 비공개	설명
SubscribeTicker	Public	상품의 ticker 스트림을 구독합니다.
SubscribeTrade	Public	최근 거래 스트림을 구독합니다.
SubscribeCandle	Public	캔들스틱 스트림을 구독합니다. 여러 간격을 지원합니다(예: candle1m, candle5m, candle1H).
SubscribeOrderBook	Public	주문서 스트림을 구독합니다. 다양한 깊이 레벨을 지원합니다.
SubscribeOrders	Private	주문 업데이트를 구독합니다. 인증이 필요합니다.
SubscribePositions	Private	포지션 업데이트를 구독합니다. 인증이 필요합니다.
SubscribeAccount	Private	계정 잔액 업데이트를 구독합니다. 인증이 필요합니다.

성공적인 인증 후 private websocket 채널을 구독하는 예제는 아래에서 확인하십시오.

procedure OnBitgetAuthentication(Sender: TObject; aSuccess: Boolean; const aError, aRawMessage: string);
begin
  if aSuccess then
  begin
    oBitget.SubscribeOrders('BTCUSDT');
    oBitget.SubscribeAccount();
  end;
end;

REST API

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

메서드	공개 / 비공개	설명
GetServerTime	Public	서버 시간을 가져옵니다.
GetTickers	Public	하나 또는 모든 심볼에 대한 티커 정보를 가져옵니다.
GetOrderBook	Public	심볼에 대한 호가창을 가져옵니다.
GetCandles	Public	심볼에 대한 캔들스틱/kline 데이터를 가져옵니다.
GetRecentTrades	Public	심볼의 가장 최근 거래를 가져옵니다.
PlaceOrder	Private	새 주문을 배치합니다.
CancelOrder	Private	기존 주문을 취소합니다.
GetOpenOrders	Private	미체결 주문 목록을 가져옵니다.
GetOrderDetail	Private	특정 주문의 세부 정보를 가져옵니다.
GetOrderHistory	Private	주문 기록을 가져옵니다.
GetAccountAssets	Private	계정 자산 정보를 가져옵니다.
GetAccountInfo	Private	계정 정보를 가져옵니다.

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

oBitget := TsgcWS_API_Bitget.Create(nil);
oBitget.Bitget.ApiKey := 'your_api_key';
oBitget.Bitget.ApiSecret := 'your_api_secret';
oBitget.Bitget.Passphrase := 'your_passphrase';
// Get tickers
oBitget.REST_API.GetTickers('SPOT');
// Place an order
oBitget.REST_API.PlaceOrder('BTCUSDT', 'buy', 'market', 'normal', '0.01');