KuCoin Spot and Futures API Integration in Delphi

The TsgcWSAPI_Kucoin and TsgcWSAPI_Kucoin_Futures components deliver comprehensive Delphi access to the KuCoin exchange, spanning real-time WebSocket market data, private account streams, and a full REST API for trading, withdrawals, and market queries. This guide covers every method available across both spot and futures, with configuration details and working code examples.

Spot WebSocket API

The spot WebSocket API provides real-time streaming for market data and private account events. Public channels are available without authentication, while private channels require valid API credentials.

Public Channels

Public channels stream market data to all connected clients without requiring authentication. Each subscribe method has a corresponding unsubscribe method.

Private Channels

Private channels require valid API credentials and provide real-time updates on your orders, balances, positions, and margin activity.

Spot REST API

The spot REST API is accessed via the REST_API property of TsgcWSAPI_Kucoin. All methods return JSON strings. The API covers accounts, withdrawals, order management, stop orders, and market data.

Accounts

Withdrawals

Orders

Stop Orders

Market Data

Futures WebSocket API

The futures WebSocket API is provided by TsgcWSAPI_Kucoin_Futures and offers real-time streaming for futures contract data and private account events.

Public Channels

Private Channels

Futures REST API

The futures REST API is accessed via the REST_API property of TsgcWSAPI_Kucoin_Futures. These methods cover margin management, risk limits, funding history, and order book queries.

Code Example

The following example demonstrates how to create and configure the TsgcWSAPI_Kucoin component for spot trading, authenticate with the API, retrieve tickers via REST, place an order, and subscribe to a real-time ticker stream via WebSocket.

var
  oClient: TsgcWebSocketClient;
  oKucoin: TsgcWSAPI_Kucoin;
begin
  // Create the WebSocket client
  oClient := TsgcWebSocketClient.Create(nil);
  oKucoin := TsgcWSAPI_Kucoin.Create(nil);
  oKucoin.Client := oClient;

  // Configure API credentials
  oKucoin.Kucoin.ApiKey := 'your_api_key';
  oKucoin.Kucoin.ApiSecret := 'your_api_secret';
  oKucoin.Kucoin.Passphrase := 'your_passphrase';

  // Connect to KuCoin
  oClient.Active := True;

  // REST: Get all tickers
  ShowMessage(oKucoin.REST_API.GetAllTickers);

  // REST: Place a limit order
  ShowMessage(oKucoin.REST_API.PlaceOrder(myOrder));

  // WebSocket: Subscribe to BTC-USDT ticker
  oKucoin.SubscribeSymbolTicker('BTC-USDT');
end;

Handling WebSocket Events

Assign an event handler to process incoming messages. The event provides the topic, subject, and JSON data for each update.

procedure TForm1.OnKucoinEvent(Sender: TObject;
  const aTopic, aSubject, aData: string);
begin
  // aTopic identifies the channel
  // aSubject provides the specific symbol or identifier
  // aData contains the JSON payload
  Memo1.Lines.Add(aTopic + ' [' + aSubject + ']: ' + aData);
end;

Configuration & Notes

Configuration Properties

Both TsgcWSAPI_Kucoin (spot) and TsgcWSAPI_Kucoin_Futures (futures) share the same authentication properties, accessed through the Kucoin property.

Important Notes

• Use TsgcWSAPI_Kucoin for spot trading and TsgcWSAPI_Kucoin_Futures for futures trading. Each component connects to a different KuCoin endpoint.
• The Passphrase property is mandatory for KuCoin and is set during API key creation on the KuCoin website.
• All REST methods return JSON strings. Use a JSON parser (such as TJSONObject from System.JSON) to parse responses.
• Public WebSocket channels do not require authentication and can be used for market data without setting API credentials.
• Private WebSocket channels and all REST methods that modify account state require valid API credentials.
• KuCoin enforces rate limits on both REST and WebSocket APIs. Refer to the official KuCoin documentation for current limits.
• WebSocket connections use a token-based authentication system. The component handles token acquisition and renewal automatically.