下单 (TRADE)
下一笔股票订单。支持 LIMIT / MARKET × BUY / SELL 的所有组合。对于 LIMIT BUY 订单,服务端在下单时自动计算并冻结手续费——调用方只需提交 price 和 quantity,无需传 fee 字段。
字段组合矩阵
| Side | OrderType | 必填 | 禁传 | | ---- | --------- | ---- | ---- | | BUY | LIMIT | price、quantity、tradingSession | notional | | BUY | MARKET | notional | price、quantity、tradingSession | | SELL | LIMIT | price、quantity、tradingSession | notional | | SELL | MARKET | quantity | price、notional、tradingSession |
碎股:当 quantity 带小数,或使用 notional 下单时,订单被视为碎股订单。碎股 GTC 订单必须搭配 tradingSession = EXTENDED 或 24H。
频率限制:200 次 / 分钟(UID)。
下单 (TRADE) › 授权
请求头
X-MBX-APIKEY访问此接口需要 API Key,并且必须在请求头中携带。关于如何创建 API Key,请参考:https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
symbol美股 ticker,如 AAPL、TSLA。必须是已开启代币化(tokenize)的 symbol——可通过 /market/tokenized-assets 查询。
sideBUY / SELL。
orderTypeMARKET / LIMIT。
timestamp时间戳(毫秒)。
quoteAsset计价资产,默认 USDC;必须在服务端允许集合内。
priceLIMIT 必填;MARKET 禁传。最多 2 位小数。
quantityLIMIT(买卖两侧)与 SELL MARKET 必填;BUY MARKET 禁传。
notionalBUY MARKET 必填;LIMIT 与 SELL MARKET 禁传。
timeInForceDAY(默认)/ GTC。GTC 仅支持 LIMIT 订单;碎股 GTC 订单必须搭配 tradingSession = EXTENDED 或 24H。
tradingSessionRTH / EXTENDED / 24H。LIMIT 必填;MARKET 禁传。
walletTypeBUY 侧付款钱包:CARD(默认)/ MAIN。SELL 侧固定结算至 CARD。
clientOrderId客户端自定义订单 ID。格式 ^[a-zA-Z0-9-_]{32,36}$。不传则服务端自动生成。
tokenize结算后是否将买入的股票资产代币化。默认 true。设为 false 则直接获得底层股票而非代币化资产。
recvWindow赋值不能大于 60000。
下单 (TRADE) › 响应
下单响应
status请求确认码:S = 已接受,F = 失败。这不是订单生命周期状态——如需查询生命周期,请调用 /order/detail 或 /order/history。
orderId订单 ID(UUID)。
clientOrderId回显提交的或服务端生成的客户端订单 ID。
撤单 (TRADE)
按 orderId 撤销单笔挂单。
撤单 (TRADE) › 授权
请求头
X-MBX-APIKEY访问此接口需要 API Key,并且必须在请求头中携带。关于如何创建 API Key,请参考:https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
orderId由 /order/place 或查询接口返回的股票订单 ID。
timestamp时间戳(毫秒)。
recvWindow赋值不能大于 60000。
撤单 (TRADE) › 响应
撤单响应
orderId回显请求的订单 ID。
status请求确认码:S = 撤单已被上游接受,F = 撤单失败。这不是订单生命周期状态——如需查询生命周期请使用 /order/detail。
全部撤单 (TRADE)
撤销调用方所有未成交订单。无需额外请求参数——范围固定为调用方所有未成交订单。下游服务保证幂等性;如需查看每笔订单的结果,请在调用后查询 /order/history。
全部撤单 (TRADE) › 授权
请求头
X-MBX-APIKEY访问此接口需要 API Key,并且必须在请求头中携带。关于如何创建 API Key,请参考:https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
timestamp时间戳(毫秒)。
recvWindow赋值不能大于 60000。
全部撤单 (TRADE) › 响应
全部撤单响应
success撤单请求被上游接受时为 true。每笔订单的结果请查询 /order/history。
当前挂单 (USER_DATA)
查询调用方所有未完成(挂单中)的股票订单。无需业务参数——用户身份由签名推导。
当前挂单 (USER_DATA) › 授权
请求头
X-MBX-APIKEY访问此接口需要 API Key,并且必须在请求头中携带。关于如何创建 API Key,请参考:https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
timestamp时间戳(毫秒)。
recvWindow赋值不能大于 60000。
当前挂单 (USER_DATA) › 响应
当前挂单响应
orderId股票订单 ID。
symbol美股 ticker。
quote计价资产(如 USDC)。
sideBUY / SELL。
orderTypeMARKET / LIMIT。
limitPrice限价(USD)。LIMIT 订单非空,MARKET 订单为 null。
avgFilledPrice平均成交价(USD)。首笔成交前为 null。
qty请求股数。BUY MARKET 时为 null(使用 notional 替代)。
notional请求名义金额。BUY MARKET 非空;其他情况为 null。
filledQty累计成交数量。
filledTotal累计成交名义金额,仅 BUY MARKET 有值。
fee总手续费(USD)。
session下单时的交易时段:RTH / EXTENDED / 24H。MARKET 订单为 null。
status订单生命周期状态,取值之一:NEW / ACCEPTED / PARTIALLY_FILLED / FILLED / CANCELED / EXPIRED / REJECTED。
createdAt订单创建时间(毫秒时间戳)。
updatedAt最后更新时间(毫秒时间戳)。
订单历史 (USER_DATA)
调用方的分页订单历史,可按 symbol、订单类型、方向、状态和时间段过滤。
订单历史 (USER_DATA) › 授权
请求头
X-MBX-APIKEY访问此接口需要 API Key,并且必须在请求头中携带。关于如何创建 API Key,请参考:https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
startTime开始时间(毫秒时间戳)。
endTime结束时间(毫秒时间戳)。
timestamp时间戳(毫秒)。
symbol美股 ticker 过滤,例如 NVDA。
orderType订单类型过滤:MARKET / LIMIT。
side方向过滤:BUY / SELL。
orderStatus逗号分隔的状态过滤,允许值:FILLED、PARTIALLY_FILLED、CANCELED、EXPIRED、REJECTED。
current页码,从 1 起,默认 1。
size每页大小,默认 20,最大 100。
recvWindow赋值不能大于 60000。
订单历史 (USER_DATA) › 响应
订单历史
total符合过滤条件的总行数。
page当前页码(回显 current)。
size当前页大小(回显 size)。
本页订单列表,无匹配时为空数组。
orderId股票订单 ID。
symbol美股 ticker。
quote计价资产(如 USDC)。
sideBUY / SELL。
orderTypeMARKET / LIMIT。
limitPrice限价(USD)。LIMIT 订单非空,MARKET 订单为 null。
avgFilledPrice平均成交价(USD)。首笔成交前为 null。对 MARKET 订单,这是唯一有意义的价格字段。
qty请求股数。BUY MARKET 时为 null(使用 notional 替代)。
notional请求名义金额。BUY MARKET 非空;其他情况为 null。
filledQty累计成交数量。
filledTotal累计成交名义金额,仅 BUY MARKET 有值。
fee总手续费(USD)。
session下单时的交易时段:RTH / EXTENDED / 24H。MARKET 订单为 null。
status订单生命周期状态,取值之一:NEW / ACCEPTED / PARTIALLY_FILLED / FILLED / CANCELED / EXPIRED / REJECTED。
createdAt订单创建时间(毫秒时间戳)。
updatedAt最后更新时间(毫秒时间戳)。
订单详情 (USER_DATA)
返回单笔订单及其成交明细列表。调用方只能查询自己的订单——用户身份从签名请求中解析。
订单详情 (USER_DATA) › 授权
请求头
X-MBX-APIKEY访问此接口需要 API Key,并且必须在请求头中携带。关于如何创建 API Key,请参考:https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
orderId股票订单 ID。
timestamp时间戳(毫秒)。
recvWindow赋值不能大于 60000。
订单详情 (USER_DATA) › 响应
订单详情
orderId股票订单 ID。
symbol美股 ticker。
quote计价资产。
sideBUY / SELL。
orderTypeMARKET / LIMIT。
limitPrice限价(USD)。LIMIT 非空,MARKET 为 null。
avgFilledPrice平均成交价(USD)。
qty请求股数。
notional请求名义金额。
filledQty累计成交数量。
filledTotal累计成交名义金额。
fee总手续费(USD)。
session交易时段。
status订单生命周期状态。
createdAt订单创建时间(毫秒时间戳)。
updatedAt最后更新时间(毫秒时间戳)。
此订单的成交明细,最新成交在前。无成交时为空数组。
executionId成交(逐笔)ID。
executionAt成交时间(毫秒时间戳)。
price此笔成交价格(USD)。
qty成交数量。
fee此笔成交手续费(USD)。
成交历史 (USER_DATA)
调用方的分页逐笔成交历史。每行为一笔执行,而非一笔订单——部分成交订单会产生多行。可按 symbol、方向、指定 orderId 和时间段过滤。
成交历史 (USER_DATA) › 授权
请求头
X-MBX-APIKEY访问此接口需要 API Key,并且必须在请求头中携带。关于如何创建 API Key,请参考:https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
startTime开始时间(毫秒时间戳)。
endTime结束时间(毫秒时间戳)。
timestamp时间戳(毫秒)。
symbol美股 ticker 过滤,例如 NVDA。
side方向过滤:BUY / SELL。
orderId将结果限定为单笔订单的成交记录。
current页码,从 1 起,默认 1。
size每页大小,默认 20,最大 100。
recvWindow赋值不能大于 60000。
成交历史 (USER_DATA) › 响应
成交历史
total符合过滤条件的总行数。
page当前页码。
size当前页大小。
本页成交列表,无匹配时为空数组。
executionId逐笔成交 ID。
orderId所属订单 ID。
symbol美股 ticker。
quote计价资产。
sideBUY / SELL。
orderTypeMARKET / LIMIT。
price成交价格(USD)。
qty成交数量。
fee此笔成交手续费(USD)。
total此笔成交名义金额(qty × price)。
executionAt成交时间(毫秒时间戳)。
updatedAt最后更新时间(毫秒时间戳)。