![]() |
VOOZH | about |
dotnet add package HyperLiquid.Net --version 4.8.0
NuGet\Install-Package HyperLiquid.Net -Version 4.8.0
<PackageReference Include="HyperLiquid.Net" Version="4.8.0" />
<PackageVersion Include="HyperLiquid.Net" Version="4.8.0" />Directory.Packages.props
<PackageReference Include="HyperLiquid.Net" />Project file
paket add HyperLiquid.Net --version 4.8.0
#r "nuget: HyperLiquid.Net, 4.8.0"
#:package HyperLiquid.Net@4.8.0
#addin nuget:?package=HyperLiquid.Net&version=4.8.0Install as a Cake Addin
#tool nuget:?package=HyperLiquid.Net&version=4.8.0Install as a Cake Tool
HyperLiquid.Net is a client library for accessing the HyperLiquid DEX REST and Websocket API.
The library is targeting both .NET Standard 2.0 and .NET Standard 2.1 for optimal compatibility, as well as the latest dotnet versions to use the latest framework features.
| .NET implementation | Version Support |
|---|---|
| .NET Core | 2.0 and higher |
| .NET Framework | 4.6.1 and higher |
| Mono | 5.4 and higher |
| Xamarin.iOS | 10.14 and higher |
| Xamarin.Android | 8.0 and higher |
| UWP | 10.0.16299 and higher |
| Unity | 2018.1 and higher |
👁 NuGet version
👁 Nuget downloads
dotnet add package HyperLiquid.Net
HyperLiquid.Net is available on GitHub packages. You'll need to add https://nuget.pkg.github.com/JKorf/index.json as a NuGet package source.
The NuGet package files are added along side the source with the latest GitHub release which can found here.
The library uses [BaseAsset]/[QuoteAsset] notation for Spot symbols and [BaseAsset] for futures symbols. Futures symbols inherently have USDC as quote symbol.
Spot symbol: HYPE/USDC
Futures symbol: HYPE
Basic request:
var restClient = new HyperLiquidRestClient();
// Spot HYPE/USDC info
var spotTickerResult = await restClient.SpotApi.ExchangeData.GetExchangeInfoAndTickersAsync();
var hypeInfo = spotTickerResult.Data.Tickers.Single(x => x.Symbol == "HYPE/USDC");
var currentHypePrice = hypeInfo.MidPrice;
// Futures ETH perpetual contract info
var futuresTickerResult = await restClient.FuturesApi.ExchangeData.GetExchangeInfoAndTickersAsync();
var ethInfo = futuresTickerResult.Data.Tickers.Single(x => x.Symbol == "ETH");
var currentEthPrice = ethInfo.MidPrice;
Place order:
var restClient = new HyperLiquidRestClient(opts => {
opts.ApiCredentials = new HyperLiquidCredentials("PUBLICKEY", "PRIVATEKEY");
});
// Place Limit order to go long for 0.1 ETH at 2000
var orderResult = await restClient.FuturesApi.Trading.PlaceOrderAsync(
"ETH",
OrderSide.Buy,
OrderType.Limit,
0.1m,
2000
);
WebSocket subscription:
// Subscribe to HYPE/USDC Spot ticker updates via the websocket API
var socketClient = new HyperLiquidSocketClient();
var tickerSubscriptionResult = await hyperLiquidSocketClient.SpotApi.SubscribeToSymbolUpdatesAsync("HYPE/USDC", (update) =>
{
var lastPrice = update.Data.MidPrice;
});
For information on the clients, dependency injection, response processing and more see the documentation, or have a look at the examples here or here.
NOTE
HyperLiquid.Net uses the Builder Code mechanism for HyperLiquid, which means that an additional 1bps / 0.01% fee is charged on top of orders placed with the library to fund development. This is entirely optional and can be disabled in the client options by setting BuilderFeePercentage to 0 or null in the client options.
HyperLiquid.Net includes AI-oriented documentation and examples for code generation tools:
| File | Purpose |
|---|---|
| Assistant skill with core HyperLiquid.Net patterns, pitfalls, and examples | |
| Short LLM index with links to docs, examples, and critical usage rules | |
| Detailed LLM context with endpoint routing, code patterns, and anti-hallucination checks | |
| Table-style intent-to-method map for Spot, Futures, WebSocket, and SharedApis | |
| Compilable single-file examples for common REST, WebSocket, shared API, and error handling workflows |
GitHub Copilot and Cursor instructions are also provided in .github/copilot-instructions.md and .cursor/rules/hyperliquid-net.mdc; both point back to the root AI context files.
HyperLiquid.Net is based on the CryptoExchange.Net base library. Other exchange API implementations based on the CryptoExchange.Net base library are available and follow the same logic.
CryptoExchange.Net also allows for easy access to different exchange API's.
When using multiple of these API's the CryptoClients.Net package can be used which combines this and the other packages and allows easy access to all exchange API's.
👁 Nuget version
A Discord server is available here. For discussion and/or questions around the CryptoExchange.Net and implementation libraries, feel free to join.
The signing method used in the library is not natively supported on OSX. Because of this a custom signing method has to be provided or a PlatformNotSupported exception will be thrown while trying to sign a request.
A custom signing method can be provided using HyperLiquidExchange.SignRequestDelegate = CustomSigningMethod;.
To run on OSX the Nethereum.Signer.EIP712 package can be installed with the following custom signing method:
Dictionary<string, object> Sign(string request, string secret)
{
var messageBytes = Convert.FromHexString(request);
var sign = new MessageSigner().SignAndCalculateV(messageBytes, new EthECKey(secret));
return new Dictionary<string, object>()
{
{ "r", "0x" + Convert.ToHexString(sign.R).ToLowerInvariant() },
{ "s", "0x" + Convert.ToHexString(sign.S).ToLowerInvariant() },
{ "v", (int)sign.V[0] }
};
}
Requests are available on both the WebSocket and REST client
| API | Supported | Location |
|---|---|---|
| Info | ✓ | restClient.SpotApi.Account / restClient.SpotApi.ExchangeData / restClient.SpotApi.Trading restClient.FuturesApi.Account / restClient.FuturesApi.ExchangeData / restClient.FuturesApi.Trading |
| Info Perpetuals | ✓ | restClient.FuturesApi.Account / restClient.FuturesApi.ExchangeData |
| Info Spot | ✓ | restClient.SpotApi.Account / restClient.SpotApi.ExchangeData |
| Exchange | ✓ | restClient.SpotApi.Account / restClient.SpotApi.Trading restClient.FuturesApi.Account / restClient.FuturesApi.Trading |
| API | Supported | Location |
|---|---|---|
| * | ✓ | socketClient.SpotApi / socketClient.FuturesApi |
Any support is greatly appreciated.
If you do not yet have an account please consider using this referal link to sign up:
Link
Not only will you support development at no cost, you also get a 4% discount in fees.
Make a one time donation in a crypto currency of your choice. If you prefer to donate a currency not listed here please contact me.
Btc: bc1q277a5n54s2l2mzlu778ef7lpkwhjhyvghuv8qf
Eth: 0xcb1b63aCF9fef2755eBf4a0506250074496Ad5b7
USDT (TRX) TKigKeJPXZYyMVDgMyXxMf17MWYia92Rjd
Alternatively, sponsor me on Github using Github Sponsors.
Version 4.8.0 - 08 Jun 2026
Version 4.7.1 - 02 Jun 2026
Version 4.7.0 - 01 Jun 2026
Version 4.6.1 - 29 May 2026
Version 4.6.0 - 26 May 2026
Version 4.5.1 - 12 May 2026
Version 4.5.0 - 01 May 2026
Version 4.4.1 - 28 Apr 2026
Version 4.4.0 - 24 Apr 2026
Version 4.3.0 - 09 Apr 2026
Version 4.2.1 - 02 Apr 2026
Version 4.2.0 - 31 Mar 2026
Version 4.1.0 - 26 Mar 2026
dex parameter to futures socket clientVersion 4.0.1 - 24 Mar 2026
Version 4.0.0 - 24 Mar 2026
Updated CryptoExchange.Net to version 11.0.1, see https://github.com/JKorf/CryptoExchange.Net/releases/ for full release notes
Updated class for supplying API credentials from ApiCredentials to HyperLiquidCredentials
Added 1bps builder fee enabled by default, can be disabled in the options
Added full WebSocket request API
Split WebSocket client into Account, ExchangeData and Trading topics
Updated Shared order status parsing to default to Unknown value if not parsable
Added missing order status Enum values
Updated signing logic to unified logic in the CryptoExchange.Net library
Updated HyperLiquidUserUpdate model
Added UnknownOrder error response mapping
Notes for updating:
ApiCredentials = new ApiCredentials(..) ⇒ ApiCredentials = new HyperLiquidCredentials(..)Version 3.10.0 - 06 Mar 2026
Version 3.9.0 - 24 Feb 2026
Version 3.8.0 - 16 Feb 2026
Version 3.7.0 - 10 Feb 2026
Version 3.6.0 - 06 Feb 2026
Version 3.5.1 - 29 Jan 2026
Version 3.5.0 - 22 Jan 2026
Version 3.4.1 - 14 Jan 2026
Version 3.4.0 - 13 Jan 2026
Version 3.3.0 - 08 Jan 2026
Version 3.2.0 - 07 Jan 2026
Version 3.1.0 - 24 Dec 2025
Version 3.0.0 - 16 Dec 2025
Version 2.17.0 - 11 Nov 2025
Version 2.16.0 - 03 Nov 2025
Version 2.15.0 - 27 Oct 2025
Version 2.14.0 - 16 Oct 2025
Version 2.13.2 - 13 Oct 2025
Version 2.13.1 - 07 Oct 2025
Version 2.13.0 - 30 Sep 2025
Version 2.12.0 - 15 Sep 2025
Version 2.11.0 - 01 Sep 2025
Version 2.10.1 - 27 Aug 2025
Version 2.10.0 - 25 Aug 2025
Version 2.9.1 - 21 Aug 2025
Version 2.9.0 - 20 Aug 2025
Version 2.8.1 - 11 Aug 2025
Version 2.8.0 - 08 Aug 2025
Version 2.7.0 - 06 Aug 2025
Version 2.6.0 - 04 Aug 2025
Version 2.5.0 - 30 Jul 2025
Version 2.4.0 - 23 Jul 2025
Version 2.3.0 - 16 Jul 2025
Version 2.2.0 - 15 Jul 2025
Version 2.1.1 - 10 Jun 2025
Version 2.1.0 - 02 Jun 2025
Version 2.0.0 - 13 May 2025
Version 2.0.0-beta3 - 01 May 2025
Version 2.0.0-beta2 - 23 Apr 2025
Version 2.0.0-beta1 - 22 Apr 2025
Version 1.1.2 - 28 Mar 2025
Version 1.1.1 - 22 Mar 2025
Version 1.1.0 - 11 Feb 2025
Version 1.0.1 - 22 Jan 2025
Version 1.0.0 - 21 Jan 2025
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 net5.0 was computed. net5.0-windows net5.0-windows was computed. net6.0 net6.0 was computed. net6.0-android net6.0-android was computed. net6.0-ios net6.0-ios was computed. net6.0-maccatalyst net6.0-maccatalyst was computed. net6.0-macos net6.0-macos was computed. net6.0-tvos net6.0-tvos was computed. net6.0-windows net6.0-windows was computed. net7.0 net7.0 was computed. net7.0-android net7.0-android was computed. net7.0-ios net7.0-ios was computed. net7.0-maccatalyst net7.0-maccatalyst was computed. net7.0-macos net7.0-macos was computed. net7.0-tvos net7.0-tvos was computed. net7.0-windows net7.0-windows was computed. net8.0 net8.0 is compatible. net8.0-android net8.0-android was computed. net8.0-browser net8.0-browser was computed. net8.0-ios net8.0-ios was computed. net8.0-maccatalyst net8.0-maccatalyst was computed. net8.0-macos net8.0-macos was computed. net8.0-tvos net8.0-tvos was computed. net8.0-windows net8.0-windows was computed. net9.0 net9.0 is compatible. net9.0-android net9.0-android was computed. net9.0-browser net9.0-browser was computed. net9.0-ios net9.0-ios was computed. net9.0-maccatalyst net9.0-maccatalyst was computed. net9.0-macos net9.0-macos was computed. net9.0-tvos net9.0-tvos was computed. net9.0-windows net9.0-windows was computed. net10.0 net10.0 is compatible. net10.0-android net10.0-android was computed. net10.0-browser net10.0-browser was computed. net10.0-ios net10.0-ios was computed. net10.0-maccatalyst net10.0-maccatalyst was computed. net10.0-macos net10.0-macos was computed. net10.0-tvos net10.0-tvos was computed. net10.0-windows net10.0-windows was computed. |
| .NET Core | netcoreapp2.0 netcoreapp2.0 was computed. netcoreapp2.1 netcoreapp2.1 was computed. netcoreapp2.2 netcoreapp2.2 was computed. netcoreapp3.0 netcoreapp3.0 was computed. netcoreapp3.1 netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 netstandard2.0 is compatible. netstandard2.1 netstandard2.1 is compatible. |
| .NET Framework | net461 net461 was computed. net462 net462 was computed. net463 net463 was computed. net47 net47 was computed. net471 net471 was computed. net472 net472 was computed. net48 net48 was computed. net481 net481 was computed. |
| MonoAndroid | monoandroid monoandroid was computed. |
| MonoMac | monomac monomac was computed. |
| MonoTouch | monotouch monotouch was computed. |
| Tizen | tizen40 tizen40 was computed. tizen60 tizen60 was computed. |
| Xamarin.iOS | xamarinios xamarinios was computed. |
| Xamarin.Mac | xamarinmac xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos xamarinwatchos was computed. |
Showing the top 2 NuGet packages that depend on HyperLiquid.Net:
| Package | Downloads |
|---|---|
|
CryptoClients.Net
CryptoClients.Net offers full easy access to 27 different cryptocurrency exchange API's, such as Binance, Bybit, HyperLiquid and many more. It offers a unified way to access the API's and tools to dynamically call endpoints on different exchanges. |
|
|
Le.CryptoClients.Net
CryptoClients.Net is a collection of multiple cryptocurrency exchange API clients for accessing both the REST API's and WebSocket API's. Supports order and account management and requesting and streaming both public and private data. |
Showing the top 1 popular GitHub repositories that depend on HyperLiquid.Net:
| Repository | Stars |
|---|---|
|
JKorf/CryptoExchange.Net
A C# .netstandard base library used for implementing cryptocurrency exchange API's.
|
| Version | Downloads | Last Updated |
|---|---|---|
| 4.8.0 | 182 | 6/8/2026 |
| 4.7.1 | 818 | 6/2/2026 |
| 4.7.0 | 212 | 6/1/2026 |
| 4.6.1 | 696 | 5/29/2026 |
| 4.6.0 | 284 | 5/26/2026 |
| 4.5.1 | 472 | 5/12/2026 |
| 4.5.0 | 487 | 5/1/2026 |
| 4.4.1 | 642 | 4/28/2026 |
| 4.4.0 | 140 | 4/24/2026 |
| 4.3.0 | 870 | 4/9/2026 |
| 4.2.1 | 293 | 4/2/2026 |
| 4.2.0 | 155 | 3/31/2026 |
| 4.1.0 | 151 | 3/26/2026 |
| 4.0.1 | 1,039 | 3/24/2026 |
| 4.0.0 | 127 | 3/24/2026 |
| 3.10.0 | 1,069 | 3/6/2026 |
| 3.9.0 | 702 | 2/24/2026 |
| 3.8.0 | 2,170 | 2/16/2026 |
| 3.7.0 | 444 | 2/10/2026 |
| 3.6.0 | 787 | 2/6/2026 |