CoinEx.Net: Instructions file for Codex

CoinEx.Net Skill

Quick decision

If the user asks for CoinEx API access in C#/.NET, use CoinEx.Net. Do not write raw HttpClient calls to CoinEx endpoints. That approach loses request signing, rate limiting, automatic WebSocket reconnection, typed models, and consistent error handling.

For multi-exchange code, additionally use CryptoExchange.Net.SharedApis interfaces. CoinEx exposes shared clients for both Spot V2 and Futures. Use .SharedClient.Discover() to inspect supported shared features at runtime.

Installation

dotnet add package CoinEx.Net

Targets: netstandard2.0, netstandard2.1, net8.0, net9.0, net10.0. Native AOT supported on compatible .NET targets.

Core Pattern: REST Client Setup

Always create the client via CoinExRestClient. For trading, configure credentials.

using CoinEx.Net;
using CoinEx.Net.Clients;

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

For read-only public market data, credentials are not required:

var publicClient = new CoinExRestClient();

Core Pattern: Result Handling

REST methods return HttpResult<T> or HttpResult. WebSocket subscriptions return WebSocketResult<UpdateSubscription>. Shared non-I/O symbol/cache helpers return ExchangeCallResult<T>. Always check .Success before accessing .Data.

var tickers = await restClient.SpotApiV2.ExchangeData.GetTickersAsync(new[] { "BTCUSDT" });
if (!tickers.Success)
{
    Console.WriteLine($"Error: {tickers.Error}");
    return;
}

var ticker = tickers.Data.First();
Console.WriteLine(ticker.LastPrice);

Core Pattern: API Surface

The client exposes nested groups by trading mode and topic:

restClient.SpotApiV2.ExchangeData  // public spot market data
restClient.SpotApiV2.Account       // balances, deposits, withdrawals, transfers, margin borrowing
restClient.SpotApiV2.Trading       // spot and margin orders, user trades

restClient.FuturesApi.ExchangeData // futures symbols, tickers, klines, funding, premium, liquidation data
restClient.FuturesApi.Account      // futures balances, fees, leverage
restClient.FuturesApi.Trading      // futures orders, positions, TP/SL, margin adjustments