Click or drag to resize

Getting started

The SampleOEC application shows an example of working with the OpenECryTrader, as shown in the figure below. The example source code is in the Samples/OpenECry folder of the installation package.

OECTrader Main Window
  1. First, you need to create an instance of the OpenECryTrader:

    C#
    Trader = new OpenECryTrader {
        Login = Login.Text, 
        Password = Password.Password,
        OECConnectionAddress = address,
        OECConnectionPort = port,
        EnableOECLogging = true
    };
  2. Next, you should subscribe on required IConnector events:

    C#
    // subscribe on connection successfully event
    Trader.Connected += () =>
    {
        // set flag (connection is established)
        _isConnected = true;
    
        // update gui labes
        this.GuiAsync(() => ChangeConnectStatus(true));
    
        // subscribe on news
        Trader.RegisterNews();
    };
    
    // subscribe on connection error event
    Trader.ConnectionError += error => this.GuiAsync(() =>
    {
        // update gui labes
        ChangeConnectStatus(false);
    
        MessageBox.Show(this, error.ToString(), LocalizedStrings.Str2959);    
    });
    
    Trader.Disconnected += () => this.GuiAsync(() => ChangeConnectStatus(false));
    
    // subscribe on error event
    Trader.Error += error => this.GuiAsync(() => MessageBox.Show(this, error.ToString(), LocalizedStrings.Str2955));
    
    Trader.NewSecurity += security => _securitiesWindow.SecurityPicker.Securities.Add(security);
    Trader.NewMyTrade += trade => _myTradesWindow.TradeGrid.Trades.Add(trade);
    Trader.NewTrade += trade => _tradesWindow.TradeGrid.Trades.Add(trade);
    Trader.NewOrder += order => _ordersWindow.OrderGrid.Orders.Add(order);
    Trader.NewStopOrder += order => _stopOrdersWindow.OrderGrid.Orders.Add(order);
    Trader.NewPortfolio += portfolio =>
    {
        _portfoliosWindow.PortfolioGrid.Portfolios.Add(portfolio);
    
        // subscribe on portfolio updates
        Trader.RegisterPortfolio(portfolio);
    };
    Trader.NewPosition += position => _portfoliosWindow.PortfolioGrid.Positions.Add(position);
    
    // subscribe on error of order registration event
    Trader.OrderRegisterFailed += _ordersWindow.OrderGrid.AddRegistrationFail;
    // subscribe on error of order cancelling event
    Trader.OrderCancelFailed += OrderFailed;
    
    // subscribe on error of stop-order registration event
    Trader.StopOrderRegisterFailed += _stopOrdersWindow.OrderGrid.AddRegistrationFail;
    // subscribe on error of stop-order cancelling event
    Trader.StopOrderCancelFailed += OrderFailed;
    
    Trader.MassOrderCancelFailed += (transId, error) =>
        this.GuiAsync(() => MessageBox.Show(this, error.ToString(), LocalizedStrings.Str716));
    
    Trader.NewNews += news => _newsWindow.NewsPanel.NewsGrid.News.Add(news);
    
    // set market data provider
    _securitiesWindow.SecurityPicker.MarketDataProvider = Trader;
    
    // set news provider
    _newsWindow.NewsPanel.NewsProvider = Trader;
  3. Finally, you need to connect to OEC server:

    C#
    Trader.Connect();

    Once connected, you can expect to trigger events:

  4. Instruments search (in more detail):

    OECTrader Security
    C#
    private void FindClick(object sender, RoutedEventArgs e)
    {
        var wnd = new SecurityLookupWindow { Criteria = new Security { Code = "ES" } };
    
        if (!wnd.ShowModal(this))
            return;
    
        MainWindow.Instance.Trader.LookupSecurities(wnd.Criteria);
    }
  5. For updates on the selected instrument and ticks you need to use the RegisterSecurity(Security) and RegisterTrades(Security) methods, respectively:

    C#
    private void QuotesClick(object sender, RoutedEventArgs e)
    {
        var trader = MainWindow.Instance.Trader;
    
        foreach (var security in SecurityPicker.SelectedSecurities)
        {
            if (trader.RegisteredSecurities.Contains(security))
            {
                trader.UnRegisterSecurity(security);
                trader.UnRegisterTrades(security);
            }
            else
            {
                trader.RegisterSecurity(security);
                trader.RegisterTrades(security);
            }
        }
    }
  6. To request updates on the order books you need to use the RegisterMarketDepth(Security) method:

    C#
    private void DepthClick(object sender, RoutedEventArgs e)
    {
        var trader = MainWindow.Instance.Trader;
    
        foreach (var security in SecurityPicker.SelectedSecurities)
        {
            var window = _quotesWindows.SafeAdd(security, s =>
            {
                // subscribe on order book flow
                trader.RegisterMarketDepth(security);
    
                // create order book window
                var wnd = new QuotesWindow
                {
                    Title = security.Id + " " + LocalizedStrings.MarketDepth
                };
                wnd.MakeHideable();
                return wnd;
            });
    
            if (window.Visibility == Visibility.Visible)
                window.Hide();
            else
                window.Show();
    
            if (!_initialized)
            {
                TraderOnMarketDepthChanged(trader.GetMarketDepth(security));
                trader.MarketDepthChanged += TraderOnMarketDepthChanged;
                _initialized = true;
            }
        }
    }
  7. For portfolios updates the RegisterPortfolio(Portfolio) method is used:

    C#
    Trader.NewPortfolio += portfolio =>
    {
        _portfoliosWindow.PortfolioGrid.Portfolios.Add(portfolio);
    
        // subscribe on portfolio updates
        Trader.RegisterPortfolio(portfolio);
    };
  8. For orders registration the New Order button used. The RegisterOrder(Order) method sends an order to the server:

    C#
    private void NewOrderClick(object sender, RoutedEventArgs e)
    {
        var newOrder = new OrderWindow
        {
            Order = new Order { Security = SecurityPicker.SelectedSecurity },
            SecurityProvider = MainWindow.Instance.Trader,
            MarketDataProvider = MainWindow.Instance.Trader,
            Portfolios = new PortfolioDataSource(MainWindow.Instance.Trader),
        };
    
        if (newOrder.ShowModal(this))
            MainWindow.Instance.Trader.RegisterOrder(newOrder.Order);
    }