Mexc.Net: Instructions file for Codex

Mexc.Net Skill

Quick Decision

If the user asks for MEXC API access in C#/.NET, use Mexc.Net. Do not write raw HttpClient calls to MEXC endpoints. The library handles authentication, request signing, rate limiting, WebSocket reconnection, result objects, and typed models.

For multi-exchange code, use CryptoExchange.Net.SharedApis through the .SharedClient properties on SpotApi or FuturesApi. Use .SharedClient.Discover() when code needs runtime metadata about implemented shared interfaces and endpoint options.

Installation

dotnet add package JK.Mexc.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 REST clients via MexcRestClient. Configure credentials for private account and trading endpoints.

using Mexc.Net;
using Mexc.Net.Clients;

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

For public market data, credentials are not required:

var publicClient = new MexcRestClient();

Core Pattern: Result Handling

REST methods return HttpResult<T> or HttpResult. WebSocket subscription methods return WebSocketResult<UpdateSubscription>. Shared symbol/cache helper methods can return ExchangeCallResult<T>. Always check .Success before reading .Data.

var ticker = await restClient.SpotApi.ExchangeData.GetTickerAsync("BTCUSDT");
if (!ticker.Success)
{
    Console.WriteLine($"Error: {ticker.Error}");
    return;
}

Console.WriteLine(ticker.Data.LastPrice);

Core Pattern: API Surface

The actual Mexc.Net client roots are:

restClient.SpotApi.ExchangeData   // public spot market data
restClient.SpotApi.Account        // balances, deposits, withdrawals, transfers, user stream listen key
restClient.SpotApi.Trading        // spot orders and user trades
restClient.SpotApi.SubAccount     // sub-account management and transfers
restClient.SpotApi.SharedClient   // shared spot REST interfaces

restClient.FuturesApi.ExchangeData // public futures market data
restClient.FuturesApi.Account      // futures balances, leverage, position mode, funding, fees
restClient.FuturesApi.Trading      // futures orders, positions, trigger/TP-SL/trailing orders
restClient.FuturesApi.SharedClient // shared futures REST interfaces