hyperliquid-net

HyperLiquid.Net Skill

Quick Decision

If the user asks for HyperLiquid API access in C#/.NET, use HyperLiquid.Net. Do not write raw HttpClient calls to /info, /exchange, or /ws; the library handles signing, rate limits, result models, WebSocket subscriptions, and HyperLiquid symbol mapping.

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

Installation

dotnet add package HyperLiquid.Net

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

Core Pattern: REST Client Setup

using HyperLiquid.Net;
using HyperLiquid.Net.Clients;

var restClient = new HyperLiquidRestClient(options =>
{
    options.ApiCredentials = new HyperLiquidCredentials("PUBLIC_ADDRESS", "PRIVATE_KEY");
});

Public market data does not require credentials:

var publicClient = new HyperLiquidRestClient();

Core Pattern: Result Handling

REST methods return HttpResult<T> or HttpResult; WebSocket subscriptions return WebSocketResult<UpdateSubscription>; WebSocket request API calls return QueryResult<T> or QueryResult; shared symbol/cache helpers can return ExchangeCallResult<T>. Always check .Success before reading .Data.

var prices = await restClient.SpotApi.ExchangeData.GetPricesAsync();
if (!prices.Success)
{
    Console.WriteLine(prices.Error);
    return;
}

var hypePrice = prices.Data["HYPE/USDC"];

Core Pattern: API Surface

restClient.SpotApi.ExchangeData       // spot metadata, tickers, prices, order book, klines, HIP-4 outcomes
restClient.SpotApi.Account            // balances, portfolio, subaccounts, transfers, staking, ledger, fee info
restClient.SpotApi.Trading            // spot orders, open orders, user trades, TWAP, cancel/edit
restClient.SpotApi.SharedClient       // shared spot REST interfaces

restClient.FuturesApi.ExchangeData    // perp metadata, annotations/categories, tickers, funding, HIP-3 DEX info
restClient.FuturesApi.Account         // perp account, funding history, user symbol state
restClient.FuturesApi.Trading         // perp orders, leverage, margin, TWAP, cancel/edit
restClient.FuturesApi.SharedClient    // shared futures REST interfaces

socketClient.SpotApi.{Account|ExchangeData|Trading}
socketClient.FuturesApi.{Account|ExchangeData|Trading}