/TTWebClient-CSharp

C# Web API client for TickTrader

Primary LanguageC#MIT LicenseMIT

TTWebClient-CSharp

C# Web API client for TickTrader

TickTrader Web API interactive documentation

https://ttdemowebapi.soft-fx.com:8443/api/doc/index

Creating Web API client

string webApiAddress = "https://ttdemowebapi.soft-fx.com:8443";
string webApiId = "1de621ca-e686-4ee2-92a5-45c87b4b3fe5";
string webApiKey = "czNhCcnK6ydePCHZ";
string webApiSecret = "J6Jxc2xPr8JyNpWtyEaCPYpkpJpsSQ38xb9AZNxBAGdtQrNDhQwf9mkWQygCKd6K";

// Optional: Force to ignore server certificate
TickTraderWebClient.IgnoreServerCertificate();

// Create instance of the TickTrader Web API client
var client = new TickTraderWebClient(webApiAddress, webApiId, webApiKey, webApiSecret);

Access to public trade session information

// Public trade session
TTTradeSession publictradesession = client.GetPublicTradeSession();
Console.WriteLine("TickTrader name: {0}", publictradesession.PlatformName);
Console.WriteLine("TickTrader company: {0}", publictradesession.PlatformCompany);
Console.WriteLine("TickTrader address: {0}", publictradesession.PlatformAddress);
Console.WriteLine("TickTrader timezone offset: {0}", publictradesession.PlatformTimezoneOffset);
Console.WriteLine("TickTrader session status: {0}", publictradesession.SessionStatus);

Access to public currencies information

// Public currency
List<TTCurrency> publicCurrencies = client.GetPublicAllCurrencies();
foreach (var c in publicCurrencies)
    Console.WriteLine("Currency: " + c.Name);

TTCurrency publicCurrency = client.GetPublicCurrency(publicCurrencies[0].Name).FirstOrDefault();
Console.WriteLine("{0} currency precision: {1}", publicCurrency.Name, publicCurrency.Precision);

Access to public symbols information

// Public symbols
List<TTSymbol> publicSymbols = client.GetPublicAllSymbols();
foreach (var s in publicSymbols)
    Console.WriteLine("Symbol: " + s.Symbol);

TTSymbol publicSymbol = client.GetPublicSymbol(publicSymbols[0].Symbol).FirstOrDefault();
Console.WriteLine("{0} symbol precision: {1}", publicSymbol.Symbol, publicSymbol.Precision);

Access to public feed ticks information

// Public feed ticks
List<TTFeedTick> publicTicks = client.GetPublicAllTicks();
foreach (var t in publicTicks)
    Console.WriteLine("{0} tick: {1}, {2}", t.Symbol, t.BestBid.Price, t.BestAsk.Price);

TTFeedTick publicTick = client.GetPublicTick(publicTicks[0].Symbol).FirstOrDefault();
Console.WriteLine("{0} tick timestamp: {1}", publicTick.Symbol, publicTick.Timestamp);

Access to public feed ticks level2 information

// Public feed ticks level2
List<TTFeedTickLevel2> publicTicksLevel2 = client.GetPublicAllTicksLevel2();
foreach (var t in publicTicksLevel2)
    Console.WriteLine("{0} level2 book depth: {1}", t.Symbol, Math.Max(t.Bids.Count, t.Asks.Count));

TTFeedTickLevel2 publicTickLevel2 = client.GetPublicTickLevel2(publicTicksLevel2[0].Symbol).FirstOrDefault();
Console.WriteLine("{0} level2 book depth: {1}", publicTickLevel2.Symbol, Math.Max(publicTickLevel2.Bids.Count, publicTickLevel2.Asks.Count));

Access to account information

// Account info
TTAccount account = client.GetAccount();
Console.WriteLine("Account Id: {0}", account.Id);
Console.WriteLine("Account name: {0}", account.Name);
Console.WriteLine("Account group: {0}", account.Group);

Access to account trade session information

// Trade session
TTTradeSession tradesession = client.GetTradeSession();
Console.WriteLine("Trade session status: {0}", tradesession.SessionStatus);

Access to account currencies information

// Currencies
List<TTCurrency> currencies = client.GetAllCurrencies();
foreach (var c in currencies)
    Console.WriteLine("Currency: " + c.Name);

TTCurrency currency = client.GetCurrency(currencies[0].Name);
Console.WriteLine("{0} currency precision: {1}", currency.Name, currency.Precision);

Access to account symbols information

// Symbols
List<TTSymbol> symbols = client.GetAllSymbols();
foreach (var s in symbols)
    Console.WriteLine("Symbol: " + s.Symbol);

TTSymbol symbol = client.GetSymbol(symbols[0].Symbol);
Console.WriteLine("{0} symbol precision: {1}", symbol.Symbol, symbol.Precision);

Access to account feed ticks information

// Feed ticks
List<TTFeedTick> ticks = client.GetAllTicks();
foreach (var t in ticks)
    Console.WriteLine("{0} tick: {1}, {2}", t.Symbol, t.BestBid.Price, t.BestAsk.Price);

TTFeedTick tick = client.GetTick(ticks[0].Symbol);
Console.WriteLine("{0} tick timestamp: {1}", tick.Symbol, tick.Timestamp);

Access to account feed ticks level2 information

// Feed ticks level2
List<TTFeedTickLevel2> ticksLevel2 = client.GetAllTicksLevel2();
foreach (var t in ticksLevel2)
    Console.WriteLine("{0} level2 book depth: {1}", t.Symbol, Math.Max(t.Bids.Count, t.Asks.Count));

TTFeedTickLevel2 tickLevel2 = client.GetTickLevel2(ticksLevel2[0].Symbol);
Console.WriteLine("{0} level2 book depth: {1}", tickLevel2.Symbol, Math.Max(tickLevel2.Bids.Count, tickLevel2.Asks.Count));

Access to account assets information

Works only for cash accounts!

// Account assets
if (account.AccountingType == TTAccountingTypes.Cash)
{
    List<TTAsset> assets = client.GetAllAssets();
    foreach (var a in assets)
        Console.WriteLine("{0} asset: {1}", a.Currency, a.Amount);                
}

Access to account positions information

Works only for net accounts!

// Account positions
if (account.AccountingType == TTAccountingTypes.Net)
{
    List<TTPosition> positions = client.GetAllPositions();
    foreach (var p in positions)
        Console.WriteLine("{0} position: {1} {2}", p.Symbol, p.LongAmount, p.ShortAmount);
}

Access to account trades

// Account trades
List<TTTrade> trades = client.GetAllTrades();
foreach (var t in trades)
    Console.WriteLine("{0} trade with type {1} by symbol {2}: {3}", t.Id, t.Type, t.Symbol, t.Amount);
    
// Account trade by Id
TTTrade trade = client.GetTrade(trades[0].Id);
Console.WriteLine("{0} trade with type {1} by symbol {2}: {3}", t.Id, t.Type, t.Symbol, t.Amount);

Access to account trade history

int iterations = 3;
var request = new TTTradeHistoryRequest { TimestampTo = DateTime.UtcNow, RequestDirection = TTStreamingDirections.Backward, RequestPageSize = 10 };

// Try to get trade history from now to the past. Request is limited to 30 records!
while (iterations-- > 0)
{
    TTTradeHistoryReport report = client.GetTradeHistory(request);
    foreach (var record in report.Records)
    {
        Console.WriteLine("TradeHistory record: Id={0}, TransactionType={1}, TransactionReason={2}, Symbol={3}, TradeId={4}", record.Id, record.TransactionType, record.TransactionReason, record.Symbol, record.TradeId);
        request.RequestLastId = record.Id;
    }
    
    // Stop for last report
    if (report.IsLastReport)
        break;
}

Create, modify and cancel limit order

// Create, modify and cancel limit order
if ((account.AccountingType == TTAccountingTypes.Gross) || (account.AccountingType == TTAccountingTypes.Net))
{
    // Create limit order
    var limit = client.CreateTrade(new TTTradeCreate
    {
        Type = TTOrderTypes.Limit, 
        Side = TTOrderSides.Buy,
        Symbol = (account.AccountingType == TTAccountingTypes.Gross) ? "EURUSD" : "EUR/USD", 
        Amount = 10000, 
        Price = 1.0M,
        Comment = "Buy limit from Web API sample"
    });

    // Modify limit order
    limit = client.ModifyTrade(new TTTradeModify
    {
        Id = limit.Id,
        Comment = "Modified limit from Web API sample"
    });

    // Cancel limit order
    client.CancelTrade(limit.Id);
}