DatabentoDotNet.Reference 0.10.0

Prefix Reserved
dotnet add package DatabentoDotNet.Reference --version 0.10.0
                    
NuGet\Install-Package DatabentoDotNet.Reference -Version 0.10.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="DatabentoDotNet.Reference" Version="0.10.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="DatabentoDotNet.Reference" Version="0.10.0" />
                    
Directory.Packages.props
<PackageReference Include="DatabentoDotNet.Reference" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add DatabentoDotNet.Reference --version 0.10.0
                    
#r "nuget: DatabentoDotNet.Reference, 0.10.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package DatabentoDotNet.Reference@0.10.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=DatabentoDotNet.Reference&version=0.10.0
                    
Install as a Cake Addin
#tool nuget:?package=DatabentoDotNet.Reference&version=0.10.0
                    
Install as a Cake Tool

DatabentoDotNet.Reference

Databento reference data for .NET: security master, corporate actions, and adjustment factors. A port of databento-rs's reference client.

0.10.0 is a beta. The code is complete and tested; what is not yet settled is whether the public surface is the right shape. 1.0.0 undertakes not to break it, so the beta is when that undertaking is worth contesting — if something here is awkward to call, an issue now is much cheaper than a major version later.

using DatabentoDotNet;
using DatabentoDotNet.Dbn;
using DatabentoDotNet.Reference;
using NodaTime;

await using var client = new ReferenceClient
{
    ApiKey = new ApiKey(Environment.GetEnvironmentVariable("DATABENTO_API_KEY")!),
};

await foreach (var record in client.SecurityMaster.GetRangeAsync(new SecurityMasterGetRangeParams
{
    Symbols = Symbols.From(["AAPL"]),
    StypeIn = SType.RawSymbol,
    DateTimeRange = ReferenceDateTimeRange.Between(
        Instant.FromUtc(2024, 1, 1, 0, 0, 0), Instant.FromUtc(2024, 2, 1, 0, 0, 0)),
}))
{
    Console.WriteLine($"{record.Symbol} {record.SecurityType}");
}

Entitlement

Reference data is a separate subscription from live and historical access. A key with full historical entitlement is still answered 403 license_reference_dataset_no_subscription on these endpoints — that is an account matter, not a client error, and the client surfaces it as such.

AllocateIsins defaults to true on the endpoints that accept it, and on an ISIN-limited plan that can create new allocations against your quota. Set it deliberately.

Dependencies

NodaTime for ReferenceDateTimeRange, whose Start and End are Instants because a DateTimeOffset cannot round-trip a nanosecond start; Microsoft.Extensions.Logging.Abstractions for the optional LoggerFactory; and DatabentoDotNet.Historical, whose transport these endpoints share — which is how upstream builds it too, the reference API being the historical transport with a different set of slugs.

Documentation

The API reference is the XML documentation shipped inside this package. Guides and troubleshooting are at jerbersoft.github.io/databentodotnet — start with Reference Data.

Source, issues, and roadmap: https://github.com/jerbersoft/databentodotnet.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on DatabentoDotNet.Reference:

Package Downloads
DatabentoDotNet.Extensions.Hosting

Databento for ASP.NET Core and the .NET generic host: IServiceCollection registration for the historical, reference and live clients, IConfiguration binding, and a hosted live-streaming service with bounded reconnection, health checks and metrics.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.10.0 113 9/1/2026
0.9.1 102 8/31/2026
0.9.0 104 8/30/2026
0.1.0-alpha 95 8/29/2026