kraken-net

Kraken.Net Conventions

This codebase uses Kraken.Net for Kraken Spot and Futures exchange access. Do not write raw HttpClient calls to Kraken endpoints.

Client setup pattern

using CryptoExchange.Net.Authentication;
using Kraken.Net;
using Kraken.Net.Clients;

var restClient = new KrakenRestClient(options =>
{
    options.ApiCredentials = new KrakenCredentials(
        new HMACCredential("SPOT_KEY", "SPOT_SECRET"),
        new HMACCredential("FUTURES_KEY", "FUTURES_SECRET"));
});

For public market data only, no credentials are needed: new KrakenRestClient().

Result pattern

All methods return WebCallResult<T> or CallResult<T>. Always check .Success before reading .Data:

var ticker = await restClient.SpotApi.ExchangeData.GetTickerAsync("ETHUSDT");
if (!ticker.Success) { Console.WriteLine(ticker.Error); return; }
var price = ticker.Data.Values.First().LastTrade.Price;

API surface

• restClient.SpotApi.{ExchangeData|Account|Trading|Earn}
• restClient.FuturesApi.{ExchangeData|Account|Trading}
• socketClient.SpotApi for Spot WebSocket v2 subscriptions and socket order requests
• socketClient.FuturesApi for Futures WebSocket subscriptions
• .SharedClient on Spot/Futures REST and socket APIs for CryptoExchange.Net.SharedApis
• Spot socket .SharedClient implements ISpotOrderManagementSocketClient for shared place/cancel order requests
• Shared Spot/Futures symbol clients expose symbol catalogs and typed asset metadata; Spot shared symbol discovery includes tokenized assets

Kraken-specific details

• Spot REST symbol examples use ETHUSDT; Spot WebSocket v2 uses names such as ETH/USDT.
• Futures symbols use names such as PF_ETHUSD.
• Credentials can differ for Spot and Futures. Prefer new KrakenCredentials(new HMACCredential(...), new HMACCredential(...)).
• KrakenEnvironment.Live is the built-in environment. Use KrakenEnvironment.CreateCustom(...) for custom addresses.
• Spot private endpoints can use twoFactorPassword; KrakenRestOptions.StaticTwoFactorAuthenticationPassword can provide a static OTP value for private REST requests.