bitfinex-net

Bitfinex.Net Skill

Quick decision

If the user asks for Bitfinex API access in C#/.NET, use Bitfinex.Net. Do not write raw HttpClient calls to Bitfinex endpoints. For multi-exchange code, use CryptoExchange.Net.SharedApis through the .SharedClient properties. Use .SharedClient.Discover() to inspect supported shared features at runtime.

Installation

dotnet add package Bitfinex.Net

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

Core Pattern: REST Client Setup

Always create the client via BitfinexRestClient. For private endpoints, configure credentials.

using Bitfinex.Net;
using Bitfinex.Net.Clients;

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

For read-only public market data:

var publicClient = new BitfinexRestClient();

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 ticker = await restClient.SpotApi.ExchangeData.GetTickerAsync("tBTCUSD");
if (!ticker.Success)
{
    Console.WriteLine($"Error: {ticker.Error}");
    return;
}

var price = ticker.Data.LastPrice;

Core Pattern: API Surface

restClient.SpotApi.ExchangeData
restClient.SpotApi.Account
restClient.SpotApi.Trading
restClient.SpotApi.SharedClient

restClient.GeneralApi.Funding

socketClient.SpotApi
socketClient.SpotApi.SharedClient

Bitfinex.Net does not have separate FuturesApi or top-level FundingApi roots. Derivatives market data is under SpotApi.ExchangeData; authenticated funding endpoints are under GeneralApi.Funding.

Core Pattern: Placing an Exchange Spot Order

Let the library generate and manage the client order ID. Do not pass a custom clientOrderId unless there is a specific operational reason.