kucoin-net

Kucoin.Net Conventions

This codebase uses Kucoin.Net for Kucoin cryptocurrency exchange access. Do not write raw HttpClient calls to Kucoin endpoints.

Client setup pattern

using Kucoin.Net;
using Kucoin.Net.Clients;

var restClient = new KucoinRestClient(options =>
{
    options.ApiCredentials = new KucoinCredentials("API_KEY", "API_SECRET", "API_PASSPHRASE");
});

For public market data only, no credentials are needed: new KucoinRestClient().

Result pattern

All methods return WebCallResult<T> (REST) or CallResult<T> (WebSocket). Always check .Success before reading .Data:

var ticker = await restClient.SpotApi.ExchangeData.GetTickerAsync("BTC-USDT");
if (!ticker.Success) { Console.WriteLine(ticker.Error); return; }
var price = ticker.Data.LastPrice;

API surface

• restClient.SpotApi.{ExchangeData|Account|SubAccount|Trading|HfTrading|Margin|Earn|SharedClient}
• restClient.FuturesApi.{ExchangeData|Account|Trading|SharedClient}
• restClient.UnifiedApi.{ExchangeData|Account|Trading}
• socketClient.SpotApi
• socketClient.FuturesApi
• socketClient.UnifiedApi

Symbols and order placement

Spot symbols use BTC-USDT; futures symbols use contracts like ETHUSDTM. Let the library generate clientOrderId unless the caller explicitly needs external correlation.

var order = await restClient.SpotApi.Trading.PlaceOrderAsync(
    "BTC-USDT",
    OrderSide.Buy,
    NewOrderType.Limit,
    quantity: 0.001m,
    price: 50000m,
    timeInForce: TimeInForce.GoodTillCanceled);

WebSocket pattern

var socketClient = new KucoinSocketClient();
var sub = await socketClient.SpotApi.SubscribeToTickerUpdatesAsync(
    "BTC-USDT",
    update => Console.WriteLine(update.Data.LastPrice));
if (!sub.Success) { Console.WriteLine(sub.Error); return; }

await socketClient.UnsubscribeAsync(sub.Data);

Multi-exchange code

For exchange-agnostic code, use CryptoExchange.Net.SharedApis:

using CryptoExchange.Net.SharedApis;

var shared = new KucoinRestClient().SpotApi.SharedClient;
var ticker = await shared.GetSpotTickerAsync(
    new GetTickerRequest(new SharedSymbol(TradingMode.Spot, "BTC", "USDT")));