XTB WebSocket API

通过 WebSocket 连接到 XTB xStation 5,获取外汇/CFD 价格、K 线流、余额和交易更新——使用类型化 Delphi 组件。

TsgcWSAPI_XTB

XTB xStation 5 WebSocket 客户端——登录/注销、GetTickPrices、GetCandles,以及 getBalance / getKeepAlive / getTradeStatus 的流式端。

组件类

TsgcWSAPI_XTB

支持平台

Windows, macOS, Linux, iOS, Android

版本

Standard / Professional / Enterprise

放置组件,设置密钥,订阅

将组件与目标为 xStation 的 TsgcWebSocketClient 配对,登录,然后调用 GetTickPrices / GetCandles 或订阅流式端点。

uses
  sgcWebSocket, sgcWebSocket_API_XTB;

var
  WSClient: TsgcWebSocketClient;
  XTB: TsgcWSAPI_XTB;
begin
  WSClient := TsgcWebSocketClient.Create(nil);

  XTB := TsgcWSAPI_XTB.Create(nil);
  XTB.Client := WSClient;

  WSClient.Active := True;

  XTB.Login('user-id', 'password');
  XTB.GetTickPrices(['EURUSD', 'USDJPY'], 0);
  XTB.GetCandles('EURUSD');
end;
// uses: sgcWebSocket, sgcWebSocket_API_XTB
TsgcWebSocketClient *WSClient = new TsgcWebSocketClient(this);
TsgcWSAPI_XTB *XTB = new TsgcWSAPI_XTB(this);
XTB->Client = WSClient;

WSClient->Active = true;
XTB->Login("user-id", "password");
XTB->GetCandles("EURUSD");

内部功能

基于会话的 WebSocket JSON RPC,具有独立的同步和流式端点——均封装在类型化 Delphi 方法中。

JSON RPC 会话

xStation 在会话锚定的 WebSocket 上使用请求/响应 JSON RPC。Login 打开会话并存储流式端点的 streamSessionId。

同步端点

类型化方法涵盖同步端:GetAllSymbolsGetCalendarGetCandlesGetCommissionDefGetMarginLevelGetServerTimeGetUserData 等。

流式端点

通过 SubscribeTickPricesSubscribeCandlesSubscribeBalanceSubscribeKeepAliveSubscribeNewsSubscribeTradeStatus 接入流式端点。

交易事务

TradeTransaction 通过同步端点下单、修改和关闭订单——TradeTransactionStatus 轮询结果订单的状态。

模拟或真实账户

将底层 TsgcWebSocketClient 指向 wss://ws.xtb.com/demowss://ws.xtb.com/real——线协议相同。

心跳 / 会话

XTB 在约 30 分钟后丢弃空闲会话——将底层客户端的 HeartBeat 绑定到 ping,使会话在稀疏调用之间保持活跃。

规范与参考

本组件实现的 API 的权威来源。

文档与演示

直接访问组件参考文档,获取即用型演示项目,并下载试用版。

在线帮助 — API_XTB 本组件的完整属性、方法和事件参考。
演示项目 — Demos\05.Crypto\13.XTB 即用型示例项目,随 sgcWebSockets 包提供——请在下方下载试用版。
技术文档 (PDF) 本组件的功能介绍、快速入门、Delphi & C++ Builder 代码示例及主要来源参考。
用户手册 (PDF) 涵盖库中所有组件的综合手册。

准备好使用 XTB 进行交易了吗?

下载免费试用版,将 XTB xStation 流式数据集成到您的 Delphi 应用程序中。