binance-net

Binance.Net Conventions

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

Client setup pattern

using Binance.Net.Clients;
using Binance.Net;
using Binance.Net.Objects;

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

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

Result pattern

REST methods return HttpResult<T> / HttpResult; WebSocket subscriptions and socket API requests return WebSocketResult<T> / WebSocketResult. Always check .Success before reading .Data:

var ticker = await restClient.SpotApi.ExchangeData.GetTickerAsync("BTCUSDT");
if (!ticker.Success) { /* ticker.Error */ return; }
var price = ticker.Data.LastPrice;

API surface

• restClient.SpotApi.{ExchangeData|Account|Trading}
• restClient.UsdFuturesApi.{ExchangeData|Account|Trading}
• restClient.CoinFuturesApi.{ExchangeData|Account|Trading}
• restClient.GeneralApi.{Brokerage|Futures|CryptoLoans|AutoInvest|Mining|SubAccount|Staking|SimpleEarn|CopyTrading|GiftCard|Nft}
• socketClient.SpotApi.{ExchangeData|Account|Trading} for WebSocket subscriptions and requests
• socketClient.UsdFuturesApi.{ExchangeData|Account|Trading} for WebSocket subscriptions and requests
• socketClient.CoinFuturesApi.{ExchangeData|Account|Trading} for WebSocket subscriptions

Order placement

Let the library auto-generate clientOrderId. Do not pass a custom one unless required for an existing operational flow:

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

WebSocket pattern

var socketClient = new BinanceSocketClient();
var sub = await socketClient.SpotApi.ExchangeData.SubscribeToTickerUpdatesAsync(
    "BTCUSDT",
    update => { /* update.Data.LastPrice */ });
if (!sub.Success) { /* sub.Error */ return; }

// On shutdown:
await socketClient.UnsubscribeAsync(sub.Data);