FIX API

FIX（金融信息交换）是一种标准的电子消息传输协议，可用于下订单、接收订单更新和执行，以及取消订单。我们的 FIX API 基于 FIX 4.2 规范，并模仿了其他热门加密货币交易所的 FIX 实现。

FIX 终端点：tcp+ssl://fix.btse.com:9876

Spot 和 Futures 的会话是分开的。

更新日志

版本 1.1.7（2024年9月12日）

支持统一期货钱包隔离仓位模式 新订单单（D）

版本 1.1.6（2024年3月8日）

添加订单执行报告的被拒绝生效时间（timeInForce）

版本 1.1.5（2024年1月9日）

添加订单被拒绝生效时间（timeInForce）默認状态

版本 1.1.4（2023年11月15日）

添加新的订单生效时间（timeInForce）状态

版本 1.1.3（2023年7月10日）

添加 心跳 (0) 推荐

版本 1.1.2（2023年7月10日）

• 在 Futures 市场中应用新的符号名称。在 登录 (A) 消息中添加 ApplyNewSymbolName

版本 1.1.1（2023年2月7日）

• 修改常见请求属性

版本 1.1.0（2022年12月6日）

• 发布期货市场交易功能 FIX API

版本 1.0.0（2022年10月18日）

• 发布现货市场交易功能 FIX API

速率限制

速率限制约束如下：

当违反速率限制规则时，客户端的请求将被拒绝，服务器将返回业务消息拒绝 (j)。

消息

FIX 协议使用字段分隔符（字符：0x01）来分隔消息中的属性。

FIX 协议属性

我们的 FIX API 基于 FIX 4.2 规范，可参考此网址。

常见请求属性

以下属性在每个客户端的请求消息中都是必需的。

登录 (A)

import org.apache.commons.codec.binary.Hex;
import org.apache.commons.codec.digest.HmacAlgorithms;
import org.apache.commons.codec.digest.HmacUtils;

// initialize String parameters: apiSecret, sendingTime, messageType, messageSeqNum, senderCompID, targetCompID


// compute the SHA384 HMAC using the API secret
final char SOH = 1;
final CharSequence SEPARATOR = Character.toString(SOH);

final String DATARAW = String.join(SEPARATOR, sendingTime, messageType, messageSeqNum, senderCompID, targetCompID);
final String SIGNATURE = Hex.encodeHexString(HmacUtils.getInitializedMac(HmacAlgorithms.HMAC_SHA_384, apiSecret.getBytes()).doFinal(dataRaw.getBytes()));

由客户端发送以初始化FIX会话。必须在建立连接后发送的第一条消息。每个连接只能建立一个会话；额外的登录消息将被拒绝。 客户端的API密钥和密钥可以在BTSE门户中的API页面生成。创建具有使用FIX API权限的密钥。

心跳 (0)

如果客户端将心跳间隔设置为N。我们建议您每隔N - 5秒左右发送一个心跳以保持连接活动。

测试请求 (1)

注销 (5)

由任一方发送以终止会话。另一方应以另一个注销消息响应以确认会话终止。连接将在之后关闭。

新订单单（D）

由客户端发送以提交新订单。FIX API当前仅支持市价单和限价单。

如果订单被接受，将返回执行报告（8），其中ExecType为：0（新建）、1（部分成交）、2（全部成交）、4（已取消）、7（已停止）、8（已拒绝）。
如果订单除了被取消、拒绝之外的錯誤，TimeInForce始终设置为："1"。

订单取消请求（F）

由客户端发送以请求取消订单。

只应提供OrderID（37）或OrigClOrdID（41）中的一个。

如果订单成功取消，将返回执行报告（8）。否则，将返回订单取消拒绝（9）。

订单取消拒绝（9）

由服务器发送以通知客户端订单取消请求（F）失败。

订单状态请求（H）

由客户端发送以请求订单状态

服务器将以所请求的订单或订单响应一个执行报告（8），ExecType=I（订单状态）。应仅提供OrderID（37）和OrigClOrdID（41）中的一个。如果同时提供OrderID（37）和OrigClOrdID（41），则仅应用OrderID（37）。当没有未完成订单时，服务器将包含Text（58）为"无未完成订单"。

执行报告（8）

由服务器在订单被成交，订单状态发生变化，或响应来自客户端的NewOrderSingle（D），OrderCancelRequest（F），或OrderStatusRequest（H）消息时发送。

ExecType值

ExecType（150）字段指示发送此ExecutionReport的原因。

请注意，每个订单更改都会发送一个执行报告消息。

OrdStatus值

拒绝（3）

由服务器以响应无效消息发送。