从 sgcWebSockets 4.5.0 起,支持 FTX API。
支持的 API
- WebSockets API:连接公共 WebSocket 服务器并提供实时市场数据更新。
- REST API:提供账户和订单管理以及公共市场数据的端点。
FTX WebSocket API
要连接到 FTX WebSocket API,只需创建一个新的 FTX API 客户端并将其附加到 TsgcWebSocketClient 即可。
示例如下:
oClient := TsgcWebSocketClient.Create(nil); oFTX := TsgcWSAPI_FTX.Create(nil); oFTX.Client := oClient; oClient.Active := True;
FTX 提供多种频道,您可以订阅以获取市场数据、订单等的实时更新。
以下是订阅行情(Ticker)的示例:
oClient := TsgcWebSocketClient.Create(nil);
oFTX := TsgcWSAPI_FTX.Create(nil);
oFTX.Client := oClient;
oFTX.SubscribeTicker('BTC-PERP');
procedure OnFTXMessage(Sender: TObject; aType, aRawMessage: string);
begin
// here you will receive the ticker updates
end;
FTX REST API
FTX 通过 REST 端点提供公共市场数据,调用这些端点时,您将获得所请求市场数据的快照。
市场数据端点无需身份验证,对所有用户免费开放。
示例:获取 BTC-PERP 市场快照,执行以下调用:
oFTX := TsgcWSAPI_FTX.Create(nil);
ShowMessage(oFTX.REST_API.GetMarket('BTC-PERP'));
FTX REST API 提供公共和私有端点。私有端点要求对消息进行签名以提高交易安全性。
首先,您需要登录 FTX 账户并创建新的 API,您将获得以下值:
- ApiKey
- ApiSecret
这些字段必须在 FTX API 客户端组件的 FTX 属性中进行配置。
配置完成后,您可以开始向 FTX REST API 发起私有请求:
oFTX := TsgcWSAPI_FTX.Create(nil); oFTX.FTX.ApiKey := '<your api key>'; oFTX.FTX.ApiSecret := '<your api secret>'; ShowMessage(oFTX.REST_API.GetAccount);
下单
市价单
创建新的市价单,买入 0.002 份 BTC-PERP 合约:
oFTX := TsgcWSAPI_FTX.Create(nil);
oFTX.FTX.ApiKey := 'your api key';
oFTX.FTX.ApiSecret := 'your api secret';
ShowMessage(oFTX.REST_API.PlaceMarketOrder('BTC-PERP', ftosBuy, 0.002));
限价单
创建新的限价单,以 10000 的价格限制买入 0.002 份 BTC-PERP 合约:
oFTX := TsgcWSAPI_FTX.Create(nil);
oFTX.FTX.ApiKey := 'your api key';
oFTX.FTX.ApiSecret := 'your api secret';
ShowMessage(oFTX.REST_API.PlaceLimitOrder('BTC-PERP', ftosBuy, 0.002, 10000));
