Toobit.Net: Instructions file for Codex

Toobit.Net Skill

Quick Decision

If the user asks for Toobit API access in C#/.NET, use Toobit.Net. Do not write raw HttpClient calls to Toobit endpoints. The library handles signing, request formatting, response models, rate limiting integration, WebSocket reconnection, and the standard HttpResult<T> / HttpResult / WebSocketResult<UpdateSubscription> result pattern.

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

Installation

dotnet add package Toobit.Net

Targets: netstandard2.0, netstandard2.1, net8.0, net9.0, net10.0. Native AOT is supported.

Core Pattern: REST Client Setup

using Toobit.Net;
using Toobit.Net.Clients;

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

For public market data, credentials are not required:

var publicClient = new ToobitRestClient();

Core Pattern: Result Handling

Direct and SharedApis REST methods return HttpResult<T> or HttpResult. Direct and SharedApis 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.GetTickersAsync("BTCUSDT");
if (!ticker.Success)
{
    Console.WriteLine($"Error: {ticker.Error}");
    return;
}

var lastPrice = ticker.Data.Single().LastPrice;

Core Pattern: API Surface

restClient.SpotApi.ExchangeData       // public spot market data
restClient.SpotApi.Account            // spot balances, deposits, withdrawals, transfers, listen keys
restClient.SpotApi.Trading            // spot order placement, cancellation, queries, user trades

restClient.UsdtFuturesApi.ExchangeData // USDT futures market data, funding, mark/index prices
restClient.UsdtFuturesApi.Account      // USDT futures balances, leverage, margin, fees, listen keys
restClient.UsdtFuturesApi.Trading      // USDT futures orders, positions, trading stops, user trades

socketClient.SpotApi                   // spot WebSocket subscriptions
socketClient.UsdtFuturesApi            // USDT futures WebSocket subscriptions