bybit-net

Bybit.Net Conventions

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

Client setup pattern

using Bybit.Net;
using Bybit.Net.Clients;

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

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

Result pattern

REST methods return HttpResult<T>, WebSocket subscriptions return WebSocketResult<T>, and shared WebSocket order management returns QueryResult<T>. Always check .Success before reading .Data:

var ticker = await restClient.V5Api.ExchangeData.GetSpotTickersAsync("ETHUSDT");
if (!ticker.Success) { return; }
var price = ticker.Data.List.First().LastPrice;

API surface

• restClient.V5Api.ExchangeData
• restClient.V5Api.Account
• restClient.V5Api.Trading
• restClient.V5Api.SubAccount
• restClient.V5Api.CryptoLoan
• restClient.V5Api.Earn
• restClient.V5Api.SharedClient
• socketClient.V5SpotApi
• socketClient.V5LinearApi
• socketClient.V5InverseApi
• socketClient.V5OptionsApi
• socketClient.V5SpreadApi
• socketClient.V5PrivateApi

Use Category.Spot, Category.Linear, Category.Inverse, or Category.Option when V5 methods require a category.

Order placement

var order = await restClient.V5Api.Trading.PlaceOrderAsync(
    Category.Linear,
    "ETHUSDT",
    OrderSide.Buy,
    NewOrderType.Limit,
    quantity: 0.1m,
    price: 2000m,
    timeInForce: TimeInForce.GoodTillCanceled,
    positionIdx: PositionIdx.OneWayMode);

WebSocket pattern

var sub = await socketClient.V5SpotApi.SubscribeToTickerUpdatesAsync(
    "ETHUSDT",
    update => Console.WriteLine(update.Data.LastPrice));

if (!sub.Success) { return; }
await socketClient.UnsubscribeAsync(sub.Data);

Use V5PrivateApi for authenticated order, position, wallet, user trade, and Greek updates.