FIX API

[!NOTE] 此 API 只能用于现货（SPOT）交易所。

基本信息

FIX 连接需要 TLS 加密。请使用本地 TCP+TLS 连接或设置本地代理如 stunnel 来处理 TLS 加密。

FIX 会话仅支持 Ed25519 密钥。

关于如何设置 Ed25519 密钥对，请参考本教程。

FIX API 订单接入会话

端点为：tcp+tls：//fix-oe.binance.com：9000
支持下单，取消订单和查询当前限制使用情况。
支持接收账户的所有 ExecutionReport<8> 和 List Status<N>。
仅允许带有 FIX_API 的 API Key 连接。
关于 QuickFIX 模式文件，请点击这里。

FIX API Drop Copy 会话

端点为：tcp+tls://fix-dc.binance.com:9000
支持接收账户的所有 ExecutionReport<8> 和 List Status<N>。
仅允许连接带有 FIX_API 或 FIX_API_READ_ONLY 的 API Key。
关于 QuickFIX 模式文件，请点击这里。

FIX API Market Data 会话

端点为：tcp+tls：//fix-md.binance.com：9000
支持市场数据流和活动工具查询。
不支持下订单或取消订单。
仅允许连接带有“FIX_API”或“FIX_API_READ_ONLY”的 API 密钥。

关于 QuickFIX 模式 (Schema) 文件，请点击这里。

FIX 连接需要 TLS 加密。请使用本地 TCP+TLS 连接或设置本地代理如 stunnel 来处理 TLS 加密。

FIX Market Data 的 QuickFIX Schema 可以在这里

FIX 连接生命周期

所有 FIX API 会话将尽最大努力，尽可能长时间地保持开放状态。
没有最短连接时间保证，服务器可能随时进入维护状态。
- 当服务器进入维护状态时，News <B> 消息将会被发送，以提示客户端重新连接。收到此消息后，客户端应建立新会话并在 10 秒内 关闭旧会话。如果客户端未在规定的时间范围内关闭旧连接，那么服务器会将其注销并关闭会话。
连接后，客户端必须发送 Logon <A> 请求。有关详情，请参阅如何签署登录请求。
客户端应在断开连接之前发送 Logout <5> 消息来关闭会话。未能发送注销消息将导致在 2x HeartInt (108) 定义的时间间隔内无法将会话的 SenderCompID (49) 用于新会话的建立。
系统允许在登录过程中协商 HeartInt (108) 值。可接受值的范围为 5 到 60 秒。
- 如果服务器在 HeartInt (108) 间隔内没有发送任何消息，将发送 HeartBeat <0>。
- 如果服务器在 HeartInt (108) 间隔内没有收到任何消息，将发送 TestRequest <1>。如果服务器在 HeartInt (108) 秒内没有收到来自客户端的包含预期 TestReqID (112) 的 HeartBeat <0> 消息，服务器将发送 Logout <5> 消息并关闭连接。
- 如果客户端在 HeartInt (108) 间隔内未收到任何消息，那么客户端应负责发送 TestRequest <1> 消息以确保连接正常。收到这样的 TestRequest <1> 后，服务器会发送包含预期 TestReqID (112) 的 HeartBeat <0> 消息来进行响应。如果客户端在 HeartInt (108) 间隔内没有收到服务器的响应，那么客户端应关闭现有的会话和连接，并且建立新的会话和连接。

API Key 权限

如果您需要使用 FIX API 的订单接入会话，您的 API key 必须配置 FIX_API 权限。如果您需要使用 FIX API 的 Drop Copy 会话，您的 API key 必须配置 FIX_API_READ_ONLY 或 FIX_API 权限。要访问 FIX Market Data 会话，您的 API 密钥必须配置为 FIX_API 或 FIX_API_READ_ONLY 权限

FIX 会话仅支持 Ed25519 密钥。

关于如何设置 Ed25519 密钥对，请参考本教程。

关于消息处理顺序

初始消息 Logon<A> 中必需的 MessageHandling (25035) 字段被用于控制：是否在消息被撮合引擎处理前，需要重新排序消息。

UNORDERED(1) 允许不按顺序将来自客户端的消息发送到撮合引擎。
SEQUENTIAL(2) 来自客户端的消息始终以 MsgSeqNum(34) 中定义的顺序发送到撮合引擎。

[!TIP] 在有多个消息需要从客户端传输到服务器的情况时， UNORDERED(1) 应该会提供更好的性能。

响应模式

默认情况下，所有并发订单录入会话都会接收到账户所有成功的 ExecutionReport <8> 和 ListStatus <N> 消息，包括从其他 FIX 会话和通过非 FIX API 下达的订单。

用户可以在初始消息 Logon<A> 中使用 ResponseMode (25036) 字段来改变这种行为。

EVERYTHING(1)：默认模式。
ONLY_ACKS(2)：无论操作成功还是失败，都只接收 ACK 消息。禁用 ExecutionReport 推送。

如何签署 Logon`<A>` 请求

Logon<A> 消息用于验证您与 FIX API 的连接。这条消息必须是客户端发送的第一条消息。

Username (553) 字段必须包含 API key。
RawData (96) 字段必须包含使用 API key 生成的有效签名。

签名 payload 是一个文本字符串。该字符串通过按以下所列顺序去连接下列字段来构成，并且以 SOH 字符作为分隔符：

MsgType (35)
SenderCompId (49)
TargetCompId (56)
MsgSeqNum (34)
SendingTime (52)

请使用您的密钥签署 payload。请使用 base64 对签名进行编码。生成的文本字符串是 RawData (96) 字段的值。

以下是实现签名算法的 Python 代码示例：

import base64

from cryptography.hazmat.primitives.asymmetric.ed25519 import Ed25519PrivateKey
from cryptography.hazmat.primitives.serialization import load_pem_private_key

def logon_raw_data(private_key: Ed25519PrivateKey,
                   sender_comp_id: str,
                   target_comp_id: str,
                   msg_seq_num: str,
                   sending_time: str):
    """
    Computes the value of RawData (96) field in Logon<A> message.
    """
    payload = chr(1).join([
        'A',
        sender_comp_id,
        target_comp_id,
        msg_seq_num,
        sending_time,
    ])
    signature = private_key.sign(payload.encode('ASCII'))
    return base64.b64encode(signature).decode('ASCII')


with open('private_key.pem', 'rb') as f:
    private_key = load_pem_private_key(data=f.read(),
                                       password=None)

raw_data = logon_raw_data(private_key,
                          sender_comp_id='5JQmUOsm',
                          target_comp_id='SPOT',
                          msg_seq_num='1',
                          sending_time='20240612-08:52:21.613')

以下值可用于验证签名计算实现的正确性：

字段	取值
MsgType (35)	`A`
SenderCompID (49)	`EXAMPLE`
TargetCompID (56)	`SPOT`
MsgSeqNum (34)	`1`
SendingTime (52)	`20240627-11:17:25.223`

示例计算中使用的 Ed25519 密钥如下所示：

[!CAUTION] 以下密钥仅用于示范说明目的。请务必不要在任何实际应用中使用该密钥，因为它不安全，可能会危及您的加密实现。请在实际使用中生成属于您自己的唯一且安全的密钥。

-----BEGIN PRIVATE KEY-----
MC4CAQAwBQYDK2VwBCIEIIJEYWtGBrhACmb9Dvy+qa8WEf0lQOl1s4CLIAB9m89u
-----END PRIVATE KEY-----

经过计算生成的签名：

4MHXelVVcpkdwuLbl6n73HQUXUf1dse2PCgT1DYqW9w8AVZ1RACFGM+5UdlGPrQHrgtS3CvsRURC1oj73j8gCA==

生成的 Logon <A> 消息：

8=FIX.4.4|9=247|35=A|34=1|49=EXAMPLE|52=20240627-11:17:25.223|56=SPOT|95=88|96=4MHXelVVcpkdwuLbl6n73HQUXUf1dse2PCgT1DYqW9w8AVZ1RACFGM+5UdlGPrQHrgtS3CvsRURC1oj73j8gCA==|98=0|108=30|141=Y|553=sBRXrJx2DsOraMXOaUovEhgVRcjOvCtQwnWj8VxkOh1xqboS02SPGfKi2h8spZJb|25035=2|10=227|

限制

消息限制

每个连接都有一个关于 可以发送到交易所的消息数量 的限制。
消息限制 不计算从接口发回到客户端的响应消息数量。
违反消息限制会立即导致 Logout <5> 并断开连接。
要了解当前的限制和使用情况，请发送 LimitQuery<XLQ> 消息。接口将发送 LimitResponse<XLR> 消息作为响应，其中包含了有关订单速率限制和消息限制的信息。
FIX API 订单输入会话的限制为每 10 秒 10,000 条消息。
FIX Drop Copy 会话的限制为每 60 秒 60 条消息。
FIX Market Data 会话的限制为每 60 秒 2000 条消息。

未成交订单计数

要了解您在特定时间间隔内下了多少订单，请发送 LimitQuery<XLQ> 消息。系统将发送一条 LimitResponse<XLR> 消息作为响应，其中会包含有关未成交订单计数和消息限制的信息。
请注意，如果您的订单一直顺利完成交易，您可以在 API 持续下订单。更多信息，请参见现货未成交订单计数规则。
如果您超过了未成交的订单计数限制，您的消息将被拒绝，并且信息将用该接口的拒绝消息格式传回给您。
未成交订单数量是按照每个账户来统计的。

连接限制

每个账户都有一个关于 可以同时建立的 TCP 连接数量 的限制。
当 TCP 连接关闭时，限制值会减少。如果限制值没有立即减少，请等待最长不超过2倍于在 HeartBtInt (108) 内所定义的时间。比如说，如果 HeartBtInt 的值为5，那么请等待10秒钟。
违反限制时， Reject <3> 消息会被发送给用户。该消息包含了有关违反连接限制和当前限制的信息。
对于订单接入会话，其限制为每个账户 5 个并发 TCP 连接。
对于 Drop Copy 会话，其限制为每个账户 10 个并发 TCP 连接。
对于市场数据会话，每个账户的并发 TCP 连接数限制为 100 个。

错误处理

包含句法错误，缺少必填字段，或引用未知交易对的客户端消息将被服务器拒绝，并返回 Reject <3> 消息。

如果有效消息无法被处理并被拒绝，服务器将发送相应的拒绝响应。请参阅各个消息的相关文档以了解可能会发生的响应。

请参阅响应中的 Text (58) 和 ErrorCode (25016) 字段以了解拒绝原因。

错误代码列表可以在错误代码页面找到。

类型

仅支持可打印的 ASCII 字符和 SOH。

类型	描述
`BOOLEAN`	Enum：`Y` 或 `N`.
`CHAR`	单个字符。
`INT`	有符号的 64 位整数。
`LENGTH`	无符号的 64 位整数。
`NUMINGROUP`	无符号的 64 位整数。
`PRICE`	定点数。精度取决于 symbol 定义。
`QTY`	定点数。精度取决于 symbol 定义。
`SEQNUM`	无符号的 64 位整数。
`STRING`	可打印的 ASCII 字符串。
`UTCTIMESTAMP`	表示 UTC 日期时间的字符串。

支持的 UTCTIMESTAMP 格式：

20011217-09:30:47 - 秒
20011217-09:30:47.123 - 毫秒
20011217-09:30:47.123456 - 微秒（用于来自交易所的消息）

客户端订单 ID 字段必须符合正则表达式 ^[a-zA-Z0-9-_]{1,36}$：

ClOrdID (11)
OrigClOrdID (41)
MDReqID (262)
ClListID (25014)
OrigClListID (25015)
CancelClOrdID (25034)

消息组件

在示例消息中， | 字符用于表示 SOH 字符：

8=FIX.4.4|9=113|35=A|34=1|49=SPOT|52=20240612-08:52:21.636837|56=5JQmUOsm|98=0|108=30|25037=4392a152-3481-4499-921a-6d42c50702e2|10=051|

出现在每条消息的开头。

Tag	名称	类型	是否必须	描述
8	BeginString	STRING	Y	始终为 `FIX.4.4`。必须是消息的第一个字段。
9	BodyLength	LENGTH	Y	消息长度（以字节为单位）。必须是消息的第二个字段。
35	MsgType	STRING	Y	必须是消息的第三个字段。可能的值： `0` - HEARTBEAT `1` - TEST_REQUEST `3` - REJECT `5` - LOGOUT `8` - EXECUTION_REPORT `9` - ORDER_CANCEL_REJECT `A` - LOGON `D` - NEW_ORDER_SINGLE `E` - NEW_ORDER_LIST `F` - ORDER_CANCEL_REQUEST `N` - LIST_STATUS `q` - ORDER_MASS_CANCEL_REQUEST `r` - ORDER_MASS_CANCEL_REPORT `XCN` - ORDER_CANCEL_REQUEST_AND_NEW_ORDER_SINGLE `XLQ` - LIMIT_QUERY `XLR` - LIMIT_RESPONSE `B` - NEWS `x`- INSTRUMENT_LIST_REQUEST `y` - INSTRUMENT_LIST `V` - MARKET_DATA_REQUEST `Y` - MARKET_DATA_REQUEST_REJECT `W` - MARKET_DATA_SNAPSHOT `X` - MARKET_DATA_INCREMENTAL_REFRESH
49	SenderCompID	STRING	Y	在账户的活动会话中必须是独特的。必须使用正则表达式：`^[a-zA-Z0-9-_]{1,8}$`
56	TargetCompID	STRING	Y	在客户端的消息中必须设置为`SPOT`。
34	MsgSeqNum	SEQNUM	Y	整数消息序列号。会导致间隙的值将被拒绝。
52	SendingTime	UTCTIMESTAMP	Y	消息传输时间（始终以 UTC 表示）。
25000	RecvWindow	INT	N	在`SendingTime (52)` 后，用于标识请求有效时间的毫秒数。在 Logon`<A>` 中默认为 `5000` 毫秒，最大值为 `60000` 毫秒。

Trailer

出现在每条消息的末尾。

Tag	名称	类型	是否必须	描述
10	CheckSum	STRING	Y	始终为3个字符的数字字符串。其取值是通过对消息中每个前导字符的 ASCII 值进行求和计算得出的，其中包括 start-of-header（SOH）。结果总和除以 256，余数形成 CheckSum 值。为保持固定长度，CheckSum 字段采用右对齐并按需要进行零填充。

Administrative Messages

Heartbeat `<0>`

如果在心跳间隔（Logon<A> 中的 HeartBtInt (108)）的期间没有传出流量，则由服务器发送。

由客户端发送则用于指示会话正常。

由客户端或服务器发送，用于给予 TestRequest<1> 消息有关响应。

Tag	名称	类型	是否必须	描述
112	TestReqID	STRING	N	当 Heartbeat`<35>` 作为对 TestRequest`<1>` 的响应发送时，必须镜像 TestRequest`<1>` 中的值。

TestRequest `<1>`

如果在心跳间隔（Logon<A> 中的 HeartBtInt (108)）的期间没有传入流量，则由服务器发送。

由客户端发送用于请求 Heartbeat<0> 响应。

[!NOTE] 如果客户端未能在超时范围内发送带有正确 TestReqID (112) 的 Heartbeat<0> 来响应 TestRequest<1> ，其连接将被断开。

Tag	名称	类型	必填	描述
112	TestReqID	STRING	Y	任意字符串，必须包含在 Heartbeat`<0>` 响应中。

Reject `<3>`

由服务器发送，用以响应无法处理的无效消息。

如果无法接受新连接，则由服务器发送。请参阅 Connection Limits。

请参阅 Text (58) 和 ErrorCode (25016) 字段以了解拒绝原因。

Tag	名称	类型	必填	描述
45	RefSeqNum	INT	N	导致此 Reject`<3>` 发送的被拒绝消息的 `MsgSeqNum (34)`。
371	RefTagID	INT	N	如果存在，标识直接导致此 Reject`<3>` 消息发送的字段。
372	RefMsgType	STRING	N	导致此 Reject`<3>` 发送的被拒绝消息的 `MsgType (35)`。
373	SessionRejectReason	INT	N	拒绝的原因，可以是以下值之一。通常伴随附加的文字描述可能的值： `0`- INVALID_TAG_NUMBER `1` - REQUIRED_TAG_MISSING `2` - TAG_NOT_DEFINED_FOR_THIS_MESSAGE_TYPE `3` - UNDEFINED_TAG `5` - VALUE_IS_INCORRECT `6` - INCORRECT_DATA_FORMAT_FOR_VALUE `8` - SIGNATURE_PROBLEM `10` - SENDINGTIME_ACCURACY_PROBLEM `12` - XML_VALIDATION_ERROR `13` - TAG_APPEARS_MORE_THAN_ONCE `14` - TAG_SPECIFIED_OUT_OF_REQUIRED_ORDER `15` - REPEATING_GROUP_FIELDS_OUT_OF_ORDER `16` - INCORRECT_NUMINGROUP_COUNT_FOR_REPEATING_GROUP `99` - OTHER
25016	ErrorCode	INT	N	API 错误代码（参见错误代码）。
58	Text	STRING	N	人类可读的错误信息。

Logon`<A>`

由客户端发送，用以验证连接。 Logon<A> 必须是客户端发送的第一条消息。

由服务器发送，用以响应成功的登录。

[!NOTE] Logon<A> 在整个会话期间只能发送一次。

Logon Request

Tag	名称	类型	是否必须	描述
98	EncryptMethod	INT	Y	必须为 `0`。
108	HeartBtInt	INT	Y	必须在 [5, 60] 范围内。Heartbeat 间隔（秒）。
95	RawDataLength	LENGTH	Y	紧随此字段之后的 `RawData (96)` 字段的长度。
96	RawData	DATA	Y	签名。如何签署 Logon`<A>` 请求。
141	ResetSeqNumFlag	BOOLEAN	Y	必须为 `Y`。
553	Username	STRING	Y	API key。仅支持 Ed25519 API keys。
25035	MessageHandling	INT	Y	可能的值: `1` - UNORDERED `2` - SEQUENTIAL 请参阅关于消息处理顺序了解更多信息。
25036	ResponseMode	INT	N	请参阅响应模式。
9406	DropCopyFlag	BOOLEAN	N	登录到 Drop Copy 会话时，必须设置为"Y"。

示例消息:

8=FIX.4.4|9=248|35=A|34=1|49=5JQmUOsm|52=20240612-08:52:21.613|56=SPOT|95=88|96=KhJLbZqADWknfTAcp0ZjyNz36Kxa4ffvpNf9nTIc+K5l35h+vA1vzDRvLAEQckyl6VDOwJ53NOBnmmRYxQvQBQ==|98=0|108=30|141=Y|553=W5rcOD30c0gT4jHK8oX5d5NbzWoa0k4SFVoTHIFNJVZ3NuRpYb6ZyJznj8THyx5d|25035=1|10=000|

Logon Response

Tag	名称	类型	是否必须	描述
98	EncryptMethod	INT	Y	始终为 `0`。
108	HeartBtInt	INT	Y	镜像 Logon 请求中的值。
25037	UUID	STRING	Y	提供请求服务的 FIX API 的 UUID。

示例消息:

8=FIX.4.4|9=113|35=A|34=1|49=SPOT|52=20240612-08:52:21.636837|56=5JQmUOsm|98=0|108=30|25037=4392a152-3481-4499-921a-6d42c50702e2|10=051|

Logout `<5>`

发送此消息以启动关闭连接的过程，并对 Logout 进行响应。

Tag	名称	类型	是否必须	描述
58	Text	STRING	N

示例消息:

Logout 请求

8=FIX.4.4|9=55|35=5|34=3|49=GhQHzrLR|52=20240611-09:44:25.543|56=SPOT|10=249|

Logout 响应

8=FIX.4.4|9=84|35=5|34=4|49=SPOT|52=20240611-09:44:25.544001|56=GhQHzrLR|58=Logout acknowledgment.|10=212|

News `<B>`

当连接即将关闭时，由服务器发送。

收到此消息后，客户端应建立新会话并在 10 秒内 关闭旧会话。如果客户端未在规定的时间范围内关闭旧连接，那么服务器会将其注销并关闭会话。

Tag	名称	类型	是否必须	描述
148	Headline	STRING	Y

示例消息:

8=FIX.4.4|9=0000113|35=B|49=SPOT|56=OE|34=4|52=20240924-21:07:35.773537|148=Your connection is about to be closed. Please reconnect.|10=165|

Resend Request `<2>`

目前不支持重新发送请求。

Application Messages

下单消息

[!NOTE] 以下消息只能用于 FIX 订单接入会话和 FIX Drop Copy 会话

NewOrderSingle`<D>`

由客户端发送，用以提交新订单并进行执行。

请参阅支持的订单类型了解支持的字段组合。

[!NOTE] 许多字段会根据订单类型变为必填。请参阅支持的订单类型。

Tag	名称	类型	是否必须	描述
11	ClOrdID	STRING	Y	分配给订单的 `ClOrdID`。
38	OrderQty	QTY	N	订单数量
40	OrdType	CHAR	Y	请参阅表格了解支持的订单类型和所需字段。可能的值: `1` - MARKET `2` - LIMIT `3` - STOP `4` - STOP_LIMIT
18	ExecInst	CHAR	N	可能的值: `6` - PARTICIPATE_DONT_INITIATE
44	Price	PRICE	N	订单价格
54	Side	CHAR	Y	订单方向。可能的值: `1` - BUY `2` - SELL
55	Symbol	STRING	Y	下单的交易对。
59	TimeInForce	CHAR	N	可能的值: `1` - GOOD_TILL_CANCEL `3` - IMMEDIATE_OR_CANCEL `4` - FILL_OR_KILL
111	MaxFloor	QTY	N	用于冰山订单，指定订单在订单簿上的可见数量。
152	CashOrderQty	QTY	N	以报价资产单位指定的订单数量，用于反向市场订单。
847	TargetStrategy	INT	N	该值不能小于 `1000000`。
7940	StrategyID	INT	N
25001	SelfTradePreventionMode	CHAR	N	可能的值: `1` - NONE `2` - EXPIRE_TAKER `3` - EXPIRE_MAKER `4` - EXPIRE_BOTH
1100	TriggerType	CHAR	N	可能的值: `4` - PRICE_MOVEMENT
1101	TriggerAction	CHAR	N	可能的值: `1` - ACTIVATE
1102	TriggerPrice	PRICE	N	止盈止损订单的激活价格。请参阅表格
1107	TriggerPriceType	CHAR	N	可能的值: `2` - LAST_TRADE
1109	TriggerPriceDirection	CHAR	N	用于区分 StopLoss 和 TakeProfit 订单。请参阅表格。可能的值: `U` - TRIGGER_IF_THE_PRICE_OF_THE_SPECIFIED_TYPE_GOES_UP_TO_OR_THROUGH_THE_SPECIFIED_TRIGGER_PRICE `D` - TRIGGER_IF_THE_PRICE_OF_THE_SPECIFIED_TYPE_GOES_DOWN_TO_OR_THROUGH_THE_SPECIFIED_TRIGGER_PRICE
25009	TriggerTrailingDeltaBips	INT	N	提供以创建追踪订单。
25032	SOR	BOOLEAN	N	是否为此订单激活 SOR。

示例消息:

8=FIX.4.4|9=114|35=D|34=2|49=qNXO12fH|52=20240611-09:01:46.228|56=SPOT|11=1718096506197867067|38=5|40=2|44=10|54=1|55=LTCBNB|59=4|10=016|

响应:

如果订单被接受， ExecutionReport<8>的 ExecType (150) 值为 NEW (0)。
如果订单被拒绝， ExecutionReport<8>的 ExecType (150) 值为 REJECTED (8)。
如果消息被拒绝，则为 Reject<3>。

支持的订单类型

订单名称	Binance OrderType	方向	必填字段值	用户值必填字段
Market order	`MARKET`	BUY 或 SELL	`40=1\|`
Limit order	`LIMIT`	BUY 或 SELL	`40=2\|`
Limit maker order	`LIMIT_MAKER`	BUY 或 SELL	`40=2\|18=6\|`
Buy stop loss order	`STOP_LOSS`	BUY	`40=3\|1100=4\|1101=1\|1107=2\|1109=U\|`	1102
Buy trailing stop loss order	`STOP_LOSS`	BUY	`40=3\|1100=4\|1101=1\|1107=2\|1109=U\|`	1102,25009
Buy stop loss limit order	`STOP_LOSS_LIMIT`	BUY	`40=4\|1100=4\|1101=1\|1107=2\|1109=U\|`	1102
Buy trailing stop loss limit order	`STOP_LOSS_LIMIT`	BUY	`40=4\|1100=4\|1101=1\|1107=2\|1109=U\|`	1102,25009
Sell stop loss order	`STOP_LOSS`	SELL	`40=3\|1100=4\|1101=1\|1107=2\|1109=D\|`	1102
Sell trailing stop loss order	`STOP_LOSS`	SELL	`40=3\|1100=4\|1101=1\|1107=2\|1109=D\|`	1102,25009
Sell stop loss limit order	`STOP_LOSS_LIMIT`	SELL	`40=4\|1100=4\|1101=1\|1107=2\|1109=D\|`	1102
Sell trailing stop loss limit order	`STOP_LOSS_LIMIT`	SELL	`40=4\|1100=4\|1101=1\|1107=2\|1109=D\|`	1102,25009
Buy take profit order	`TAKE_PROFIT`	BUY	`40=3\|1100=4\|1101=1\|1107=2\|1109=D\|`	1102
Buy trailing take profit order	`TAKE_PROFIT`	BUY	`40=3\|1100=4\|1101=1\|1107=2\|1109=D\|`	1102,25009
Buy trailing take profit order	`TAKE_PROFIT`	BUY	`40=3\|1100=4\|1101=1\|1107=2\|`	25009
Buy take profit order	`TAKE_PROFIT_LIMIT`	BUY	`40=4\|1100=4\|1101=1\|1107=2\|1109=D\|`	1102
Buy trailing take profit limit order	`TAKE_PROFIT_LIMIT`	BUY	`40=4\|1100=4\|1101=1\|1107=2\|1109=D\|`	1102,25009
Buy trailing take profit limit order	`TAKE_PROFIT_LIMIT`	BUY	`40=4\|1100=4\|1101=1\|1107=2\|`	25009
Sell take profit order	`TAKE_PROFIT`	SELL	`40=3\|1100=4\|1101=1\|1107=2\|1109=U\|`	1102
Sell trailing take profit order	`TAKE_PROFIT`	SELL	`40=3\|1100=4\|1101=1\|1107=2\|1109=U\|`	1102,25009
Sell trailing take profit order	`TAKE_PROFIT`	SELL	`40=3\|1100=4\|1101=1\|1107=2\|`	25009
Sell take profit limit order	`TAKE_PROFIT_LIMIT`	SELL	`40=4\|1100=4\|1101=1\|1107=2\|1109=U\|`	1102
Sell trailing take profit limit order	`TAKE_PROFIT_LIMIT`	SELL	`40=4\|1100=4\|1101=1\|1107=2\|1109=U\|`	1102,25009
Sell trailing take profit limit order	`TAKE_PROFIT_LIMIT`	SELL	`40=4\|1100=4\|1101=1\|1107=2\|`	25009

基于 Binance OrderType 的必填字段:

Binance OrderType	额外的必填字段	额外的信息
`LIMIT`	38, 44, 59
`MARKET`	38 或 152	`MARKET` 订单使用 `OrderQty (38)` 字段来指定用户希望以市场价格买入或卖出的 `base asset` 数量。例如，用户可以使用交易对为 `BTCUSDT` 的 `MARKET` 订单来指定买入或卖出多少 BTC。用户使用 `MARKET` 订单中的 `quoteOrderQty` 字段来指定花费（买入时）或接收（卖出时）`quote` 资产。正确的 `quantity` 将由市场流动性和 `quoteOrderQty` 来决定。用交易对 BTCUSDT来举例： `BUY` 方订单将使用由 `quoteOrderQty` 定义的 USDT 数额来购买尽可能多的 BTC。 `SELL` 方订单将出售 BTC 来换取尽可能多的由 `CashOrderQty（152)` 定义的 USDT 数额。
`STOP_LOSS`	38, 1102 或 25009	当满足条件时，将执行 `MARKET` 订单。（例如，满足 `TriggerPrice (1102)` 的条件或激活 `TriggerTrailingDeltaBips (25009)`）
`STOP_LOSS_LIMIT`	38, 44, 59, 1102 或 25009
`TAKE_PROFIT`	38, 1102 或 25009	当满足条件时，这将执行`MARKET`订单。（例如，满足 `TriggerPrice (1102)` 的条件或激活 `TriggerTrailingDeltaBips (25009)`）
`TAKE_PROFIT_LIMIT`	38, 44, 59, 1102 或 25009
`LIMIT_MAKER`	38, 44	这是一个 `LIMIT` 订单。如果订单被立即匹配并作为 taker 进行交易，那么该订单将被拒绝。这也称为 POST-ONLY 订单。

ExecutionReport`<8>`

每当订单状态发生变化时由服务器发送。

[!NOTE]

默认情况下，ExecutionReport<8> 会发送该账户的所有订单，包括在不同连接中提交的订单。请参阅响应模式来了解其他行为选项。

FIX API 应该为 ExecutionReport<8> 推送提供更好的性能。

Tag	名称	类型	是否必须	描述
17	ExecID	STRING	N	被拒绝订单时省略。
11	ClOrdID	STRING	N	列表中分配的 `ClOrdID`。
41	OrigClOrdID	STRING	N	订单的原始 `ClOrdID`。
37	OrderID	INT	N	由交易所分配。
38	OrderQty	QTY	N	订单数量。
40	OrdType	CHAR	Y	可能的值: `1` - MARKET `2` - LIMIT `3` - STOP_LOSS `4` - STOP_LIMIT
54	Side	CHAR	Y	可能的值: `1` - BUY `2` - SELL
55	Symbol	STRING	Y	订单的交易对。
18	ExecInst	CHAR	N	可能的值: `6` - PARTICIPATE_DONT_INITIATE
44	Price	PRICE	N	订单价格。
59	TimeInForce	CHAR	N	可能的值: `1` - GOOD_TILL_CANCEL `3` - IMMEDIATE_OR_CANCEL `4` - FILL_OR_KILL
60	TransactTime	UTCTIMESTAMP	N	此事件发生的时间戳。
25018	OrderCreationTime	INT	N
111	MaxFloor	QTY	N	出现在冰山订单中。
66	ListID	STRING	N	出现在列表订单中。
152	CashOrderQty	QTY	N	以 quote asset 单位指定的订单数量。
847	TargetStrategy	INT	N	订单提交请求中的 `TargetStrategy (847)`。
7940	StrategyID	INT	N	订单提交请求中的 `StrategyID (7940)`。
25001	SelfTradePreventionMode	CHAR	N	可能的值: `1` - NONE `2` - EXPIRE_TAKER `3` - EXPIRE_MAKER `4` - EXPIRE_BOTH
150	ExecType	CHAR	Y	注意: 如果订单因 `SelfTradePreventionMode(25013)` 过期，字段 `PreventedMatchID(25024)` 会被显示。可能的值: `0` - NEW `4` - CANCELED `5` - REPLACED `8` - REJECTED `F` - TRADE `C` - EXPIRED
14	CumQty	QTY	Y	在此订单上交易的 base asset 总数。
151	LeavesQty	QTY	N	剩余的可执行数量。
25017	CumQuoteQty	QTY	N	在此订单上交易的 quote asset 总数。
1057	AggressorIndicator	BOOLEAN	N	出现在 trade execution reports 中。指示订单在交易中是否为 taker。
1003	TradeID	STRING	N	出现在 trade execution reports 中。
31	LastPx	PRICE	N	最后一次执行的价格。
32	LastQty	QTY	Y	最后一次执行的数量。
39	OrdStatus	CHAR	Y	可能的值: `0` - NEW `1` - PARTIALLY_FILLED `2` - FILLED `4` - CANCELED `6` - PENDING_CANCEL `8` - REJECTED `A` - PENDING_NEW `C` - EXPIRED 注意 FIX 不支持 `EXPIRED_IN_MATCH` 状态，并在 FIX 中转换为 `EXPIRED`。
70	AllocID	INT	N	由交易所分配的分配 ID。
574	MatchType	INT	N	可能的值: `1` - ONE_PARTY_TRADE_REPORT `4` - AUTO_MATCH
25021	WorkingFloor	INT	N	出现在可能有分配的订单中。
25022	TrailingTime	UTCTIMESTAMP	N	仅出现在追踪止损订单中。
636	WorkingIndicator	BOOLEAN	N	当此订单进入订单簿时会被设置为 `Y`。
25023	WorkingTime	UTCTIMESTAMP	N	此订单出现在订单簿上的时间。
25024	PreventedMatchID	INT	N	仅出现在因 STP 过期的订单中。
25025	PreventedExecutionPrice	PRICE	N	仅出现在因 STP 过期的订单中。
25026	PreventedExecutionQty	QTY	N	仅出现在因 STP 过期的订单中。
25027	TradeGroupID	INT	N	仅出现在因 STP 过期的订单中。
25028	CounterSymbol	STRING	N	仅出现在因 STP 过期的订单中。
25029	CounterOrderID	INT	N	仅出现在因 STP 过期的订单中。
25030	PreventedQty	QTY	N	仅出现在因 STP 过期的订单中。
25031	LastPreventedQty	QTY	N	仅出现在因 STP 过期的订单中。
25032	SOR	BOOLEAN	N	出现在使用 SOR 的订单中。
25016	ErrorCode	INT	N	API 错误代码（请参阅错误代码）。
58	Text	STRING	N	可读的错误消息。
136	NoMiscFees	NUMINGROUP	N	杂费的重复组数量。
=>137	MiscFeeAmt	QTY	Y	以 `MiscFeeCurr(138)` 资产计价的费用金额
=>138	MiscFeeCurr	STRING	Y	杂费的货币。
=>139	MiscFeeType	INT	Y	可能的值: `4` - EXCHANGE_FEES
1100	TriggerType	CHAR	N	可能的值: `4` - PRICE_MOVEMENT
1101	TriggerAction	CHAR	N	可能的值: `1` - ACTIVATE
1102	TriggerPrice	PRICE	N	止盈止损订单的激活价格。请参阅表格
1107	TriggerPriceType	CHAR	N	可能的值: `2` - LAST_TRADE
1109	TriggerPriceDirection	CHAR	N	用于区分止损和止盈订单。请参阅表格。可能的值: `U` - TRIGGER_IF_THE_PRICE_OF_THE_SPECIFIED_TYPE_GOES_UP_TO_OR_THROUGH_THE_SPECIFIED_TRIGGER_PRICE `D` - TRIGGER_IF_THE_PRICE_OF_THE_SPECIFIED_TYPE_GOES_DOWN_TO_OR_THROUGH_THE_SPECIFIED_TRIGGER_PRICE
25009	TriggerTrailingDeltaBips	INT	N	仅出现在追踪止损订单中。

示例消息:

8=FIX.4.4|9=330|35=8|34=2|49=SPOT|52=20240611-09:01:46.228950|56=qNXO12fH|11=1718096506197867067|14=0.00000000|17=144|32=0.00000000|37=76|38=5.00000000|39=0|40=2|44=10.00000000|54=1|55=LTCBNB|59=4|60=20240611-09:01:46.228000|150=0|151=5.00000000|636=Y|1057=Y|25001=1|25017=0.00000000|25018=20240611-09:01:46.228000|25023=20240611-09:01:46.228000|10=095|

OrderCancelRequest`<F>`

由客户发送的，用以取消订单或订单列表。

要取消订单，需要 OrderID (11) 或 OrigClOrdID (41)。
要取消订单列表，需要 ListID (66) 或 OrigClListID (25015)。

如果已取消的订单是订单列表的一部分，则整个订单列表将被取消。

Tag	名称	类型	是否必须	描述
11	ClOrdID	STRING	Y	请求的 `ClOrdID`。
41	OrigClOrdID	STRING	N	要取消订单的 `ClOrdID (11)`。
37	Order ID	STRING	N	要取消订单的 `OrderID (37)`。
25015	OrigClListID	STRING	N	要取消订单列表的 `ClListID (25014)`。
66	ListID	STRING	N	要取消订单列表的 `ListID (66)`。
55	Symbol	STRING	Y	要取消订单的交易对。
25002	CancelRestrictions	INT	N	取消的限制。可能的值： `1` - ONLY_NEW `2` - ONLY_PARTIALLY_FILLED

示例消息：

8=FIX.4.4|9=93|35=F|34=2|49=ieBwvCKy|52=20240613-01:11:13.784|56=SPOT|11=1718241073695674483|37=2|55=LTCBNB|10=210|

响应：

对于每个被取消的订单，ExecutionReport<8>的 ExecType (150) 值为 CANCELED (4)。
如果订单列表中的订单被取消，则为 ListStatus<N>。
如果取消被拒绝，则为 OrderCancelReject<9>。
如果消息被拒绝，则为 Reject<3>。

OrderCancelReject `<9>`

当 OrderCancelRequest<F> 失败时，由服务器发送的消息。

Tag	名称	类型	是否必须	描述
11	ClOrdID	STRING	Y	来自取消请求的 `ClOrdID (11)`。
41	OrigClOrdID	STRING	N	来自取消请求的 `OrigClOrdID (41)`。
37	OrderID	INT	N	来自取消请求的 `OrderID (37)`。
25015	OrigClListID	STRING	N	来自取消请求的 `OrigClListID (25015)`。
66	ListID	STRING	N	来自取消请求的 `ListID (66)`。
55	Symbol	STRING	Y	来自取消请求的 `Symbol (55)`。
25002	CancelRestrictions	INT	N	来自取消请求的 `CancelRestrictions (25002)`。
434	CxlRejResponseTo	CHAR	Y	此 OrderCancelReject`<9>` 响应的请求类型。可能的值： `1` - ORDER_CANCEL_REQUEST
25016	ErrorCode	INT	Y	API error code (参考错误代码).
58	Text	STRING	Y	可读的错误消息。

示例消息：

8=FIX.4.4|9=137|35=9|34=2|49=SPOT|52=20240613-01:12:41.320869|56=OlZb8ht8|11=1718241161272843932|37=2|55=LTCBNB|58=Unknown order sent.|434=1|25016=-1013|10=087|

OrderCancelRequestAndNewOrderSingle`<XCN>`

由客户发送，用以取消订单并提交新订单以供执行。在描述新订单时，请参阅支持的订单类型了解支持的字段组合。

[!NOTE] 取消始终是优先处理的，紧接着的是提交新订单。

Tag	名称	类型	是否必须	描述
25033	OrderCancelRequestAndNewOrderSingleMode	INT	Y	用于定义：如果取消失败，将会采取的后续操作。可能的值： `1` - STOP_ON_FAILURE `2` -ALLOW_FAILURE
25038	OrderRateLimitExceededMode	INT	N	用于定义：如果超过未成交订单计数，将会如何处理取消请求。可能的值： `1` - DO_NOTHING `2` - CANCEL_ONLY
37	OrderID	INT	N	来自于取消订单的 `OrderID`。
25034	CancelClOrdID	STRING	N	待取消的 `ClOrdID`。
41	OrigClOrdID	STRING	N	来自待取消订单的 `ClOrdID`。
11	ClOrdID	STRING	Y	用于分配给新订单的 `ClOrdID`。
25002	CancelRestrictions	INT	N	取消的限制。可能值： `1` - ONLY_NEW `2` - ONLY_PARTIALLY_FILLED
38	OrderQty	QTY	N	新订单的数量
40	OrdType	CHAR	Y	请参阅 [表格]（#ordertype）以了解支持的订单类型以及相关的必填字段。可能的值： `1` - MARKET `2` - LIMIT `3` - STOP `4` - STOP_LIMIT
18	ExecInst	CHAR	N	可能的值： `6` - PARTICIPATE_DONT_INITIATE
44	Price	PRICE	N	新订单的价格
54	Side	CHAR	Y	订单方向。可能的值： `1` - BUY `2` - SELL
55	Symbol	STRING	Y	取消并下新订单所用的交易对。
59	TimeInForce	CHAR	N	可能的值： `1` - GOOD_TILL_CANCEL `3` - IMMEDIATE_OR_CANCEL `4` - FILL_OR_KILL
111	MaxFloor	QTY	N	用于冰山订单，用于定义订单在 orderbook 上的可见数量。
152	CashOrderQty	QTY	N	用于反向市价单，用于定义 quote asset 单位中的订单数量。
847	TargetStrategy	INT	N	该值不能小于 `1000000`。
7940	StrategyID	INT	N
25001	SelfTradePreventionMode	CHAR	N	可能的值: `1` - NONE `2` - EXPIRE_TAKER `3` - EXPIRE_MAKER `4` - EXPIRE_BOTH
1100	TriggerType	CHAR	N	可能的值: `4` - PRICE_MOVEMENT
1101	TriggerAction	CHAR	N	可能的值: `1` - ACTIVATE
1102	TriggerPrice	PRICE	N	止盈止损订单的激活价格。参见表格
1107	TriggerPriceType	CHAR	N	可能的值 `2` - LAST_TRADE
1109	TriggerPriceDirection	CHAR	N	用于区分止损订单和止盈订单。参考表格 . 可能的值： `U` - TRIGGER_IF_THE_PRICE_OF_THE_SPECIFIED_TYPE_GOES_UP_TO_OR_THROUGH_THE_SPECIFIED_TRIGGER_PRICE `D` -TRIGGER_IF_THE_PRICE_OF_THE_SPECIFIED_TYPE_GOES_DOWN_TO_OR_THROUGH_THE_SPECIFIED_TRIGGER_PRICE
25009	TriggerTrailingDeltaBips	INT	N	用以创建追踪订单。

示例消息：

8=FIX.4.4|9=160|35=XCN|34=2|49=JS8iiXK6|52=20240613-02:31:53.753|56=SPOT|11=1718245913721036458|37=8|38=5|40=2|44=4|54=1|55=LTCBNB|59=1|111=1|25033=1|25034=1718245913721036819|10=229|

响应：

对于每个被取消的订单，ExecutionReport<8> 的 ExecType (150) 值为 CANCELED (4)。
对于新订单，ExecutionReport<8> 的 ExecType (150) 值为 NEW (0)。
如果新订单被拒绝，ExecutionReport<8> 的 ExecType (150) 值为 REJECTED (8)。
如果取消订单的请求被拒绝，则为 OrderCancelReject<9>。
如果消息被拒绝，则为 Reject<3>。

OrderMassCancelRequest`<q>`

由客户端发送，用以取消交易品种上的所有挂单。

[!NOTE] 该账户的所有订单都将被取消，包括从不同连接中下的订单。

Tag	名称	类型	是否必须	描述
11	ClOrdID	STRING	Y	此批量取消请求的`ClOrdId`。
55	Symbol	STRING	Y	取消订单的交易对。
530	MassCancelRequestType	CHAR	Y	可能的值: `1` - CANCEL_SYMBOL_ORDERS

示例消息：

8=FIX.4.4|9=94|35=q|34=2|49=dpYPesqv|52=20240613-01:24:36.948|56=SPOT|11=1718241876901971671|55=ABCDEF|530=1|10=110|

响应：

对于每个被取消的订单，ExecutionReport<8> 的 ExecType (150) 值为 CANCELED (4)。
对于请求是否被接受或者拒绝，请参考 OrderMassCancelReport<r> 的字段 MassCancelResponse (531)。
如果消息被拒绝，则为 Reject<3>。

由服务器发送，用以响应 OrderMassCancelRequest<q>。

Tag	名称	类型	是否必须	描述
55	Symbol	STRING	Y	取消请求中的 `Symbol (55)` 。
11	ClOrdID	STRING	Y	取消请求中的 `ClOrdID （11)`。
530	MassCancelRequestType	CHAR	Y	取消请求中的 `MassCancelRequestType (530)`。
531	MassCancelResponse	CHAR	Y	可能的值： `0` - CANCEL_REQUEST_REJECTED `1` - CANCEL_SYMBOL_ORDERS
532	MassCancelRejectReason	INT	N	可能的值： `99` - OTHER
533	TotalAffectedOrders	INT	N	取消了多少订单。
25016	ErrorCode	INT	N	API 错误代码 (参考错误代码).
58	Text	STRING	N	可读的错误消息。

示例消息：

8=FIX.4.4|9=109|35=r|34=2|49=SPOT|52=20240613-01:24:36.949763|56=dpYPesqv|11=1718241876901971671|55=LTCBNB|530=1|531=1|533=5|10=083|

NewOrderList`<E>`

由客户发送，用以提交需要执行的订单列表。订单列表中的订单是相互依赖的。欲了解支持的订单类型和触发说明，请参考支持的订单列表类型。

Tag	名称	类型	是否必须	描述
25014	ClListID	STRING	Y	`ClListID`，用于分配给订单列表。
1385	ContingencyType	INT	N	可能的值： `1` -ONE_CANCELS_THE_OTHER `2` - ONE_TRIGGERS_THE_OTHER
73	NoOrders	NUMINGROUP	N	`Orders` 数组中的元素个数。只允许输入2或者3。
=>11	ClOrdID	STRING	Y	用于分配给订单的`ClOrdID`
=>38	OrderQty	QTY	N	订单数量
=>40	OrdType	CHAR	Y	请参阅表格以了解支持的订单类型及相关的必填字段。可能的值： `1` - MARKET `2` - LIMIT `3` - STOP `4` - STOP_LIMIT
=>18	ExecInst	CHAR	N	可能的值： `6` - PARTICIPATE_DONT_INITIATE
=>44	Price	PRICE	N	订单价格
=>54	Side	CHAR	Y	订单的方向。可能的值： `1` - BUY `2` - SELL
=>55	Symbol	STRING	Y	订单的交易对。
=>59	TimeInForce	CHAR	N	可能的值： `1` - GOOD_TILL_CANCEL `3` - IMMEDIATE_OR_CANCEL `4` - FILL_OR_KILL
=>111	MaxFloor	QTY	N	用于冰山订单，这指定了订单在 order book上的可见数量。
=>152	CashOrderQty	QTY	N	对于反向市场订单，在报价资产单位中指定的订单数量。
=>847	TargetStrategy	INT	N	该值不能小于 `1000000`。
=>7940	StrategyID	INT	N
=>25001	SelfTradePreventionMode	CHAR	N	可能的值： `1` - NONE `2` - EXPIRE_TAKER `3` - EXPIRE_MAKER `4` - EXPIRE_BOTH
=>1100	TriggerType	CHAR	N	可能的值: `4` - PRICE_MOVEMENT
=>1101	TriggerAction	CHAR	N	可能的值: `1` - ACTIVATE
=>1102	TriggerPrice	PRICE	N	止盈止损订单的激活价格。参见表格
=>1107	TriggerPriceType	CHAR	N	可能的值: `2` - LAST_TRADE
=>1109	TriggerPriceDirection	CHAR	N	用于区分止损订单和止盈订单。参见表格. 可能的值: `U` - TRIGGER_IF_THE_PRICE_OF_THE_SPECIFIED_TYPE_GOES_UP_TO_OR_THROUGH_THE_SPECIFIED_TRIGGER_PRICE `D` - TRIGGER_IF_THE_PRICE_OF_THE_SPECIFIED_TYPE_GOES_DOWN_TO_OR_THROUGH_THE_SPECIFIED_TRIGGER_PRICE
=>25009	TriggerTrailingDeltaBips	INT	N	用于追踪订单。
=>25010	NoListTriggeringInstructions	NUMINGROUP	N	`ListTriggeringInstructions` 数组中的元素个数。
==>25011	ListTriggerType	CHAR	N	为了触发 pending order， working order 所需进行的操作。可能的值: `1` - ACTIVATED `2` - PARTIALLY_FILLED `3` - FILLED
==>25012	ListTriggerTriggerIndex	INT	N	条件单的触发 Index：0-indexed。
==>25013	ListTriggerAction	CHAR	N	在满足 ListTriggerType 条件后对此订单执行的操作。可能的值: `1` - RELEASE `2` - CANCEL

示例消息：

8=FIX.4.4|9=236|35=E|34=2|49=Eg13pOvN|52=20240607-02:19:07.836|56=SPOT|73=2|11=w1717726747805308656|55=LTCBNB|54=2|38=1|40=2|44=0.25|59=1|11=p1717726747805308656|55=LTCBNB|54=2|38=1|40=1|25010=1|25011=3|25012=0|25013=1|1385=2|25014=1717726747805308656|10=171|

支持的订单列表类型

[!NOTE] 订单必须按照下表中 订单名称 中指定的顺序排列。

订单列表名称	应急类型（1385）	订单名称	订单方	允许的币安订单类型	列出触发指令
OCO	`1`	1. below order 2. above order	1. below order=`SELL` 2. above order=`SELL`	1. below order=`STOP_LOSS` 或 `STOP_LOSS_LIMIT` 2. above order=`LIMIT_MAKER`	1. below order: `25010=1\|25011=2\|25012=1\|25013=2\|` 2. above order: `25010=1\|25011=1\|25012=0\|25013=2\|`
OCO	`1`	1. below order 2. above order	1. below order=`BUY` 2. above order=`BUY`	1. below order=`LIMIT_MAKER` 2. above order=`STOP_LOSS` 或 `STOP_LOSS_LIMIT`	1. below order: `25010=1\|25011=1\|25012=1\|25013=2\|` 2. above order: `25010=1\|25011=2\|25012=0\|25013=2\|`
OCO	`1`	1. below order 2. above order	1. below order=`SELL` 2. above order=`SELL`	1. below order=`STOP_LOSS` 或 `STOP_LOSS_LIMIT` 2. above order= `TAKE_PROFIT`	1. below order: `25010=1\|25011=1\|25012=1\|25013=2\|` 2. above order: `25010=1\|25011=1\|25012=0\|25013=2\|`
OCO	`1`	1. below order 2. above order	1. below order=`BUY` 2. above order=`BUY`	1. below order=`TAKE_PROFIT` 2. above order = `STOP_LOSS` 或 `STOP_LOSS_LIMIT`	1. below order: `25010=1\|25011=1\|25012=1\|25013=2\|` 2. above order: `25010=1\|25011=1\|25012=0\|25013=2\|`
OTO	`2`	1. working order 2. pending order	1. working order=`SELL` 或 `BUY` 2. pending order=`SELL` 或 `BUY`	1. working order=`LIMIT` 或 `LIMIT_MAKER` 2. pending order=ANY	1. working order: NONE 2. pending order: `25010=1\|25011=3\|25012=0\|25013=1\|`
OTOCO	`2`	1. working order 2. pending below order 3. pending above order	1. working order=`SELL` 或 `BUY` 2. pending below order=`SELL` 3. pending above order=`SELL`	1. working order=`LIMIT` 或 `LIMIT_MAKER` 2. pending below order=`STOP_LOSS` 或 `STOP_LOSS_LIMIT` 3. pending above order=`LIMIT_MAKER`	1. working order: NONE 2. pending below order: `25010=2\|25011=3\|25012=0\|25013=2\|25011=2\|25012=2\|25013=2\|` 3. pending above order: `25010=2\|25011=3\|25012=0\|25013=2\|25011=1\|25012=1\|25013=2\|`
OTOCO	`2`	1. working order 2. pending below order 3. pending above order	1. working order=`SELL` 或 `BUY` 2. pending below order=`BUY` 3. pending above order=`BUY`	1. working order=`LIMIT` 或 `LIMIT_MAKER` 2. pending below order=`LIMIT_MAKER` 3. pending above order=`STOP_LOSS` 或 `STOP_LOSS_LIMIT`	1. working order: NONE 2. pending below order: `25010=2\|25011=3\|25012=0\|25013=2\|25011=1\|25012=2\|25013=2\|` 3. pending above order: `25010=2\|25011=3\|25012=0\|25013=2\|25011=2\|25012=1\|25013=2\|`
OTOCO	`2`	1. working order 2. pending below order 3. pending above order	1. working order=`SELL` 或 `BUY` 2. pending below order=`SELL` 3. pending above order=`SELL`	1. working order=`LIMIT` 或 `LIMIT_MAKER` 2. pending below order=`STOP_LOSS` 或 `STOP_LOSS_LIMIT` 3. pending above order=`TAKE_PROFIT`	1. working order: NONE 2. pending below order: `25010=2\|25011=3\|25012=0\|25013=2\|25011=1\|25012=2\|25013=2\|` 3. pending above order: `25010=2\|25011=3\|25012=0\|25013=2\|25011=1\|25012=1\|25013=2\|`
OTOCO	`2`	1. working order 2. pending below order 3. pending above order	1. working order=`SELL` 或 `BUY` 2. pending below order=`BUY` 3. pending above order=`BUY`	1. working order=`LIMIT` 或 `LIMIT_MAKER` 2. pending below order=`TAKE_PROFIT` 3. pending above order=`STOP_LOSS` 或 `STOP_LOSS_LIMIT`	1. working order: NONE 2. pending below order: `25010=2\|25011=3\|25012=0\|25013=2\|25011=1\|25012=2\|25013=2\|` 3. pending above order: `25010=2\|25011=3\|25012=0\|25013=2\|25011=1\|25012=1\|25013=2\|`

ListStatus`<N>`

每当订单列表状态发生变化时，由服务器发送的消息。

[!NOTE] 默认情况下，ListStatus<N> 会含有该账户的所有订单列表，包括在不同连接中提交的订单列表。请参阅响应模式来了解其他行为选项。

Tag	名称	类型	是否必须	描述
55	Symbol	STRING	Y	订单列表的交易对。
66	ListID	STRING	N	由交易所分配的订单列表 `ListID`。
25014	ClListID	STRING	N	分配给请求的订单列表 `ClListID` 。
25015	OrigClListID	STRING	N
1385	ContingencyType	INT	N	可能的值: `1` - ONE_CANCELS_THE_OTHER `2` - ONE_TRIGGERS_THE_OTHER
429	ListStatusType	INT	Y	可能的值: `2` - RESPONSE `4` - EXEC_STARTED `5` - ALL_DONE
431	ListOrderStatus	INT	Y	可能的值: `3` - EXECUTING `6` - ALL_DONE `7` - REJECT
1386	ListRejectReason	INT	N	可能的值: `99` - OTHER
103	OrdRejReason	INT	N	可能的值: `99` - OTHER
60	TransactTime	UTCTIMESTAMP	N	发生此事件时的时间戳。
25016	ErrorCode	INT	N	API 错误代码 (参考错误代码 ).
58	Text	STRING	N	可读的错误消息。
73	NoOrders	NUMINGROUP	N	`Orders` 数组中的元素个数。
=>55	Symbol	STRING	Y	订单的交易对。
=>37	OrderID	INT	Y	由交易所分配的订单 `OrderID`。
=>11	ClOrdID	STRING	Y	分配给请求的订单 `ClOrdID`。
=>25010	NoListTriggeringInstructions	NUMINGROUP	N	`ListTriggeringInstructions` 数组中的元素个数。
==>25011	ListTriggerType	CHAR	N	可能的值: `1` - ACTIVATED `2` - PARTIALLY_FILLED `3` - FILLED
==>25012	ListTriggerTriggerIndex	INT	N
==>25013	ListTriggerAction	CHAR	N	可能的值 `1` - RELEASE `2` - CANCEL

示例消息：

8=FIX.4.4|9=290|35=N|34=2|49=SPOT|52=20240607-02:19:07.837191|56=Eg13pOvN|55=ABCDEF|60=20240607-02:19:07.836000|66=25|73=2|55=LTCBNB|37=52|11=w1717726747805308656|55=ABCDEF|37=53|11=p1717726747805308656|25010=1|25011=3|25012=0|25013=1|429=4|431=3|1385=2|25014=1717726747805308656|25015=1717726747805308656|10=019|

Limit Messages

LimitQuery`<XLQ>`

由客户端发送，用于查询当前限制。

Tag	名称	类型	是否必须	描述
6136	ReqID	STRING	Y	此请求的 ID

示例消息：

8=FIX.4.4|9=82|35=XLQ|34=2|49=7buKHZxZ|52=20240614-05:35:35.357|56=SPOT|6136=1718343335357229749|10=170|

LimitResponse`<XLR>`

由服务器发送，以响应 LimitQuery<XLQ> 请求。

Tag	名称	类型	是否必须	描述
6136	ReqID	STRING	Y	`ReqID`。
25003	NoLimitIndicators	NUMINGROUP	Y	`LimitIndicator` 数组中的元素个数。
=>25004	LimitType	CHAR	Y	可能的值 `1` - ORDER_LIMIT `2` - MESSAGE_LIMIT
=>25005	LimitCount	INT	Y	此限制的当前使用情况。
=>25006	LimitMax	INT	Y	此限制允许的最大值。
=>25007	LimitResetInterval	INT	N	限制重置的频率。
=>25008	LimitResetIntervalResolution	CHAR	N	`LimitResetInterval` 的时间单位。可能的值： `s` - SECOND `m` - MINUTE `h` - HOUR `d` - DAY

示例消息：

8=FIX.4.4|9=225|35=XLR|34=2|49=SPOT|52=20240614-05:42:42.724057|56=uGnG0ef8|6136=1718343762723730315|25003=3|25004=2|25005=1|25006=1000|25007=10|25008=s|25004=1|25005=0|25006=200|25007=10|25008=s|25004=1|25005=0|25006=200000|25007=1|25008=d|10=241|

市场数据流

[!NOTE] 以下消息只能用于 FIX 市场数据流。

InstrumentListRequest`<x>`

由客户端发送以查询有关有效的交易对（即具有处于可交易的交易对）的信息。如果用于未激活的交易对，将以REJECT<3>进行响应。

Tag	Name	Type	Required	Description
320	InstrumentReqID	STRING	Y	此请求的 ID
559	InstrumentListRequestType	INT	Y	可能的值： `0` - SINGLE_INSTRUMENT `4` - ALL_INSTRUMENTS
55	Symbol	STRING	N	当 `InstrumentListRequestType` 设置为 `SINGLE_INSTRUMENT (0)` 时是必需的

示例消息:

8=FIX.4.4|9=92|35=x|49=BMDWATCH|56=SPOT|34=2|52=20250114-08:46:56.096691|320=BTCUSDT_INFO|559=0|55=BTCUSDT|10=164|

InstrumentList`<y>`

由服务器在响应 InstrumentListRequest<x> 时发送。

[!NOTE] 有关交易对（例如，过滤器）的其他信息可通过 [exchangeInfo]https://github.com/binance/binance-spot-api-docs/blob/master/rest-api_CN.md#exchangeInfo）请求来获得。

Tag	Name	Type	Required	Description
320	InstrumentReqID	STRING	Y	`InstrumentReqID` 从请求中得到
146	NoRelatedSym	NUMINGROUP	Y	交易数量
=>55	Symbol	STRING	Y	交易对
=>15	Currency	STRING	Y	此交易品种的定价资产
146	NoRelatedSym	NUMINGROUP	Y	交易品种数量
=>55	Symbol	STRING	Y
=>15	Currency	STRING	Y	此交易品种的 Quote asset
=>562	MinTradeVol	QTY	Y	最低交易数量
=>1140	MaxTradeVol	QTY	Y	最大交易数量
=>25039	MinQtyIncrement	QTY	Y	最小数量增加
=>25040	MarketMinTradeVol	QTY	Y	最低市价单交易数量
=>25041	MarketMaxTradeVol	QTY	Y	市价单最大交易数量
=>25042	MarketMinQtyIncrement	QTY	Y	最低市价订单数量增加
=>969	MinPriceIncrement	PRICE	Y	最低价格上调幅度

示例消息:

8=FIX.4.4|9=218|35=y|49=SPOT|56=BMDWATCH|34=2|52=20250114-08:46:56.100147|320=BTCUSDT_INFO|146=1|55=BTCUSDT|15=USDT|562=0.00001000|1140=9000.00000000|25039=0.00001000|25040=0.00000001|25041=76.79001236|25042=0.00000001|969=0.01000000|10=093||

MarketDataRequest`<V>`

由客户发送，用于订阅或取消订阅市场数据流。

交易数据流

交易数据流推送原始交易信息;每笔交易都有唯一的买家和卖家。

订阅所需的字段：

SubscriptionRequestType 的值为 SUBSCRIBE(1)
MDEntryType 的值为 TRADE(2)

更新速度： 实时

book ticker数据流

将指定交易对最佳买价，卖价以及数量的更新进行实时推送。

订阅所需的字段

SubscriptionRequestType 值为 SUBSCRIBE(1)
MDEntryType 值为 BID (0)
MDEntryType 值为 OFFER(1)
MarketDepth 值为 1
Individual Symbol Book Ticker Stream

将指定交易品种的任何更新实时推送到最佳买价或卖价或数量。

订阅所需的字段

值为 SUBSCRIBE(1) 的 SubscriptionRequestType
值为 BID (0) 的 MDEntryType
值为 OFFER(1) 的 MDEntryType
值为 1 的 MarketDepth

更新速度： 实时

[!NOTE] 在单个交易对订单簿数据流中，在MarketDataIncrementalRefresh<X> 消息里 MDUpdateAction 取代了之前的 Best Quote，

增量深度数据流

用于本地订单簿管理的价格和数量深度更新。

订阅所需的字段

SubscriptionRequestType 值为 SUBSCRIBE(1)
MDEntryType 值为 BID (0)
MDEntryType 值为 OFFER (1)
MarketDepth 值介于 2 和 5000 之间，用于控制初始快照的大小，对后续的 MarketDataIncrementalRefresh <X> 消息没有影响

更新速度： 100 毫秒

[!NOTE] 由于 MarketDataSnapshot<W> 对价格的深度有限制，所在初始快照之外没有数量变化的价格不会在增量深度信息数据流中。

因此，即使更新所有推送的数据流信息，依然会导致本地订单簿与真实订单簿有些微差异。

对于大多数情况，5000 的深度限制就足以理解市场和进行有效的交易。

Tag	Name	Type	Required	Description
262	MDReqID	STRING	Y	此请求的 ID
263	SubscriptionRequestType	CHAR	Y	订阅请求类型。可能的值： `1` - SUBSCRIBE `2` - UNSUBSCRIBE
264	MarketDepth	INT	N	订阅深度。可能的值： `1` - Book Ticker 订阅 `2`-`5000` - 增量深度流
266	AggregatedBook	NUMINGROUP	N	可能的值： `Y` - 每个价格每侧 1 个帐簿条目
146	NoRelatedSym	NUMINGROUP	N	交易对数量
=>55	Symbol	STRING	Y
267	NoMDEntryTypes	NUMINGROUP	N	条目类型数量
=>269	MDEntryType	CHAR	Y	可使用的值： `0` - BID `1` - OFFER `2` - TRADE

示例消息:

# Subscriptions
# BOOK TICKER Stream
8=FIX.4.4|9=132|35=V|49=TRADER1|56=SPOT|34=4|52=20241122-06:17:14.183428|262=BOOK_TICKER_STREAM|263=1|264=1|266=Y|146=1|55=BTCUSDT|267=2|269=0|269=1|10=010|
# DEPTH Stream
8=FIX.4.4|9=127|35=V|49=TRADER1|56=SPOT|34=7|52=20241122-06:17:14.443822|262=DEPTH_STREAM|263=1|264=10|266=Y|146=1|55=BTCUSDT|267=2|269=0|269=1|10=111|
# TRADE Stream
8=FIX.4.4|9=120|35=V|49=TRADER1|56=SPOT|34=3|52=20241122-06:34:14.775606|262=TRADE_STREAM|263=1|264=1|266=Y|146=1|55=BTCUSDT|267=1|269=2|10=040|
# Unsubscription from TRADE Stream
8=FIX.4.4|9=79|35=V|49=TRADER1|56=SPOT|34=7|52=20241122-06:41:56.966969|262=TRADE_STREAM|263=2|264=1|10=113|

MarketDataRequestReject`<Y>`

服务器对不正确的 MarketDataRequest 的响应消息 <V>.

Tag	Name	Type	Required	Description
262	MDReqID	STRING	Y	不正确的ID MarketDataRequest`<V>`
281	MDReqRejReason	CHAR	N	可能的错误原因: `1` - DUPLICATE_MDREQID `2` - TOO_MANY_SUBSCRIPTIONS
25016	ErrorCode	INT	N	API 错误代码参见错误代码。
58	Text	STRING	N	错误信息。

示例消息:

8=FIX.4.4|9=0000218|35=Y|49=SPOT|56=EXAMPLE|34=5|52=20241019-05:39:36.688964|262=BOOK_TICKER_2|281=2|25016=-1191|58=Similar subscription is already active on this connection. Symbol='BNBBUSD', active subscription id: 'BOOK_TICKER_1'.|10=137|

MarketDataSnapshot`<W>`

服务器对 MarketDataRequest<V>，激活单个 Symbol Book Ticker Stream 或增量深度流订阅的响应消息。

Tag	Name	Type	Required	Description
262	MDReqID	STRING	Y	激活此订阅的 MarketDataRequest`<V>` 的 ID
55	Symbol	STRING	Y
25044	LastBookUpdateID	INT	N
268	NoMDEntries	NUMINGROUP	Y	条目数
=>269	MDEntryType	CHAR	Y	可能的值： `0` - BID `1` - OFFER `2` - TRADE
=>270	MDEntryPx	PRICE	Y	价格
=>271	MDEntrySize	QTY	Y	数量

示例消息:

8=FIX.4.4|9=0000107|35=W|49=SPOT|56=EXAMPLE|34=34|52=20241019-05:41:52.867164|262=BOOK_TICKER_1_2|55=BNBBUSD|25044=0|268=0|10=151|

MarketDataIncrementalRefresh`<X>`

当一个订阅的数据流发生变化时，服务器发出的响应消息。

Tag	Name	Type	Required	Description
262	MDReqID	STRING	Y	激活此订阅的 MarketDataRequest `<V>` 的 ID
893	LastFragment	BOOLEAN	N	如果存在，则表示消息已分片。当单个 MarketDataIncrementalRefresh `<X>` 中的 `NoMDEntry` 超过 10000 时，会发生分片以便将其限制在10000。数据流中分片消息保证是连续的。分片消息只会出现在 Trade Stream 和 Diff. Depth Stream 中。
268	NoMDEntries	NUMINGROUP	Y	条目数
=>279	MDUpdateAction	CHAR	Y	可能的值： `0` - NEW `1` - CHANGE `2` - DELETE
=>270	MDEntryPx	PRICE	Y	价格
=>271	MDEntrySize	QTY	N	数量
=>269	MDEntryType	CHAR	Y	可能的值： `0` - BID `1` - OFFER `2` - TRADE
=>55	Symbol	STRING	N	如果未指定`交易对`，则默认使用同一市场数据流消息中前一个消息的交易对
=>60	TransactTime	UTCTIMESTAMP	N
=>1003	TradeID	INT	N
=>2446	AggressorSide	CHAR	N	可能的值： `1` - BUY `2` - SELL
=>25043	FirstBookUpdateID	INT	N	只会在增量深度数据流中出现. 如果 `LastBookUpdateID` 没有指定，市场数据消息的 `FirstBookUpdateID` 将会默认设置为与之前消息一样的 `FirstBookUpdateID`
=>25044	LastBookUpdateID	INT	N	只会在增量深度数据流和单个交易对订单簿数据流中出现. 如果 `LastBookUpdateID` 没有指定，市场数据消息的 `LastBookUpdateID` 将会默认设置为与之前消息一样的 `LastBookUpdateID`

示例消息:

8=FIX.4.4|9=0000313|35=X|49=SPOT|56=EXAMPLE|34=16|52=20241019-05:40:11.466313|262=TRADE_3|893=N|268=3|279=0|269=2|270=10.00000|271=0.01000|55=BNBBUSD|1003=0|60=20241019-05:40:11.464000|279=0|269=2|270=10.00000|271=0.01000|1003=1|60=20241019-05:40:11.464000|279=0|269=2|270=10.00000|271=0.01000|1003=2|60=20241019-05:40:11.464000|10=125|

示例分片消息:

[!NOTE] 以下是示例消息，其中 NoMDEntry 限制为 2，在实际流中，NoMDEntry 限制为 10000。

Trade Stream

8=FIX.4.4|9=237|35=X|34=114|49=SPOT|52=20250116-19:36:44.544549|56=EXAMPLE|262=id|268=2|279=0|270=240.00|271=3.00000000|269=2|55=BNBBUSD|60=20250116-19:36:44.196569|1003=67|279=0|270=238.00|271=2.00000000|269=2|60=20250116-19:36:44.196569|1003=68|893=N|10=180|
8=FIX.4.4|9=163|35=X|34=115|49=SPOT|52=20250116-19:36:44.544659|56=EXAMPLE|262=id|268=1|279=0|270=233.00|271=1.00000000|269=2|55=BNBBUSD|60=20250116-19:36:44.196569|1003=69|893=Y|10=243|

Diff. Depth Stream

8=FIX.4.4|9=156|35=X|34=12|49=SPOT|52=20250116-19:45:31.774162|56=EXAMPLE|262=id|268=2|279=2|270=362.00|269=0|55=BNBBUSD|25043=1143|25044=1145|279=2|270=313.00|269=0|893=N|10=047|
8=FIX.4.4|9=171|35=X|34=13|49=SPOT|52=20250116-19:45:31.774263|56=EXAMPLE|262=id|268=2|279=2|270=284.00|269=0|55=BNBBUSD|25043=1143|25044=1145|279=1|270=264.00|271=3.00000000|269=0|893=N|10=239|
8=FIX.4.4|9=149|35=X|34=14|49=SPOT|52=20250116-19:45:31.774281|56=EXAMPLE|262=id|268=1|279=1|270=395.00|271=19.00000000|269=1|55=BNBBUSD|25043=1143|25044=1145|893=Y|10=024|

FIX API

基本信息​

FIX API 订单接入会话​

FIX API Drop Copy 会话​

FIX API Market Data 会话​

FIX 连接生命周期​

API Key 权限​

关于消息处理顺序​

响应模式​

如何签署 Logon<A> 请求​

限制​

消息限制​

未成交订单计数​

连接限制​

错误处理​

类型​

消息组件​

Header​

Trailer​

Administrative Messages​

Heartbeat <0>​

TestRequest <1>​

Reject <3>​

Logon<A>​

Logon Request​

Logon Response​

Logout <5>​

News <B>​

Resend Request <2>​

Application Messages​

下单消息​

NewOrderSingle<D>​

支持的订单类型​

ExecutionReport<8>​

OrderCancelRequest<F>​

OrderCancelReject <9>​

OrderCancelRequestAndNewOrderSingle<XCN>​

OrderMassCancelRequest<q>​

NewOrderList<E>​

支持的订单列表类型​

ListStatus<N>​

Limit Messages​

LimitQuery<XLQ>​

LimitResponse<XLR>​

市场数据流​

InstrumentListRequest<x>​

InstrumentList<y>​

MarketDataRequest<V>​

MarketDataRequestReject<Y>​

MarketDataSnapshot<W>​

MarketDataIncrementalRefresh<X>​

基本信息

FIX API 订单接入会话

FIX API Drop Copy 会话

FIX API Market Data 会话

FIX 连接生命周期

API Key 权限

关于消息处理顺序

响应模式

如何签署 Logon`<A>` 请求

限制

消息限制

未成交订单计数

连接限制

错误处理

类型

消息组件

Header

Trailer

Administrative Messages

Heartbeat `<0>`

TestRequest `<1>`

Reject `<3>`

Logon`<A>`

Logon Request

Logon Response

Logout `<5>`

News `<B>`

Resend Request `<2>`

Application Messages

下单消息

NewOrderSingle`<D>`

支持的订单类型

ExecutionReport`<8>`

OrderCancelRequest`<F>`

OrderCancelReject `<9>`

OrderCancelRequestAndNewOrderSingle`<XCN>`

OrderMassCancelRequest`<q>`

NewOrderList`<E>`

支持的订单列表类型

ListStatus`<N>`

Limit Messages

LimitQuery`<XLQ>`

LimitResponse`<XLR>`

市场数据流

InstrumentListRequest`<x>`

InstrumentList`<y>`

MarketDataRequest`<V>`

MarketDataRequestReject`<Y>`

MarketDataSnapshot`<W>`

MarketDataIncrementalRefresh`<X>`