xt-net

XT.Net Skill

Quick Decision

If the user asks for XT API access in C#/.NET, use XT.Net. Do not write raw HttpClient calls to XT endpoints; XT.Net handles request signing, timestamping, response parsing, client-side rate limiting, WebSocket reconnects, and HttpResult<T> / WebSocketResult<UpdateSubscription> error handling.

For multi-exchange code, use CryptoExchange.Net.SharedApis from the .SharedClient properties.

Installation

dotnet add package XT.Net

Targets: netstandard2.0, netstandard2.1, net8.0, net9.0, net10.0. Native AOT is supported.

REST Client Setup

Always create REST clients via XTRestClient. Configure credentials for account and trading calls.

using XT.Net;
using XT.Net.Clients;

var restClient = new XTRestClient(options =>
{
    options.ApiCredentials = new XTCredentials("API_KEY", "API_SECRET");
});

Public market data does not require credentials:

var publicClient = new XTRestClient();

Result Handling

Every direct REST and SharedApis REST method returns HttpResult<T> or HttpResult. Every direct and SharedApis WebSocket subscription returns WebSocketResult<UpdateSubscription>. Always check .Success before reading .Data.

var ticker = await restClient.SpotApi.ExchangeData.GetTickersAsync("eth_usdt");
if (!ticker.Success)
{
    Console.WriteLine($"XT error: {ticker.Error}");
    return;
}

var firstTicker = ticker.Data.First();

Use result.Error?.IsTransient == true as a retry hint. Do not retry validation errors, bad signatures, missing permissions, invalid quantities, or insufficient balance indefinitely.

API Surface

restClient.SpotApi.ExchangeData        // spot market data, symbols, tickers, klines, order books, trades
restClient.SpotApi.Account             // balances, deposits, withdrawals, transfers, websocket token
restClient.SpotApi.Trading             // place/cancel/edit/query spot orders, user trades

restClient.UsdtFuturesApi.ExchangeData // USDT-M futures market data
restClient.UsdtFuturesApi.Account      // USDT-M balances, leverage, margin, fee rate, listen key
restClient.UsdtFuturesApi.Trading      // USDT-M orders, positions, trigger/TP-SL/track orders

restClient.CoinFuturesApi.*            // Coin-M futures with the same futures REST structure

socketClient.SpotApi                   // spot public and private streams
socketClient.FuturesApi                // futures public and private streams