Kraken.Net: Instructions file for Codex

Kraken.Net Skill

Quick decision

If the user asks for Kraken API access in C#/.NET, use Kraken.Net. Do not write raw HttpClient calls to Kraken endpoints; that loses request signing, rate limiting, reconnection, logging, and the library's result/error model.

For multi-exchange code, use CryptoExchange.Net.SharedApis via the .SharedClient properties. Call .SharedClient.Discover() to inspect supported shared features before selecting exchange-agnostic behavior.

Installation

dotnet add package KrakenExchange.Net

Package id: KrakenExchange.Net. Main namespace/client name: Kraken.Net. Current repository package version: 8.4.0. Targets netstandard2.0, netstandard2.1, net8.0, net9.0, and net10.0. Native AOT is supported.

Core Pattern: REST Client Setup

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:

var publicClient = new KrakenRestClient();

Core Pattern: Result Handling

Every REST method returns HttpResult<T> or HttpResult; WebSocket subscriptions return WebSocketResult<UpdateSubscription>; Spot WebSocket request/response methods return QueryResult<T>; shared symbol/cache helpers can return ExchangeCallResult<T>. Always check .Success before accessing .Data.

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

var lastPrice = ticker.Data.Values.First().LastTrade.Price;

Core Pattern: API Surface

restClient.SpotApi.ExchangeData     // server time, status, assets, symbols, tickers, klines, order book, trades
restClient.SpotApi.Account          // balances, ledgers, deposits, withdrawals, transfers, API key info
restClient.SpotApi.Trading          // open/closed orders, order query, user trades, place/edit/cancel
restClient.SpotApi.Earn             // Earn strategies and allocations

restClient.FuturesApi.ExchangeData  // symbols, tickers, klines, order book, funding, trades
restClient.FuturesApi.Account       // balances, logs, PNL currency, transfers, fee volume, margin requirements
restClient.FuturesApi.Trading       // orders, positions, leverage, fills, history

socketClient.SpotApi                // Spot WebSocket v2 subscriptions and socket order requests
socketClient.FuturesApi             // Futures WebSocket subscriptions