EasyTrading.Core 1.0.2

EasyTrading

A .NET client for decentralised perpetual and spot exchanges. One IExchangeClient interface across every supported DEX; per-DEX clients add only what's venue-specific (e.g. vaults and staking on HyperLiquid).

• Targets: net8.0, net9.0
• Home: easytrading.pw
• API reference: auto-generated from XML doc-comments, deployed at the site above
• Source: github.com/polius2007/EasyTrading

Status

HyperLiquid coverage at 1.0.0:

• All Info (read) and Exchange (write) endpoints, including TWAP, scheduled cancel, sub-accounts, vaults, and staking.
• EIP-712 L1 and user-signed actions; byte-identical msgpack encoding with the Python reference SDK.
• WebSocket: 9 channels, per-subscriber back-pressure, automatic reconnect with exponential backoff.
• Pre-flight order validation (tick / lot / min-notional) — invalid orders are rejected client-side.
• REST retry policy with backoff + jitter, honours Retry-After on 429.
• WebSocket gap recovery: on reconnect, user streams (MyFills / MyOrders / MyFundings) auto-fetch missed events via REST and deduplicate against the live feed.
• 89 unit tests + 5 read-only integration tests against live mainnet, all green.

Install

dotnet add package EasyTrading.HyperLiquid

This pulls EasyTrading.Abstractions and EasyTrading.Core transitively.

Quick start

using EasyTrading.Abstractions;
using EasyTrading.HyperLiquid;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

var host = Host.CreateApplicationBuilder(args);

host.Services
    .AddEasyTrading()
    .AddHyperLiquid(options =>
    {
        options.Network = HyperLiquidNetwork.Mainnet;
        options.Credentials = new HyperLiquidCredentials(
            masterAddress: "0xYourMasterAddress",
            privateKey:    Environment.GetEnvironmentVariable("HL_PRIVATE_KEY")!,
            agentName:     "easy-bot");
    });

using var app = host.Build();
var ex = app.Services.GetRequiredService<IHyperLiquidExchange>();

// Read (no signing needed)
var mids = await ex.Markets.GetAllMidsAsync();
var book = await ex.Markets.GetOrderBookAsync("BTC", depth: 20);

// Write (signed)
var placed = await ex.Orders.PlaceLimitAsync(
    symbol: "BTC", side: OrderSide.Buy,
    price:  60_000m, size: 0.01m,
    tif:    TimeInForce.Alo);

// Stream
await foreach (var trade in ex.Streams.TradesAsync("BTC", default))
    Console.WriteLine($"{trade.Trade.Price} {trade.Trade.Size}");

A more complete walk-through with credential setup, agent wallets, and testnet-first guidance lives in docs/getting-started.md. Common patterns are collected in docs/recipes.md.

API surface

Methods are grouped by entity. Everything about orders is on Orders; everything about positions is on Positions; and so on.

Design notes

• decimal everywhere for money — never double / float.
• DTOs are immutable record types.
• Async methods end with Async; CancellationToken ct = default is the last parameter on every method.
• WebSocket subscriptions are IAsyncEnumerable<T> — iterate with await foreach and cancel by cancelling the token.
• Optional venue features are gated by client.Capabilities.HasFlag(ExchangeCapabilities.X).
• Typed exceptions only: RateLimitException, InsufficientFundsException, InvalidOrderException, AuthenticationException, SigningException, ExchangeApiException.

Roadmap

• HyperLiquid — REST + WebSocket + EIP-712 signing + hardening → 1.0.0
• Aster — EasyTrading.Aster (in progress: scaffold + Markets reads landed in 1.1.0-alpha.1; signed reads, writes via EIP-712, and WebSocket pending)
• dYdX v4 — EasyTrading.Dydx (STARK signatures)

Documentation

For AI coding assistants

The repo ships first-class instructions so IDE assistants generate correct code without prompting:

These files travel with the source; any fork or clone inherits the same guidance.

Disclaimer

This software is provided "as is", without warranty of any kind. Trading derivatives carries significant financial risk; use at your own responsibility. The authors are not affiliated with HyperLiquid, Aster, dYdX, or any other exchange.

The HyperLiquid client attaches a 0.5 bps (0.005%) builder fee to every order by default — this funds continued development. The fee is well below typical taker rates and visible on-chain as a separate field on each order action. The library calls approveBuilderFee once per account on the first order; nothing else is required from the consumer. To route fees to your own address set HyperLiquidClientOptions.BuilderFee; to opt out entirely, set its FeeRate to 0m.

License

MIT © 2026 EasyTrading.pw