Forex.com API REST & Lightstreamer

The next sgcWebSockets release — version 2026.5.0 — adds native support for the Forex.com / StoneX / CityIndex Trading API: REST order management plus real-time Lightstreamer streaming, all delivered through a single Delphi component you can drop onto a form.

Three new components cover the whole surface: TsgcHTTP_API_Forex for REST trading, TsgcWSPClient_Lightstreamer for the native Lightstreamer TLCP 2.5 streaming channel, and TsgcWSAPI_Forex as the unified facade that wires them together and publishes typed OnForex* events for prices, orders, positions, quotes and account margin.

What is Included

Every endpoint and streaming adapter the live Forex.com server serves today is supported out of the box.

Under the Hood

The streaming half of this integration is the most interesting piece. Forex.com delivers real-time data over Lightstreamer — a proprietary streaming protocol used by a number of brokers and financial data vendors. Until now there has been no native TLCP client for Delphi; existing integrations with Lightstreamer-powered venues all wrap the Lightstreamer JavaScript or Java SDK through browser embeds or external processes.

TsgcWSPClient_Lightstreamer is a from-scratch native implementation of the Lightstreamer TLCP 2.5 protocol: create_session, bind_session, control (subscribe / unsubscribe), the LOOP auto-rebind handler and subscription replay after reconnect — advertised on the wire through the Sec-WebSocket-Protocol: TLCP-2.5.0.lightstreamer.com subprotocol header. This makes sgcWebSockets the first Delphi component library with native TLCP support, and the client is deliberately generic: it ships as its own reusable component, not welded to Forex.com, so the same code path drives any Lightstreamer-based broker (IG Markets, for example) or data vendor.

Code Sample

Drop the facade on a form, set credentials, wire the price tick event, call Connect and WatchMarket. The snippet below is a complete, working example.

var
  Forex: TsgcWSAPI_Forex;
begin
  Forex := TsgcWSAPI_Forex.Create(nil);
  Try
    Forex.Credentials.UserName := 'YOUR_USER';
    Forex.Credentials.Password := 'YOUR_PASSWORD';
    Forex.Credentials.AppKey   := 'YOUR_APPKEY';

    Forex.OnForexPriceTick := OnPriceTick;

    Forex.Connect;                // REST LogOn + Lightstreamer
    Forex.WatchMarket(401484830);    // EUR/USD
    Forex.WatchAccount;           // ORDERS + margin

    // ... run app, receive ticks and order updates ...
  Finally
    Forex.Free;
  End;
end;

procedure TForm1.OnPriceTick(Sender: TObject;
  const aTick: TsgcForexPriceTick);
begin
  Memo1.Lines.Add(Format('%d  bid=%.5f  offer=%.5f  audit=%s',
    [aTick.MarketId, aTick.Bid, aTick.Offer, aTick.AuditId]));
end;

Demo

A full VCL demo lives in Demos\05.Crypto\22.Forex. It is split across three tabs:

• Login — UserName / Password / AppKey fields, Connect / Disconnect / Ping, AutoReconnect toggle, live session / account ids and a running event log. Credentials are persisted to sgcForexDemo.ini so you only type them once.
• REST Trading — market search (FullSearchWithTags), NewTradeOrder / UpdateTradeOrder / NewStopLimitOrder / UpdateStopLimitOrder / CancelOrder, SimulateTrade, GetOrder, ListOpenPositions, ListActiveStopLimitOrders, ListTradeHistory and ListStopLimitOrderHistory.
• Streaming — WatchMarket / UnwatchMarket, live price grid, positions and orders list-views updated in real time from the STREAMINGALL adapter set, and a live account-margin panel (Cash / Margin / NetEquity / TradeableFunds / Currency).

Availability

Available in the next sgcWebSockets release — version 2026.5.0. Existing Enterprise and All-Access license holders receive it as part of their subscription; Professional licenses receive it with their renewal.

Signup for a free Forex.com demo account (including UserName / Password / AppKey) at www.forex.com, with the full API reference at docs.labs.gaincapital.com.

Links

• Component documentation: esegece.com/help/sgcwebsockets/
• Demo folder: Demos\05.Crypto\22.Forex
• Forex.com signup: www.forex.com
• API reference: docs.labs.gaincapital.com
• Lightstreamer TLCP 2.5 specification: TLCP 2.5 PDF
• sgcWebSockets product page: esegece.com