XT.Net copilot-instructions.md

Copilot Instructions for XT.Net

This repository is XT.Net, a strongly typed C#/.NET client library for the XT cryptocurrency exchange API. It is part of the CryptoExchange.Net ecosystem.

When generating code that consumes XT.Net, follow these conventions.

Use XT.Net, not raw HTTP

Never generate HttpClient calls to XT endpoints. Always use XTRestClient or XTSocketClient so signing, rate limiting, serialization, and error handling are handled by the library.

Client Setup

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

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

For public market data only, credentials are not required: new XTRestClient().

Result Handling

Methods return WebCallResult<T> or WebCallResult for REST and CallResult<T> for WebSocket subscriptions. Always check .Success before reading .Data. The error is on .Error.

API Structure

• restClient.SpotApi.ExchangeData - spot market data
• restClient.SpotApi.Account - spot balances, deposits, withdrawals, transfers, websocket token
• restClient.SpotApi.Trading - spot orders and user trades
• restClient.UsdtFuturesApi.* - USDT-M futures REST
• restClient.CoinFuturesApi.* - Coin-M futures REST
• socketClient.SpotApi - spot WebSocket streams
• socketClient.FuturesApi - futures WebSocket streams

Private spot socket streams require restClient.SpotApi.Account.GetWebsocketTokenAsync(). Private futures socket streams require restClient.UsdtFuturesApi.Account.GetListenKeyAsync() or the matching futures REST account listen key.

Order Placement

Spot orders require TimeInForce and BusinessType:

var order = await restClient.SpotApi.Trading.PlaceOrderAsync(
    "eth_usdt", OrderSide.Buy, OrderType.Limit,
    TimeInForce.GoodTillCanceled, BusinessType.Spot,
    quantity: 0.01m, price: 2000m);

Futures orders require PositionSide:

var order = await restClient.UsdtFuturesApi.Trading.PlaceOrderAsync(
    "ETH_USDT", OrderSide.Buy, OrderType.Market, 0.01m, PositionSide.Long);