Skip to main content

Installation

This guide will help you install the Market Data C#/.NET SDK and configure it for your project.

PackageMarketDataApp on NuGet.org
Target frameworksnet8.0, net10.0
LicenseMIT
SourceMarketDataApp/sdk-csharp

Prerequisites​

  • .NET 8.0 or newer. The package multi-targets net8.0 and net10.0 (both LTS releases), so projects on either runtime get a native build.
  • The .NET SDK command line, or an IDE such as Visual Studio, Rider, or VS Code with the C# Dev Kit.

Basic Installation​

Add the SDK as a NuGet package reference. From your project directory:

dotnet add package MarketDataApp

dotnet add package resolves the newest stable version for you and writes it into your project file.

If you maintain the reference by hand, take the version number from the package's NuGet page or the releases list — versions are derived from git tags, so there is no fixed number to copy from the docs:

<ItemGroup>
  <!-- Replace with the version shown on NuGet or the releases page. -->
  <PackageReference Include="MarketDataApp" Version="1.0.0" />
</ItemGroup>
note

The NuGet package id, the assembly, and the root namespace are all MarketDataApp — you install MarketDataApp and then write using MarketDataApp;. Endpoint-specific types live under MarketDataApp.Stocks, MarketDataApp.Options, MarketDataApp.Funds, MarketDataApp.Markets, and MarketDataApp.Utilities.

Requirements & Dependencies​

The SDK stays on the standard Microsoft stack, with one small helper:

  • No third-party HTTP client. It uses the built-in System.Net.Http.HttpClient, and can either create its own or use one your application manages (including clients from IHttpClientFactory, via Microsoft.Extensions.Http).
  • System.Text.Json for JSON decoding — no Newtonsoft dependency.
  • Microsoft.Extensions.Configuration (with the environment-variables and user-secrets providers), Microsoft.Extensions.Logging, and Microsoft.Extensions.DependencyInjection for configuration binding, structured logging, and the AddMarketDataClient service-collection extension.
  • DotNetEnv to load an optional .env file from the working directory.

Updating the SDK​

To move to the latest stable version:

dotnet add package MarketDataApp

The SDK follows semantic versioning from 1.0.0, so a 1.x update never contains a breaking change. Review the release notes before moving to a new major version.

Next Steps​

After installation, you'll need to:

  1. Set up your authentication token.
  2. Learn about the client and how to make your first API requests.
  3. Configure Settings to customize output format, date format, and other universal parameters.