This package provides access to dxFeed market data. The library is built as a language-specific wrapper over the dxFeed Graal Native library, which was compiled with GraalVM Native Image and dxFeed Java API (our flagman API).

:information_source: If you already use dxFeed .NET API, please see the Overview section.

Table of Contents

• Overview
  • Reasons for the New .NET API Repository
  • Benefits of the New Version
  • Milestones
  • Migration
  • Implementation Details
  • Architectural Restrictions and Other Limitations in the Old Version
• Documentation
• Requirements
• Installation
• Usage
  • How to connect to QD endpoint
  • How to connect to dxLink
• Tools
• Samples
• Current State
• Dependencies
• 3rd Party Licenses

Overview

Reasons for the New .NET API Repository

The old version of dxFeed .NET API is built as a thin wrapper over dxFeed C API, which has several architectural restrictions that prevent us from providing a state-of-the-art technological solution.

Benefits of the New Version

• :rocket: Increased performance
• :milky_way: Wider functionality
• :gemini: Identical programming interfaces to our best API
• :thumbsup: Higher quality of support and service

Milestones

Feature development has already stopped for the old version of dxFeed .NET API.

The old version will be considered deprecated, and at the end of 2024, we plan to end the service. If you’re already our customer and have difficulty with a future transition, please contact us via our customer portal.

Migration

To help you rewrite the existing API calls, we’ve prepared samples demonstrating how to work with the new API and how several functionalities are implemented. More examples will follow. The table below shows the sample mapping between the old and new versions.

Our support team on our customer portal is ready to answer any questions and help with the transition.

Sample Mapping

Implementation Details

We use GraalVM Native Image technology and specially written code that wraps Java methods into native ones to get dynamically linked libraries for different platforms (Linux, macOS, and Windows) based on the latest Java API package.

Then, the resulting dynamic link library (dxFeed Graal-native) is used through C ABI (application binary interface), and we write programming interfaces that describe our business model (similar to Java API).

As a result, we get a full-featured, similar performance as with Java API. Regardless of the language, writing the final application logic using API calls will be very similar (only the syntax will be amended, "best practices", specific language restrictions).

Below is a scheme of this process:

Architectural Restrictions and Other Limitations of the Old Version

Documentation

Find useful information in our self-service dxFeed Knowledge Base or .NET API documentation:

• dxFeed Graal .NET API documentation
• dxFeed Knowledge Base
  • Getting Started
  • Troubleshooting
  • Market Events
  • Event Delivery contracts
  • dxFeed API Event classes
  • Exchange Codes
  • Order Sources
  • Order Book reconstruction
  • Symbology Guide

Requirements

Windows

Only x64 versions are supported.

Requirements

• .NET compatible with .NET Standard 2.0 (not required for self-contained assemblies)
• Visual C++ Redistributable for Visual Studio 2015

Linux

Only x64 versions are supported.

Requirements

• .NET compatible with .NET Standard 2.0 (not required for self-contained assemblies)

Libc compatibility

• musl: gcompat (glibc compatibility layer) for musl is required. Installation on alpine linux apk update && apk add gcompat libstdc++

Libpthread compatibility

A symlink on libpthread.so, libpthread.so.0, or libcoreclr.so must exist.

macOS

Is supported in the Rosetta 2 x64 emulator.

Requirements

• .NET compatible with .NET Standard 2.0 (not required for self-contained assemblies)

Installation

Add the following package source to your NuGet.Config file.

For Linux and macOS:

The NuGet.Config file is usually located at ~/.config/NuGet/NuGet.Config.

For Windows:

The NuGet.Config file is usually located at %appdata%\NuGet\NuGet.Config.

An example of what this file might look like:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <packageSources>
        <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3"/>
        <add key="dxFeed" value="https://dxfeed.jfrog.io/artifactory/api/nuget/v3/nuget-open" protocolVersion="3"/>
    </packageSources>
</configuration>

Then add the DxFeed.Graal.Net package to your project using the NuGet package manager.

Using Visual Studio:

1. Open your solution in Visual Studio.
2. Right-click on the project in Solution Explorer and select Manage NuGet Packages.
3. Switch to the Browse tab, select the dxFeed source, and search for DxFeed.Graal.Net.
4. Click Install to add the package to your project.

Using JetBrains Rider:

1. Open your solution in JetBrains Rider.
2. Right-click on the project in the Solution and select Manage NuGet Packages.
3. Switch to the Packages tab, select the dxFeed source, and search for DxFeed.Graal.Net.
4. Right-click on the package and select Install to add the package to your project.

If you are using .NET Framework and building for platform target AnyCPU, be sure to uncheck Prefer 32-bit in Properties->Buildfor the project. We only support 64-bit builds.

Using VSCode:

1. Create a new project: dotnet new console --framework net6.0 --use-program-main
2. Add the DxFeed.Graal.Net package to your project: dotnet add package DxFeed.Graal.Net
3. Copy and paste the following code into the Program.cs file:

using DxFeed.Graal.Net.Api;
using DxFeed.Graal.Net.Events.Market;

namespace sandbox;

internal abstract class Program
{
    public static async Task Main(string[] args)
    {
        var address = "demo.dxfeed.com:7300";
        var symbol = "AAPL";
        var sub = DXEndpoint.GetInstance().Connect(address).GetFeed().CreateSubscription(typeof(Quote));
        sub.AddEventListener(events =>
        {
            foreach (var quote in events)
            {
                Console.WriteLine(quote);
            }
        });
        sub.AddSymbols(symbol);
        await Task.Delay(Timeout.Infinite);
    }
}

4. Run project: dotnet run
5. Add C# support to VSCode by following the instructions here
6. You can now open this directory in VSCode

Usage

How to connect to QD endpoint

using System;
using DxFeed.Graal.Net.Api;
using DxFeed.Graal.Net.Events.Market;

// For token-based authorization, use the following address format:
// "demo.dxfeed.com:7300[login=entitle:token]"
using var endpoint = DXEndpoint.Create().Connect("demo.dxfeed.com:7300");
using var subscription = endpoint.GetFeed().CreateSubscription(typeof(Quote));
subscription.AddEventListener(events =>
{
    foreach (var e in events)
    {
        Console.WriteLine(e);
    }
});
subscription.AddSymbols("AAPL");
Console.ReadKey();

How to connect to dxLink

using System;
using DxFeed.Graal.Net;
using DxFeed.Graal.Net.Api;
using DxFeed.Graal.Net.Events.Market;

// Enable experimental feature.
SystemProperty.SetProperty("dxfeed.experimental.dxlink.enable", "true");
// Set scheme for dxLink.
SystemProperty.SetProperty("scheme", "ext:opt:sysprops,resource:dxlink.xml");

// For token-based authorization, use the following address format:
// "dxlink:wss://demo.dxfeed.com/dxlink-ws[login=dxlink:token]"
using var endpoint = DXEndpoint.Create().Connect("dxlink:wss://demo.dxfeed.com/dxlink-ws");
using var subscription = endpoint.GetFeed().CreateSubscription(typeof(Quote));
subscription.AddEventListener(events =>
{
    foreach (var e in events)
    {
        Console.WriteLine(e);
    }
});
subscription.AddSymbols("AAPL");
Console.ReadKey();

To familiarize with the dxLink protocol, please click here.

Tools

Tools is a collection of utilities that allow you to subscribe to various market events for the specified symbols. The tools can be downloaded from Release (including self-contained versions, that do not require .NET installation):

• Connect connects to the specified address(es) and subscribes to the specified events with the specified symbol
• Dump dumps all events received from address. This was designed to retrieve data from a file
• PerfTest connects to the specified address(es) and calculates performance counters (events per second, memory usage, CPU usage, etc.)
• LatencyTest connects to the specified address(es) and calculates latency
• Qds collection of tools ported from the Java qds-tools

To run tools on macOS, it may be necessary to unquarantine them:

sudo /usr/bin/xattr -r -d com.apple.quarantine <directory_with_tools>

Samples

API

• [x] AuthSample demonstrates how to connect to an endpoint that requires an authentication token, subscribe to market data events, and handle periodic token updates
• [x] ConnectSample demonstrates how to connect to the endpoint and subscribe to various market events
• [x] PrintQuoteEventsSample demonstrates how to subscribe to the Quote event, using a DxFeed instance singleton and dxfeed.system.properties file
• [x] QuoteAndTradeSample demonstrates how to create multiple event listeners and subscribe to Quote and Trade events
• [x] ReconnectSample demonstrates how to connect to an endpoint, subscribe to market data events, handle reconnections and re-subscribing

Candle

• [x] CandleSample demonstrates how to subscribe to Candle events
• [x] CandleDataSample demonstrates how to parse response from CandleData service
• [x] FetchDailyCandlesSample demonstrates how to fetch last N-days of candles for a specified symbol

Console

• [x] LastEventConsoleSample demonstrates how to subscribe to various market events with the dxFeed API, cache them in memory, and take snapshots of these events based on user input

File

• [x] ConvertTapeFileSample demonstrates how to convert one tape file to another tape file with optional intermediate processing or filtering
• [x] FileParserSample demonstrates how to read events from a tape file
• [x] WriteTapeFileSample demonstrates how to write events to a tape file

IPF

• [x] IpfSample demonstrates how to get Instrument Profiles
• [x] IpfLiveSample demonstrates how to get live updates for Instrument Profiles
• [x] OptionChainSample demonstrates how to build option chains, and prints quotes for nearby option strikes

Model

• [x] IncOrderSnapshotSample demonstrates how to subscribe to the Order event and handle snapshots and updates
• [x] MultipleMarketDepthSample demonstrates how to use the MarketDepthModel to manage and display order books for multiple symbols

Schedule

• [x] ScheduleSample demonstrates how to get various scheduling information for instruments

UI

• [x] MarketDepthModelSample demonstrates how to draw a Market Depth using Avalonia UI
• [x] CandleChartSample demonstrates how to draw a Candlestick Chart using Avalonia UI
• [x] PriceLevelBookSample demonstrates how to compile a price level book (market by price) that aggregates individual orders (market by order)

Current State

Endpoint Roles

• [x] FEED connects to the remote data feed provider and is optimized for real-time or delayed data processing, this is a default role

• [x] STREAM_FEED is similar to Feed and also connects to the remote data feed provider but is designed for bulk data parsing from files (DxFeedFileParser)

• [x] PUBLISHER connects to the remote publisher hub (also known as multiplexor) or creates a publisher on the local host (WriteTapeFile)

• [x] STREAM_PUBLISHER is similar to Publisher and also connects to the remote publisher hub, but is designed for bulk data publishing (ConvertTapeFile)

• [x] LOCAL_HUB is a local hub without the ability to establish network connections. Events published via Publisher are delivered to local Feed only

Event Types

• [x] Order is a snapshot of the full available market depth for a symbol

• [x] SpreadOrder is a snapshot of the full available market depth for all spreads

• [x] AnalyticOrder is an Order extension that introduces analytic information, such as adding iceberg-related information to a given order

• [x] Trade is a snapshot of the price and size of the last trade during regular trading hours and an overall day volume and day turnover

• [x] TradeETH is a snapshot of the price and size of the last trade during extended trading hours and the extended trading hours day volume and day turnover

• [x] Candle event with open, high, low, and close prices and other information for a specific period

• [x] Quote is a snapshot of the best bid and ask prices and other fields that change with each quote

• [x] Profile is a snapshot that contains the security instrument description

• [x] Summary is a snapshot of the trading session, including session highs, lows, etc.

• [x] TimeAndSale represents a trade or other market event with price, such as the open/close price of a market, etc.

• [x] Greeks is a snapshot of the option price, Black-Scholes volatility, and greeks

• [x] Series is a snapshot of computed values available for all options series for a given underlying symbol based on options market prices

• [x] TheoPrice is a snapshot of the theoretical option price computation that is periodically performed by dxPrice model-free computation

• [x] Underlying is a snapshot of computed values available for an option underlying symbol based on the market’s option prices

• [x] OptionSale represents a trade or another market event with the price (for example, market open/close price, etc.) for each option symbol listed under the specified Underlying

• [ ] OtcMarketsOrder represents an extension of Order for the symbols traded on the OTC Markets

Subscription Symbols

• [x] String is a string representation of the symbol

• [x] TimeSeriesSubscriptionSymbol represents subscription to time-series events

• [x] IndexedEventSubscriptionSymbol represents subscription to a specific source of indexed events

• [x] WildcardSymbol.ALL represents a wildcard subscription to all events of the specific event type

• [x] CandleSymbol is a symbol used with DXFeedSubscription class to subscribe for Candle events

Subscriptions & Models

• [x] DXFeedSubscription is a subscription for a set of symbols and event types

• [x] GetLastEvent returns the last event for the specified event instance

• [x] GetTimeSeriesPromise requests time series events for the specified event type, symbol, and time range

IPF & Schedule

• [x] InstrumentProfile represents basic profile information about a market instrument

• [x] InstrumentProfileReader reads instrument profiles from the stream using Instrument Profile Format (IPF)

• [x] InstrumentProfileCollector collects instrument profile updates and provides the live instrument profiles list

• [x] InstrumentProfileConnection connects to an instrument profile URL and reads instrument profiles with support of streaming live updates

• [x] Schedule provides an API to retrieving and exploring the trading schedules of various exchanges and different financial instrument classes