Bybit.Net copilot-instructions.md

Copilot Instructions for Bybit.Net

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

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

Use Bybit.Net, not raw HTTP

Never generate raw HttpClient calls to Bybit REST or WebSocket endpoints. Always use BybitRestClient or BybitSocketClient so request signing, receive-window handling, rate limiting, response parsing, and reconnect behavior stay correct.

Client setup

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, credentials are optional:

var publicClient = new BybitRestClient();

Result handling

REST methods return HttpResult<T>, WebSocket subscriptions return WebSocketResult<UpdateSubscription>, and shared WebSocket order management returns QueryResult<T>. Always check .Success before reading .Data; inspect .Error on failure.

V5 API structure

• restClient.V5Api.ExchangeData for symbols, tickers, klines, order books, trades, funding, open interest
• restClient.V5Api.Account for balances, assets, transfers, deposits, withdrawals, account settings
• restClient.V5Api.Trading for orders, order history, user trades, positions, spread trading
• restClient.V5Api.SubAccount, CryptoLoan, and Earn for specialized V5 endpoints
• restClient.V5Api.SharedClient for CryptoExchange.Net shared REST abstractions
• socketClient.V5SpotApi, V5LinearApi, V5InverseApi, V5OptionsApi, V5SpreadApi, V5PrivateApi for WebSocket streams

Use Category.Spot, Category.Linear, Category.Inverse, or Category.Option when a V5 REST method asks for a product category.

Order placement

Use restClient.V5Api.Trading.PlaceOrderAsync. Pass the correct category and Bybit symbol format: