Learn how to setup your project to use the SDK.

Setup


## Coniugis erat carmen capillis

Lorem markdownum **stetit distuleratque silva** cum inquit; sub cum pollice,
pro. Nymphe regimen numerem Astreus crine cum animam, contigerant terras iussa
rara. Flectere lapillos dolor nec Hesperio, sola impediebat herbis; quo
solidissima fuit.

> Ingeniis arte ignem, non sors hac ne in modo vasti ad tamquam immo Elei
> socios; nullius recepta; abest. Cum hoc aestus nocens? Annum iam, hunc unda
> misit, ignavi aevum. Me maerenti gaudia; de mihi frondes: reprensa posco:
> Achivae. Sed loqui quo umquam in et lassa: per erat.

Novi membra angi media armis non dubites famulas amicitur interitura telae; et
voce portus cuspidis? Tulisset ut haec una amoris mirum! Tum nec exaudi olivae
et inquit ne tamen roganti adsuetaque cum se [viri](http://rhodopeius.com/), ire
imago utrimque ratos bracchia.

## Missa liquidas in tepido ne facit

Mihi illius et illa, terras Cadmus [patres quas](http://erat-ubi.io/fore.html),
alta. Loquiturque verba ossibus; satis spectat **fallis**, terra Attis tempora.
Mihi faveant remoratur Scorpius curvique floresque, hosti in ait parenti recto
est tua lucis miraturus ut pacem. Callida arma vincant legi hoc ullam **postquam
corpore candor**. Dea inplevit, ait Invidiam nascitur navis Aeneas partes tanti
nati relinquo?

```
nui_engine = enterprise;
shift(topology_kibibyte.ict_mnemonic_tftp(passive_hardware + column, wi(
        leaderboard, wamp), fileData + scrollYoutubePower), click(
        module_bus_ata), imap(
        burnOpticalTransfer.characterMemoryMeta.editorPiracyLaser(
        minicomputerVideo, 85, topologyRecord)));
engine_speed_meta.trinitronIsaSlashdot += scalableCycle;
```

Pars dapibus, amplexus urnam: remisit veniente adplicor in inque. **Sceptra** et
**si lacrimasque** admonitu qui hausit longum contigerant neve, ut limina
cedere. Abantiades fictos, amat inque Aglauros at sub age, Prytaninque.

Comaeque dorso; octavo annum moventem sed; lignum regere in summa; vina erat,
contra. Res ignoscas admovet **functi rediturum** ignea idque deferri, ferrumque
et! Frustraque tam modo Macareus terrarumque adhuc, morae haec Acmona, prima
agros iuvenes noctem, umbra, fratrum.


Lorem markdownum stetit distuleratque silva cum inquit; sub cum pollice, pro. Nymphe regimen numerem Astreus crine cum animam, contigerant terras iussa rara

Lorem ipsum dolor sit amet


## Sub ceris patet magna crimen tumulumque ferre

Lorem markdownum Tyrios; illa dulci, superba. Anaphen temporis lassant, sonus
qui eritque nota **lenita**, qui usus imperio cervum! Velo pictis, merito est
dextrasque murra corpora habet deque **cedunt**. Id *currus uberior maduere*
honore distendens fuerat clivum *portas tegitur Cerberei* bis, promissae?

> Quem vidit hoc, illa: deorum nec, quis huius! Armaque natalis mortale;
> Herculeis consuetas praecedentem fuit sum in quaeque?

Deus heros postquam, hoc vestem *est lacubus*, ego pietas vires? Pennis nec
iacuere forte, in aeratas decerpserat iuvenesque exilio suam *spernimus domus*:
boum? Dat qua non et putat; sciat sit fera Alcathoen **longas**.

Sunt tristi imitamina; [graves quoniam](http://vicimus-sed.com/tangit.html)
septenis; senex quantum dederant [deus](http://necmens.org/tamen-cernitis),
prospexit. Ingenti venti optes poscentem tremor oblitus regna fratri et, si vidi
iam quemque maior tempore lacertis. Ferox vestes admonitu et ritus,
[petentia](http://www.inpleverunt.io/maeoniosarmis) fuit perdidimus enixa;
terruit nec.

## Intus referre pone

Concidis genus, si diu totidem Bacchi murmurat. Felix si Aegaeo faciemque unde.
Potuisset flores; tuque dicit adit vertice thalamique, interdum es solio harenas
tendebant, mandere me euntis.

> Pars sunt ruunt, ulla animosque nihil dixerat, attulit prodamne fata inponere
> rerum dolendi collaque tegmine [mihi novas](http://aliud.org/at.html);
> interea? Eadem et illum nives rogant ruricolam Amor *capillis sua* mella; ipso
> consulat [undis](http://iam.io/longi-quoque.html). Inponi contentus has litis
> Mnemonides Stygio [marmoreis](http://www.cerebrum.net/miserarum-statuit)
> spectas Ausoniae ut pietas vel ad sceleratae.

Non verticibusque canis, *vellera* trepidantibus vicina anser inter mihi. Messis
Achilles rursusque Ossaeae. [Protervis cantu
flammiferas](http://in.io/phaethonperque.aspx) pectora toris sororum frontem
demugitaeque deserit. *Sit ad* Odrysius digna manusque fama dixerat, senectus
pollicita.

```
data += dv_smtp_reciprocal;
ripcording_paper_contextual = 25;
surge_native.internal(sip_drag.motion_card_kindle(
        input_streaming_impression, android_language - icann_dynamic),
        lanHertz, wirelessSpeakers(daw, card_hibernate_archive) + w *
        jre_data_rj);
if (trackball(2, gifMediaCodec(fpu), cell_personal_motion +
        server_fpu_cycle)) {
    systemWins = -3;
    jfsThirdWheel = 2;
} else {
    gif += gbpsDnsNetwork;
}
handle_uml_wrap.party_pppoe_proxy(windows, perl, ppiUgcAnd.contextual(
        station_tablet_development(systrayJsp, remote), default_raw_payload,
        cgi_document(dpi_dsl)));
```

Causa aevumque exposcere forte valet loco latitans fides. Per prima *aetheris
hunc*, utrumque edita **rorantesque bimembres**, a sua vel.


Lorem markdownum Tyrios; illa dulci, superba. Anaphen temporis lassant, sonus qui eritque nota lenita, qui usus imperio cervum

Tua magna radice et suis

How to manage connection using our dedicated .NET library or take an advantage of your own solution using FIX protocol messages

Connection


## Install HFTFeed.Client Package

Before installation, make sure you are downloading the latest version of the client. Check the latest release on: https://www.nuget.org/packages/HFTFeed.Client

Install using .NET CLI
> dotnet add package HFTFeed.Client --version 1.0.2

Install using NuGet Package Manager
> NuGet\Install-Package HFTFeed.Client -Version 1.0.2

Manually add to .csproj file
> PackageReference Include="HFTFeed.Client" Version="1.0.2"


## Implementation

After installing the required dependencies, you need to import the HFTFeed.Client namespace and create an instance of HFTFeedClient. This class is responsible for managing the entire connection and real-time data streaming.

### Creating an HFTFeedClient Instance

The HFTFeedClient class provides two constructors, both requiring an email and password for authentication.
The first constructor connects to the **default server**.
The second constructor allows you to specify a **custom server host and port** if needed.

```
public HFTFeedClient(string email, string password)
public HFTFeedClient(string email, string password, string host, int port)
```

```
using HFTFeed.Client;

// Connect to the default server, use this if you want to connect to the default HFTFeed server.
var client = new HFTFeedClient("your_email@example.com", "your_password");

// OR connect to a custom server, use this if you need to specify a custom host and port.
var client = new HFTFeedClient("your_email@example.com", "your_password", "custom.host.com", 1234);

```


### Handling Events

HFTFeedClient provides several events that allow you to react to different actions, such as receiving market data (ticks), FIX messages, or connection status updates.
Events in HFTFeedClient work like "callbacks"—when something important happens (e.g., a new market tick arrives), your code can automatically execute a function in response.
Each event is an Action delegate, which means you can assign a method to it. When the event occurs, your assigned method will be called.

Method 1: Lambda Expression
```
// Handle new market ticks
client.OnNewTick = tick => Console.WriteLine($"New Tick: {tick}");

// Handle FIX messages
client.OnFixMsg = message => Console.WriteLine($"FIX Message: {message}");

// Handle connection status changes
client.OnConnectionStatus = status => Console.WriteLine($"Connection Status: {status}");

// Handle subscription confirmations
client.OnSubscribe = symbol => Console.WriteLine($"Subscribed to: {symbol}");

// Handle unsubscription confirmations
client.OnUnsubscribe = symbol => Console.WriteLine($"Unsubscribed from: {symbol}");
```

Method 2: Named Function
```
void HandleNewTick(Md tick)
{
    Console.WriteLine($"New Tick Received: {tick}");
}

void HandleFixMsg(string fixMsg)
{
    Console.WriteLine($"FIX Message: {fixMsg}");
}

void HandleConnectionStatus(ConnectionStatus status)
{
    Console.WriteLine($"Connection Status: {status}");
}

void HandleSubscribe(string symbol)
{
    Console.WriteLine($"Subscribed: {symbol}");
}

void HandleUnsubscribe(string symbol)
{
    Console.WriteLine($"Unsubscribed: {symbol}");
}

//binding
client.OnNewTick += HandleNewTick;
client.OnFixMsg += HandleFixMsg;
client.OnConnectionStatus += HandleConnectionStatus;
client.OnSubscribe += HandleSubscribe;
client.OnUnsubscribe += HandleUnsubscribe;

//unbinding 

client.OnNewTick -= HandleNewTick;
client.OnFixMsg -= HandleFixMsg;
client.OnConnectionStatus -= HandleConnectionStatus;
client.OnSubscribe -= HandleSubscribe;
client.OnUnsubscribe -= HandleUnsubscribe;

```


### Connecting to the Server

Once you have created an instance of HFTFeedClient and bound your events, you need to start the connection to begin receiving market data.


Call Start() to begin receiving data:
```
client.Start();
```

To disconnect from the server, call Stop():

```
client.Stop();
```

### Fetching symbols

HFTFeedClient provides a method to obtain the symbols, once your client is connected, call GetSymbols() to fetch available symbols.

**Understanding HFTFeedSymbol Fields**

The GetSymbols() method returns an array of HFTFeedSymbol, where each object represents an available market instrument.

```
public class HFTFeedSymbol
{
    public string SymbolKey {get;set;} 
    public string SymbolName {get;set;}
    public double Digits {get;set;}
}
```

**SymbolKey** Internal server ID of the symbol. This is required when subscribing to or managing streaming data.  
**SymbolName** Human-readable name of the instrument, such as EURUSD or NDX.  
**Digits** Number of decimal places used in price quotes. For example, if a price is 1.55455, then Digits = 5.  

```
// Fetch symbols
var symbols = client.GetSymbols();

// Print symbols
foreach (var symbol in symbols)
{
    Console.WriteLine($"SymbolKey: {symbol.SymbolKey}");
    Console.WriteLine($"SymbolName: {symbol.SymbolName}");
    Console.WriteLine($"Digits: {symbol.Digits}");
}
```

Best Practices  
✅ Always use SymbolKey when subscribing to or managing data streams, as this is the server’s internal identifier.  
✅ Use SymbolName for UI display to make it easier for users to recognize instruments.  
✅ Handle different Digits values to ensure correct price formatting when processing market data.  


### Subscribe/Unsubscribe

After connecting your client and setting up the necessary bindings, you can begin retrieving market data. HFTFeedClient provides 4 methods to manage subscriptions efficiently.

```
client.Subscribe("TEST"); //Subscribes to a specific symbol to receive real-time market data.

client.Unsubscribe("TEST"); //Unsubscribes from a specific symbol, stopping data updates.

client.SubscribeAll(); // Subscribes to all available symbols at once.

client.UnsubscribeAll(); // Unsubscribes from all active subscriptions.
```




### Full example

```

using HFTFeed.Client;

// Connect to the default server, use this if you want to connect to the default HFTFeed server.
var client = new HFTFeedClient("your_email@example.com", "your_password");

// Handle new market ticks
client.OnNewTick = tick => Console.WriteLine($"New Tick: {tick}");

// Handle FIX messages
client.OnFixMsg = message => Console.WriteLine($"FIX Message: {message}");

// Handle connection status changes
client.OnConnectionStatus = status => Console.WriteLine($"Connection Status: {status}");

// Handle subscription confirmations
client.OnSubscribe = symbol => Console.WriteLine($"Subscribed to: {symbol}");

// Handle unsubscription confirmations
client.OnUnsubscribe = symbol => Console.WriteLine($"Unsubscribed from: {symbol}");

client.Start();

client.SubscribeAll(); // Subscribes to all available symbols at once.

Console.Readline();

client.UnsubscribeAll(); // Unsubscribes from all active subscriptions.

client.Stop();
```





How to implement our HFTFeed.Client into your project

HFTFeed.Client


## Introduction

HFTFeed Server leverages the FIX (Financial Information eXchange) Protocol to manage sessions, stream market data, and facilitate communication between trading systems. FIX is an industry-standard messaging protocol designed for real-time electronic trading, ensuring fast, secure, and reliable data exchange.


###  How HFTFeed Uses FIX Protocol

HFTFeed Server utilizes FIX Protocol for the following core functionalities:  

**Session Management** – Securely authenticates users and maintains a persistent connection.  
**Real-Time Market Data** – Streams tick-by-tick price updates and order book changes.  
**Subscription Handling** – Allows traders to subscribe/unsubscribe to symbols dynamically.  
**Low-Latency Communication** – Ensures ultra-fast data transmission for high-frequency trading (HFT).  

By using FIX Protocol, HFTFeed Server ensures high reliability, low latency, and seamless integration with trading systems that require precise, time-sensitive market data.

```
1.LOGON MESSAGE

REQUEST
8=FIX.4.4|9=76|35=A|34=1|49=SENDER|50=QUOTE|52=20250318-12:34:56.789|56=TARGET|57=QUOTE|98=0|108=30|141=Y|553=testuser|554=password123|10=XYZ|

RESPONSE
8=FIX.4.4|9=84|35=A|34=1|49=SENDER|50=QUOTE|52=20250319-09:59:32.562|56=TARGET|57=QUOTE|98=0|108=30|10=141|
```
```
2.LOGOUT MESSAGE

REQUEST
8=FIX.4.4|9=39|35=5|34=1|49=SENDER|50=QUOTE|52=20250318-12:34:56.789|56=TARGET|57=QUOTE|10=045|

RESPONSE
8=FIX.4.4|9=97|35=5|34=1|49=SENDER|50=QUOTE|52=20250319-10:04:37.725|56=TARGET|57=QUOTE|58=Session disconnected|10=056|
```
```
3.Heartbeat Message
8=FIX.4.4|9=35|35=0|34=1|49=SENDER|50=QUOTE|52=20250318-12:34:56.789|56=TARGET|57=QUOTE|10=099|
```

```
4.Market Data Subscription (Single Symbol)
8=FIX.4.4|9=75|35=V|34=1|49=SENDER|50=QUOTE|52=20250318-12:34:56.789|56=TARGET|57=QUOTE|262=1234567890123456|263=1|264=1|267=2|269=0|269=1|146=1|55=EURUSD|10=200|
```

```
5.Market Data Unsubscription (Single Symbol)
8=FIX.4.4|9=75|35=V|34=1|49=SENDER|50=QUOTE|52=20250318-12:34:56.789|56=TARGET|57=QUOTE|262=1234567890123456|263=2|264=1|267=2|269=0|269=1|146=1|55=EURUSD|10=201|
```

```
6.Market Data Subscription (Multiple Symbols)
8=FIX.4.4|9=95|35=V|34=1|49=SENDER|50=QUOTE|52=20250318-12:34:56.789|56=TARGET|57=QUOTE|262=1234567890123456|263=1|264=1|267=2|269=0|269=1|146=2|55=EURUSD|55=GBPUSD|10=202|
```

```
7.Market Data Unsubscription (Multiple Symbols)
8=FIX.4.4|9=95|35=V|34=1|49=SENDER|50=QUOTE|52=20250318-12:34:56.789|56=TARGET|57=QUOTE|262=1234567890123456|263=1|264=1|267=2|269=0|269=1|146=2|55=EURUSD|55=GBPUSD|10=202|
```

```
8.Get Symbols Request
8=FIX.4.4|9=45|35=x|34=1|49=SENDER|50=QUOTE|52=20250318-12:34:56.789|56=TARGET|57=QUOTE|320=1234567890123456|559=0|10=150|
```

```
9.Market data
8=FIX.4.4|9=126|35=W|34=1|49=SENDER|50=QUOTE|52=20250319-09:59:40.022|56=TARGET|57=QUOTE|55=3001|268=2|269=0|270=19558.675|269=1|270=19558.925|10=178|
```

Tips  
✅ If you struggling with reading FIX messages, use https://fixparser.targetcompid.com/ which will make it more readable for you  
✅ Always increment Tag 34 (MsgSeqNum) by 1 for each outgoing message! If your sequence numbers get out of sync, the counterparty might reject your messages or request a sequence reset.  
✅ You can subscribe mulitple symbols in one message but HFTFeed server will send one quote per one message  
✅ Heartbeat should be send every 30 seconds  
✅ HFTFeed doesn't provide SSL encryption  







Documentation of FIX Protocol messages which you will need to implement in your custom project to manage session with our servers

Documentation

Explore our guides and examples to start building your app.

Setup

Connection

Setup

Connection