EODHD.CSharpApiClient 1.0.1

EODHD.CSharpApiClient

Pure-managed C# client for the EOD Historical Data (EODHD) API — full REST coverage plus live (WebSocket) streaming.

• Async-first — every endpoint is Task-returning with an optional CancellationToken; synchronous convenience wrappers are provided alongside.
• Zero runtime dependencies — uses System.Text.Json (inbox on .NET 8+). No Newtonsoft.Json.
• Testable transport — IHttpTransport / IWebSocketConnection seams let you mock the network in unit tests; the API key is supplied at construction, never read from the environment.
• Debuggable — deterministic build with a symbol package (.snupkg) and Source Link, so you can step straight into the client source.

Install

dotnet add package EODHD.CSharpApiClient

Quick start (REST)

using EODHD.CSharpApiClient;
using EODHD.CSharpApiClient.DataModel;

using EodhdClient client = new EodhdClient("YOUR_API_TOKEN");

UserInfo user = await client.GetUserInfoAsync();
Console.WriteLine($"{user.Name}: {user.ApiRequests}/{user.DailyRateLimit} requests today");

List<HistoricalStockPrice> bars = await client.GetEndOfDayHistoricalStockPricesAsync(
    "AAPL.US", new DateTime(2024, 1, 1), new DateTime(2024, 3, 31), EndOfDayPeriod.Daily);

A demo token (demo) works against a handful of US symbols (e.g. AAPL.US, MCD.US) for trying the client without a paid key.

Live streaming (WebSocket)

Messages are delivered as an IAsyncEnumerable<T>; the connection auto-reconnects and replays subscriptions.

using EODHD.CSharpApiClient.Live;
using EODHD.CSharpApiClient.DataModel.Live;

using EodhdWebSocketClient<ForexQuote> live = EodhdWebSocketClient.Forex("YOUR_API_TOKEN");

await foreach (ForexQuote quote in live.ReadMessagesAsync(new[] { "EURUSD", "GBPUSD" }, cancellationToken))
{
    Console.WriteLine($"{quote.Symbol}: {quote.Bid} / {quote.Ask} @ {quote.TimestampUtc:O}");
}

Factories: EodhdWebSocketClient.Forex, .Crypto, .UsTrades, .UsQuotes (≤ 50 symbols each).

Coverage

Endpoints that require a specific EODHD subscription or marketplace add-on surface a typed EodhdHttpException (PaymentRequired / Forbidden) when your plan doesn't include them.

Unix-epoch timestamp fields carry their unit (…Ms / …Sec) and expose a …Utc companion (DateTimeOffset?) so you get a correct instant without unit guesswork.

API key

Pass your token to the constructor — the client never reads it from the environment or a config file:

EodhdClient client = new EodhdClient("YOUR_API_TOKEN");

For finer control (timeout, user agent, base URI, client-side rate limiting) use EodhdClientOptions:

EodhdClient client = new EodhdClient(new EodhdClientOptions
{
    ApiToken = "YOUR_API_TOKEN",
    Timeout = TimeSpan.FromSeconds(60),
    MaxRequestsPerMinute = 1000,
});

Error handling

Non-success responses throw EodhdHttpException, which carries the HTTP StatusCode, the raw ResponseBody, and a strongly-typed Code (EodhdErrorCase) so you can branch without substring-matching:

try
{
    await client.GetUserInfoAsync();
}
catch (EodhdHttpException ex) when (ex.Code == EodhdErrorCase.Unauthorized)
{
    // invalid or expired API token
}

License

MIT. This is an independent, community-maintained client and is not affiliated with or endorsed by EOD Historical Data.