导航
English

待发布内容

资金费率收付逻辑修改

为提供更好的服务，OKX计划调整部分永续合约资金费用收付逻辑，从跨期收取逻辑改成当前周期收取逻辑。

针对一些资金费率波动较大的小币种，OKX也将实时关注行情变化，在必要时候，将资金费率收取频率从8小时收付，改成频率较高的6小时/4小时/2小时/1小时收付。因此，用户应关注fundingTime及nextFundingTime字段以确定合约的资金费收取频率。

此API改动将于12月7日上线模拟盘，并将于12月13日上线实盘。

关于各永续合约更改资金费用收付逻辑的时间点会在其他公告发布。

API侧的改动如下：

参数名 类型 描述
method String 资金费收取逻辑
current_period：当期收
next_period：跨期收
nextFundingRate String 下一期预测资金费率
当收取逻辑为current_period时，nextFundingRate字段将返回""

计息记录接口新增时间范围限制

OKX 计划为计息记录接口新增时间范围限制。调整后，用户仅能通过该接口获取一年内的计息记录。该调整已上线模拟盘，并将于十二月中旬上线实盘。

倒计时全部撤单接口更新

请注意：当倒计时全部撤单被触发时，OKX 交易引擎将代表用户逐一取消其挂单，该操作可能持续数秒。该功能起到保护用户的作用，不应作为交易策略使用。

大宗交易公共成交数据接口迁移

大宗交易公共成交数据接口迁移，新接口目前已于实盘上线，旧接口将于11月30日下线，请尽快实现迁移。

永续及交割合约下单数量精度调整

OKX计划通过调整下单数量精度的方式，降低永续合约和交割合约的最低名义价值。目前，这些合约的最低订单大小和下单数量精度始终为1，数量为整数。OKX将把订单大小和下单数量精度的最低值更改为0.1和0.01（以10的指数为单位），从而有效降低每个订单的最低名义价值，最低订单大小与下单数量精度相同。这意味着订单、交易和仓位的数量将以下单数量精度的倍数返回为小数值。

当OKX更改下单数量精度，更新后的精度将通过WebSocket产品频道和产品REST接口进行通知，类似于其他产品配置的更改。合约的价值将保持不变。例如，BTC-USDT-SWAP合约的合约价值目前为0.01，这意味着每个订单的最低名义价值为0.01 BTC。将最低订单大小和下单数量精度更改为0.1后，每个订单的最低名义价值将变为0.01 BTC x 0.1 = 0.001 BTC。我们也可能会上线新的合约，其下单数量精度为小数。

在模拟盘中，某些合约的最低订单大小和下单数量精度将在12月中进行调整，供客户进行测试。其他合约的最低订单大小和下单数量精度调整将从2024年1月开始。有关更改的合约列表和生效日期将另行公布。

任何即将到来的更新，包括时间安排等等，将通过本文持续更新。

余币宝接口迁移

余币宝接口迁移，新接口实盘已于2023/03/15上线，旧接口将于12月下旬下线，请尽快实现迁移。

2023-11-30

请求参数

参数名 类型 是否必须 描述
uniqueCode String 否 交易员唯一标识码，仅适用于跟单
subPosType String 否 数据的类型
lead: 带单，默认值
copy: 跟单

返回参数

参数名 类型 描述
tpOrdPx String 止盈委托价，市价时为-1
slOrdPx String 止损委托价，市价时为-1
margin String 保证金
upl String 未实现收益
uplRatio String 未实现收益率
markPx String 最新标记价格，仅适用于合约
uniqueCode String 交易员唯一标识代码
ccy String 币种

请求参数

参数名 类型 是否必须 描述
subPosType String 否 数据的类型
lead: 带单，默认值
copy: 跟单

返回参数

参数名 类型 描述
margin String 保证金
ccy String 币种
markPx String 最新标记价格，仅适用于合约
uniqueCode String 交易员唯一标识代码
profitSharingAmt String 跟单分润额，仅适用于跟单
参数名 类型 是否必须 描述
subPosType String 否 数据的类型
lead: 带单，默认值
copy: 跟单
错误码 HTTP 状态码 错误提示
59263 200 独立经纪商需要添加白名单才能使用该功能，请联系 BD 进行处理
59264 200 不支持现货跟单
59267 200 取消失败，跟单关系不存在
59268 200 存在交易员未带单的产品
59269 200 该合约交易员不存在
59270 200 固定金额跟单时，最大跟单金额 (copyTotalAmt) 需要大于等于单笔跟单金额 (copyAmt)
59273 200 您还不是合约跟单用户，请先开始跟单
59275 200 操作失败，您正在申请成为交易员，无法跟单
59276 200 交易员正在退出，当前无法跟单
59277 200 到达跟单人数上限，不允许继续跟单
59278 200 正在处理您的停止跟单请求，请稍后再试
59279 200 您已设置跟单，请勿重复设置
59280 200 跟单关系不存在，请先进行首次设置
59283 200 当前账户不在单币种保证金模式
59130 200 最高止盈比例为 {num}%，请重新输入
59259 200 请输入在有效范围内的跟单比例
59285 200 您尚未进行过带单或跟单操作

2023-11-22


请求参数

参数名 类型 是否必须 描述
type String No regular_update

返回参数

参数名 类型 描述
type String regular_update

regular_update 提供分钟级别的风险准备金余额更新。更新后，amt 字段用于展示 type 为 liquidation_balance_deposit，bankruptcy_loss 或 platform_revenue 时的风险准备金余额差值，数据一天产生一次，每天下午4点左右（UTC 8）更新。当 type 为 regular_update时，amt字段将返回""。


参数 类型 描述
minFundingRate String 下一期的预测资金费率下限
maxFundingRate String 下一期的预测资金费率上限
settState String 资金费率结算状态
processing：结算中
settled：已结算
settFundingRate String 若 settState = processing，该字段代表用于本轮结算的资金费率；若 settState = settled，该字段代表用于上轮结算的资金费率
ts String 数据更新时间，Unix时间戳的毫秒数格式，如 1597026383085

2023-11-18

参数 类型 描述
alias String this_month next_month
不建议使用，用户应通过 expTime 字段获取合约的交割日期


关于新月度交割合约生成及alias字段变更通知


目前，BTC币种的 USDT 和 USD 保证金交割合约与其他币种保证金的交割合约数量不同，支持的到期日不同，合约轮转生成的规则亦有些许差异。正如之前的公告所述，欧易建议用户尽快通过产品接口及频道的expTime字段获取交割合约的交割日期，并停用alias字段。


欧易已于 2023 年 11 月 17 日下午 4:00 (UTC+8) 调整 BTC 币种的 USDT 和 USD 保证金交割合约 到期日规则，由当周、次周、当季、次季四个到期日，调整为当周、次周、当月、次月、当季、次季六个到期日。目前线上合约为：

  1. 当周（this_week）：到期日 2023 年 11 月 24 日的合约
  2. 次周（next_week）：到期日 2023 年 12 月 1 日的合约
  3. 当月（this_month）：到期日 2023 年 12 月 29 日的合约。调整前，为当季合约。若使用alias字段判断到期日，可能会误认为到期日为 2023 年 11 月 24 日。
  4. 次月（next_month）：到期日 2024 年 1 月 26 日的合约。新生成合约。
  5. 当季（quarter）：到期日 2024 年 3 月 29 日的合约。调整前，为次季合约。若使用alias字段判断到期日，可能会误认为到期日为 2023 年 12 月 29 日。
  6. 次季（next_quarter）：到期日 2024 年 6 月 28 日的合约。新生成合约。

调整后，产品接口及频道alias字段新增this_month，next_month枚举值。目前新枚举值仅适用于BTC 币种的 USDT 和 USD 保证金交割合约。将来，欧易可能会调整更多不同币种保证金交割合约到期日规则，请尽快通过产品接口及频道的expTime字段获取交割合约的交割日期，并停用alias字段。


更多详情请见公告

2023-11-16

OKX推出经济日历数据接口，为用户提供全面、最新的宏观经济数据。

该功能已上线实盘，且仅支持在实盘使用。

2023-11-15

参数名 类型 描述
period String 周期类型
hourly：小时
参数名 类型 描述
recurringHour String 小时级别定投的间隔
1/4/8/12
nextInvestTime String 下一次定投发生的时间，Unix时间戳的毫秒数格式，如 1597026383085

2023-11-13

参数名 类型 描述
maxLmtAmt String 限价单的单笔最大USD价值
maxMktAmt String 市价单的单笔最大USD价值
仅适用于币币/币币杠杆
错误码 HTTP 状态码 错误提示
51185 200 单笔订单价值不能超过 {maxOrderValue} USD

2023-11-10

当前仅白名单用户可使用，将于11月中旬开放该功能

参数名 类型 是否必须 描述
tdMode String 否 交易模式
spot_isolated：现货逐仓(仅适用于现货带单)
参数名 类型 描述
spotRoleType String 现货跟单角色。
0：普通用户；1：带单者；2：跟单者
spotTraderInsts String 当前账号已经设置的带单合约，仅适用于带单者
参数名 类型 描述
> spotIsoBal String 现货逐仓余额，仅适用于现货带单/跟单
参数名 类型 是否必须 描述
subType String 否 账单子类型
280: 现货分润支出; 281: 现货分润退还

请求参数

参数名 类型 是否必须 描述
instType String 否 产品类型
SPOT：币币
SWAP：永续合约

返回参数

参数名 类型 描述
instType String 产品类型
SPOT：币币
SWAP：永续合约
错误码 HTTP 状态码 错误提示
51072 200 您当前身份为现货带单员，设置的带单币对买入时，tdMode 需要使用 spot_isolated
51073 200 您当前身份为现货带单员，卖出带单资产需要使用'/copytrading/close-subposition'接口
51074 200 仅现货带单员设置的带单币对支持使用 tdMode：spot_isolated
59260 200 您还不是现货带单交易员，请先在网页端/移动端完成申请
59262 200 您还不是合约带单交易员，请先在网页端/移动端完成申请
59642 200 跟单和带单员只能使用非保证金或单币种保证金模式
59643 200 当前存在现货跟单，暂不可切换

2023-11-08

参数名 类型 描述
fillVol String 成交时的隐含波动率
仅适用于 期权
fwdPx String 成交时的远期价格
仅适用于 期权
idxPx String 成交时的指数价格
适用于 交割, 永续, 期权
markPx String 成交时的标记价格
适用于 交割, 永续, 期权


参数名 类型 描述
fillVol String 成交时的隐含波动率
仅适用于 期权
fwdPx String 成交时的远期价格
仅适用于 期权
idxPx String 成交时的指数价格
适用于 交割, 永续, 期权
markPx String 成交时的标记价格
适用于 交割, 永续, 期权

对于下单和改单，原有附带止盈止损的参数会从文档上隐藏，建议使用新的参数。

参数名 类型 是否必须 描述
attachAlgoOrds Array of object 否 下单附带止盈止损信息
> attachAlgoClOrdId String 否 下单附带止盈止损时，客户自定义的策略订单ID
字母（区分大小写）与数字的组合，可以是纯字母、纯数字且长度要在1-32位之间。
订单完全成交，下止盈止损委托单时，该值会传给algoClOrdId
> tpTriggerPx String 可选 止盈触发价，如果填写此参数，必须填写 止盈委托价
> tpOrdPx String 可选 止盈委托价，如果填写此参数，必须填写 止盈触发价
委托价格为-1时，执行市价止盈
> slTriggerPx String 可选 止损触发价，如果填写此参数，必须填写 止损委托价
> slOrdPx String 可选 止损委托价，如果填写此参数，必须填写 止损触发价
委托价格为-1时，执行市价止损
> tpTriggerPxType String 否 止盈触发价类型
last：最新价格
index：指数价格
mark：标记价格
默认为last
> slTriggerPxType String 否 止损触发价类型
last：最新价格
index：指数价格
mark：标记价格
默认为last
> sz String 可选 数量。仅适用于“多笔止盈”的止盈订单，且对于“多笔止盈”的止盈订单必填
> amendPxOnTriggerType String 否 是否启用开仓价止损，仅适用于分批止盈的止损订单，第一笔止盈触发时，止损触发价格是否移动到开仓均价止损
0. 不开启，默认值
1. 开启“开仓价止损”，且止损触发价不能为空
参数名 类型 是否必须 描述
attachAlgoOrds Array of object 否 下单附带止盈止损信息
> attachAlgoId String 可选 附带止盈止损的订单ID，由系统生成，改单时，可用来标识该笔附带止盈止损订单
> attachAlgoClOrdId String 可选 下单附带止盈止损时，客户自定义的策略订单ID
> newTpTriggerPx String 可选 止盈触发价
如果止盈触发价或者委托价为0，那代表删除止盈。只适用于交割和永续合约。
> newTpOrdPx String 可选 止盈委托价
委托价格为-1时，执行市价止盈。只适用于交割和永续合约。
> newSlTriggerPx String 可选 止损触发价
如果止损触发价或者委托价为0，那代表删除止损。只适用于交割和永续合约。
> newSlOrdPx String 可选 止损委托价
委托价格为-1时，执行市价止损。 只适用于交割和永续合约。
> newTpTriggerPxType String 可选 止盈触发价类型
last：最新价格
index：指数价格
mark：标记价格
只适用于交割/永续
如果要新增止盈，该参数必填
> newSlTriggerPxType String 可选 止损触发价类型
last：最新价格
index：指数价格
mark：标记价格
只适用于交割/永续
如果要新增止损，该参数必填
> sz String 可选 新的张数。仅适用于“多笔止盈”的止盈订单且必填
> amendPxOnTriggerType String 否 是否启用开仓价止损，仅适用于分批止盈的止损订单
0. 不开启，默认值
1. 开启“开仓价止损”
参数名 类型 描述
attachAlgoOrds Array of object 下单附带止盈止损信息
> attachAlgoId String 附带止盈止损的订单ID
> attachAlgoClOrdId String 下单附带止盈止损时，客户自定义的策略订单ID
> tpTriggerPx String 止盈触发价
> tpTriggerPxType String 止盈触发价类型
last：最新价格
index：指数价格
mark：标记价格
> tpOrdPx String 止盈委托价
> slTriggerPx String 止损触发价
> slTriggerPx String 止损触发价类型
last：最新价格
index：指数价格
mark：标记价格
> slOrdPx String 止损委托价
> sz String 张数。仅适用于“多笔止盈”的止盈订单且必填
> amendPxOnTriggerType String 是否启用开仓价止损，仅适用于分批止盈的止损订单
0. 不开启，默认值
1. 开启“开仓价止损”
参数名 类型 描述
amendPxOnTriggerType String 是否启用开仓价止损，仅适用于分批止盈的止损订单
0. 不开启，默认值
1. 开启“开仓价止损”
错误码 HTTP 状态码 错误提示
51076 200 分批止盈的每笔止盈止损订单仅支持单向止盈止损，slTriggerPx&slOrdPx 与 tpTriggerPx&tpOrdPx 只能填写一组
51077 200 币币/杠杆不支持开启'开仓价止损'
51078 200 您当前身份为带单交易员，不支持分批止盈
51079 200 同一笔订单上附带分批止盈的止盈委托单不能超过 {param0} 笔
51080 200 同一笔订单上附带分批止盈的止盈触发价类型 (tpTriggerPxType) 必须保持一致
51081 200 同一笔订单上附带分批止盈的止盈触发价 (tpTriggerPx) 不能相等
51082 200 同一笔订单上附带分批止盈的止盈委托价 (tpOrdPx) 只能是市价
51083 200 同一笔订单上附带分批止盈的止盈数量之和需要等于订单的委托数量
51084 200 同一笔订单上附带分批止盈的止损委托单不能超过 {param0} 笔
51085 200 附带止盈止损开启'开仓价止损'时 (amendPxOnTriggerType 设置为 1)，该笔订单上的止盈委托单必须大于等于 2 笔
51086 200 同一笔订单上附带止盈止损委托单不能超过 {param0} 笔
51538 200 若下单时使用了 attachAlgoOrds 参数，也需要使用 attachAlgoOrds 参数改单；若下单时没有使用 attachAlgoOrds 参数，则不支持使用 attachAlgoOrds 参数改单。
51539 200 修改同一笔订单上分批止盈中的止盈止损订单时，attachAlgoId 或者 attachAlgoClOrdId 的值不能重复
51527 200 改单失败，其中至少有一个附带的止盈止损订单不存在
51089 200 在附带分批止盈时，止盈订单的数量不能为空

2023-11-07

价差交易支持立即成交并取消剩余（ioc）订单

参数名 类型 是否必须 描述
ordType String 否 ioc：立即成交并取消剩余
参数名 类型 描述
ordType String ioc：立即成交并取消剩余
参数名 类型 描述
cancelSource String 14: 已撤单：IOC 委托订单未完全成交，仅部分成交，导致部分挂单被撤回

2023-11-02

参数名 类型 描述
clTReqId String 用户自定义的订单标识

2023-11-01

参数名 类型 描述
flowType String 识别询价单的类型。
仅适用于报价方，返回""给询价方。
参数名 类型 描述
> enable Boolean 子账户状态
true：正常使用
false：冻结
> frozenFunc Array of string 被冻结的功能
trading：交易
convert：闪兑
transfer：母子账户间资金划转
withdrawal：提币
deposit：充值
flexible_loan：活期借贷
> canTransOut String 是否可以主动转出（通过子账户APIKey直接转到另一个子账户下）
true：可以转出
false：不可转出
参数名 类型 描述
frozenFunc Array of string 被冻结的功能
trading：交易
convert：闪兑
transfer：母子账户间资金划转
withdrawal：提币
deposit：充值
flexible_loan：活期借贷
参数名 类型 是否必须 描述
connId String 是 WebSocket 连接ID

2023-10-31

2023-10-27

为优化用户交易体验、提升市场流动性，欧易已于 2023 年10 月 27 日 15:00 - 17:00 (UTC+8) 调整手续费规则，
同时，“获取当前账户交易手续费费率”接口的返回字段会受到影响，将做如下调整：

注意：
1. 仅币币和杠杆的返回字段会受到影响，交割、永续和期权的返回字段不受影响。
2. 对于币币和杠杆，USDⓈ&Crypto 交易区的币对费率，由 taker/maker 字段返回，改为由 takerUSDC/makerUSDC 字段返回。

调整前：

参数名 类型 描述
taker String 对于币币/杠杆，为 USDT&USDⓈ&Crypto 交易区的吃单手续费率；
对于永续，交割和期权合约，为币本位合约费率
maker String 对于币币/杠杆，为 USDT&USDⓈ&Crypto 交易区的挂单手续费率；
对于永续，交割和期权合约，为币本位合约费率
takerUSDC String USDC 交易区的吃单手续费率，包括 USDC 现货和 USDC 合约
makerUSDC String USDC 交易区的挂单手续费率，包括 USDC 现货和 USDC 合约

调整后：

参数名 类型 描述
taker String 对于币币/杠杆，为 USDT 交易区的吃单手续费率；
对于永续，交割和期权合约，为币本位合约费率
maker String 对于币币/杠杆，为 USDT 交易区挂单手续费率；
对于永续，交割和期权合约，为币本位合约费率
takerUSDC String 对于币币/杠杆，为 USDⓈ&Crypto 交易区的吃单手续费率；
对于永续和交割合约，为 USDC 合约费率
makerUSDC String 对于币币/杠杆，为 USDⓈ&Crypto 交易区的挂单手续费率；
对于永续和交割合约，为 USDC 合约费率
fiat Array 法币费率
> ccy String 法币币种
> taker String 吃单手续费率
> maker String 挂单手续费率

调整前：

参数名 类型 是否必须 描述
quoteCcyType String 否 计价币类型
2：USDT/USDⓈ/Crypto
3：USDC
适用于币币
当指定该参数时，instType必传

调整后：

参数名 类型 是否必须 描述
quoteCcyType String 否 计价币类型
2：USDT
3：USDⓈ/Crypto
适用于币币
当指定该参数时，instType必传

2023-10-24

2023-10-19

2023-10-18

参数名 类型 描述
beginTime String 返佣明细的开始时间，Unix时间戳的毫秒数格式 ，如 1597026383085
endTime String 返佣明细的结束时间，Unix时间戳的毫秒数格式 ，如 1597026383085
cTime String 发起生成下载链接请求的时间，Unix时间戳的毫秒数格式 ，如 1597026383085
参数名 类型 是否必须 描述
clientIP String 否 子账户注册时的IP
非个人账户请使用ND服务端IP
参数名 类型 描述
> cancelSource String 33: 当前 taker 订单匹配的订单数量超过最大限制
错误码 HTTP 状态码 错误提示
51088 200 对于同一个仓位，仅支持一笔全部平仓的止盈止损挂单
参数名 类型 描述
bePx String 盈亏平衡价

2023-09-29

参数名 类型 是否必须 描述
opType String 否 将要下单的类型
open: 开仓时将sz舍位
close: 平仓时将sz四舍五入
默认值为close
适用于交割 永续

2023-09-28

为保障交易系统性能，为用户提供更好的交易体验，OKX现调整交易限制，限制每笔taker订单匹配的maker订单数量不得超过1000笔。


当taker订单匹配的maker订单数量超过最大限制1000笔时，taker订单将被取消：

  1. 限价单仅成交与1000笔maker订单相对应的部分，并取消剩余；
  2. 全部成交或立即取消（FOK）订单将直接被取消。

2023-09-27

调整前

参数名 类型 描述
> amendResult String 修改订单的结果
-1： 失败
0：成功
1：自动撤单（因为修改成功导致订单自动撤销）
通过API修改订单时，如果cxlOnFail设置为false且修改失败后，则amendResult返回 -1
通过API修改订单时，如果cxlOnFail设置为true且修改失败后，则amendResult返回1
通过Web/APP修改订单时，如果修改失败后，则amendResult返回-1

调整后

参数名 类型 描述
> amendResult String 修改订单的结果
-1： 失败
0：成功
1：自动撤单（因为修改成功导致订单自动撤销）
2: 自动改单成功，仅适用于期权pxUsd和pxVol订单的自动改单
通过API修改订单时，如果cxlOnFail设置为false且修改失败后，则amendResult返回 -1
通过API修改订单时，如果cxlOnFail设置为true且修改失败后，则amendResult返回1
通过Web/APP修改订单时，如果修改失败后，则amendResult返回-1

2023-09-20

参数名 类型 描述
inTime String WebSocket / REST网关接收请求时的时间戳，Unix时间戳的微秒数格式，如 1597026383085123
REST接口返回的时间是请求验证后的时间。
outTime String WebSocket / REST网关发送响应时的时间戳，Unix时间戳的微秒数格式，如 1597026383085123
参数名 类型 描述
interest String 利息
tag String 订单标签
字母（区分大小写）与数字的组合，可以是纯字母、纯数字，且长度在1-16位之间。
fillTime String 最新成交时间
tradeId String 最新成交ID
clOrdId String 客户自定义订单ID
fillIdxPx String 交易执行时的指数价格
对于交叉现货币对，返回 baseCcy-USDT 的指数价格。 例如LTC-ETH，该字段返回LTC-USDT的指数价格。
fillMarkPx String 成交时的标记价格，仅适用于 交割/永续/期权
fillPxVol String 成交时的隐含波动率，仅适用于期权，其他业务线返回空字符串""
fillPxUsd String 成交时的期权价格，以USD为单位，仅适用于期权，其他业务线返回空字符串""
fillMarkVol String 成交时的标记波动率，仅适用于期权，其他业务线返回空字符串""
fillFwdPx String 成交时的远期价格，仅适用于期权，其他业务线返回空字符串""
参数名 类型 描述
data Array 订阅的数据
> trades Array 成交信息
>> instId String 产品ID，如 BTC-USDT
>> tradeId String 最新成交ID
参数名 类型 描述
attachAlgoOrds Array of object 附带止盈止损信息
适用于单币种保证金模式/跨币种保证金模式/组合保证金模式
> attachAlgoClOrdId String 下单附带止盈止损时，客户自定义的策略订单ID，字母（区分大小写）与数字的组合，可以是纯字母、纯数字且长度要在1-32位之间。
订单完全成交，下止盈止损委托单时，该值会传给algoClOrdId。
> tpTriggerPx String 止盈触发价，如果填写此参数，必须填写止盈委托价
> tpTriggerPxType String 止盈触发价类型
last：最新价格
index：指数价格
mark：标记价格
默认为last
> tpOrdPx String 止盈委托价，如果填写此参数，必须填写止盈触发价
委托价格为-1时，执行市价止盈
> slTriggerPx String 止损触发价，如果填写此参数，必须填写止损委托价
> slTriggerPxType String 止损触发价类型
last：最新价格
index：指数价格
mark：标记价格
默认为last
> slOrdPx String 止损委托价，如果填写此参数，必须填写止损触发价
委托价格为-1时，执行市价止损
参数名 类型 描述
reduceOnly Boolean 是否只减仓，true 或 false
参数名 类型 描述
source String 订单来源
6：计划委托策略触发后的生成的普通单
7：止盈止损策略触发后的生成的普通单
24：移动止盈止损策略触发后的生成的普通单
错误码 HTTP 状态码 错误提示
51333 200 开平模式下的平仓单或买卖模式下的只减仓单无法附带止盈止损

2023-09-13

参数名 类型 是否必须 描述
tag String 否 订单标签
字母（区分大小写）与数字的组合，可以是纯字母、纯数字，且长度在1-16位之间。
参数名 类型 是否必须 描述
after String 否 请求此id之前（更旧的数据）的分页内容，传的值为对应接口的subPosId
before String 否 请求此id之后（更新的数据）的分页内容，传的值为对应接口的subPosId
limit String 否 分页返回的结果集数量，最大为500，不填默认返回500条

2023-09-08

对于下单接口：

调整前：

参数名 类型 是否必须 描述
px String 可选 委托价格，仅适用于limit、post_only、fok、ioc类型的订单

调整后：

参数名 类型 是否必须 描述
px String 可选 委托价格，仅适用于limit、post_only、fok、ioc类型的订单，期权下单时，px/pxUsd/pxVol 只能填一个

新增请求参数

参数名 类型 是否必须 描述
pxUsd String 可选 以USD价格进行期权下单
仅适用于期权
期权下单时 px/pxUsd/pxVol 必填一个，且只能填一个
pxVol String 可选 以隐含波动率进行期权下单，例如 1 代表 100%
仅适用于期权
期权下单时 px/pxUsd/pxVol 必填一个，且只能填一个

对于改单接口：

调整前：

参数名 类型 是否必须 描述
newPx String 可选 修改的新价格

调整后：

参数名 类型 是否必须 描述
newPx String 可选 修改的新价格期权改单时，newPx/newPxUsd/newPxVol 只能填一个，且必须与下单参数保持一致，如下单用px，改单时需使用newPx

新增请求参数

参数名 类型 是否必须 描述
newPxUsd String 可选 以USD价格进行期权改单
仅适用于期权，期权改单时，newPx/newPxUsd/newPxVol 只能填一个
newPxVol String 可选 以隐含波动率进行期权改单，例如 1 代表 100%
仅适用于期权，期权改单时，newPx/newPxUsd/newPxVol 只能填一个

2023-08-31

新增交易限制


为保障交易系统性能，为用户提供更好的交易体验，OKX现新增交易限制，限制每笔taker订单匹配的maker订单数量不得超过256笔。


当taker订单匹配的maker订单数量超过最大限制256笔时，taker订单将被取消：

  1. 限价单仅成交与256笔maker订单相对应的部分，并取消剩余；
  2. 全部成交或立即取消（FOK）订单将直接被取消。


当用户因此被撤单时，可以通过如下接口查询到 cancelSource = "0" 及 cancelSourceReason = "系统撤单"：


亦能够通过如下的WebSocket频道接收到cancelSource = "0"：


未来，为适应更多因提升交易系统性能而导致撤单的场景，该原因导致的撤单对应的cancelSource及cancelSourceReason可能会发生修改：

2023-08-30

对于订单信息、未成交订单列表、订单记录接口：

调整前：

参数名 类型 描述
px String 委托价格

调整后：

参数名 类型 描述
px String 委托价格，对于期权，以币(如BTC, ETH)为单位

新增返回参数

参数名 类型 描述
pxUsd String 期权价格，以USD为单位
仅适用于期权，其他业务线返回空字符串""
pxVol String 期权订单的隐含波动率
仅适用于期权，其他业务线返回空字符串""
pxType String 期权的价格类型
px：代表按价格下单，单位为币 (请求参数 px 的数值单位是BTC或ETH)
pxVol：代表按pxVol下单
pxUsd：代表按照pxUsd下单，单位为USD (请求参数px 的数值单位是USD)

参数amendSource新增枚举值

参数名 类型 描述
> amendSource String 订单修改的来源
1: 用户主动改单，改单成功
2: 用户主动改单，并且当前这笔订单被只减仓修改，改单成功
3: 用户主动下单，并且当前这笔订单被只减仓修改，改单成功
4: 用户当前已存在的挂单（非当前操作的订单），被只减仓修改，改单成功
5. 期权 px, pxVol 或 pxUsd 的跟随变动导致的改单，比如 iv=60，usd，px 锚定iv=60 时，usd, px 产生变动时的改单

对于成交明细接口及订单频道：

参数名 类型 描述
fillPxVol String 成交时的隐含波动率，仅适用于期权，其他业务线返回空字符串""
fillPxUsd String 成交时的期权价格，以USD为单位，仅适用于期权，其他业务线返回空字符串""
fillMarkVol String 成交时的标记波动率，仅适用于期权，其他业务线返回空字符串""
fillFwdPx String 成交时的远期价格，仅适用于期权，其他业务线返回空字符串""
fillMarkPx String 成交时的标记价格，仅适用于 交割/永续/期权

新增错误码

错误码 HTTP 状态码 错误提示
51175 200 参数 {param0}、{param1} 和 {param2} 不能同时为空
51176 200 参数 {param0}、{param1} 和 {param2} 只能填写一个
51177 200 当前期权订单的价格类型为{param0}，不支持修改{param1}
51179 200 简单交易模式下，不支持使用{param0}进行期权下单。
51180 200 {param0}的范围应为({param1}, {param2})
51181 200 使用{param0}下单，ordType 只能为限价单 (limit)
51182 200 当前账户期权价格类型 pxUsd 和 pxVol 的挂单数量之和，不能超过 {param0} 个
51536 200 期权的 pxVol 或者 pxUsd 订单不支持修改订单数量
51537 200 非期权产品不支持使用 pxUsd 或者 pxVol
参数名 类型 描述
realizedPnl String 已实现收益
pnl String 平仓订单累计收益额
fee String 累计手续费金额，正数代表平台返佣 ，负数代表平台扣除
fundingFee String 累计资金费用
liqPenalty String 累计爆仓罚金，有值时为负数。
参数名 类型 描述
realizedPnl String 已实现收益
fee String 累计手续费金额，正数代表平台返佣 ，负数代表平台扣除
fundingFee String 累计资金费用
liqPenalty String 累计爆仓罚金，有值时为负数。

调整前：

参数名 类型 是否必须 描述
timeOut String 是 取消 MMP 挂单的倒计时，单位为秒。
取值范围为 0, [5, 120]
0 代表不使用该功能。

调整后：

参数名 类型 是否必须 描述
timeOut String 是 取消 MMP 挂单的倒计时，单位为秒。
取值范围为 0, [10, 120]。
0 代表不使用该功能。

2023-08-23

请求参数

参数名 类型 是否必须 描述
beginTime String 否 查询起始时间
Unix时间戳的毫秒数格式，如 1597026383085，查询在 1597026383085（包含）后的记录
endTime String 否 查询结束时间
Unix时间戳的毫秒数格式，如 1597026383085，查询在 1597026383085（不包含）前的记录

返回参数

参数名 类型 描述
> rebateTime String 子账户返佣时间，Unix时间戳的毫秒数格式，如 1597026383085

返回结果按照时间倒序排列

2023-08-22

参数名 类型 是否必须 描述
rcvrInfo String 可选 接收方信息
特定 国家/地区 认证用户做链上提币需要提供此信息
> walletType String 是 钱包类型
exchange：提币到交易所钱包
private：提币到私人钱包
如果提币到交易所钱包，必须提供exchId,rcvrFirstName,rcvrLastName
提币到私人钱包，则不需要提供其他信息
> exchId String 可选 交易所 ID
可以通过 获取交易所列表（公共） 接口查询支持的交易所
如果交易所不在支持的交易所列表中，该字段填0
> rcvrFirstName String 可选 接收方名字，如 Bruce
> rcvrLastName String 可选 接收方姓氏，如 Wayne
错误码 HTTP 状态码 错误提示
58237 200 根据当地法律法规，请提供准确的接收方信息 (rcvrInfo)。对于交易所地址，请一并提供交易所信息和接收人的身份信息。
58238 200 提币到交易所地址需提供完整的接收方信息，包括交易所信息和接收人的身份信息。

2023-08-16

参数名 类型 描述
> borrowFroz String 账户美金层面潜在借币占用保证金
仅适用于跨币种保证金模式和组合保证金模式. 在其他账户模式下为"".
>> borrowFroz String 币种美金层面潜在借币占用保证金
仅适用于跨币种保证金模式和组合保证金模式. 在其他账户模式下为"".

调整前：

参数名 类型 描述
> expTime String 交割日期，仅适用于 交割/期权

调整后：

参数名 类型 描述
> expTime String 产品下线时间
适用于币币/杠杆/交割/永续/期权，对于 交割/期权，为交割/行权日期；亦可以为产品下线时间，有变动就会推送。
参数名 类型 是否必须 描述
px String 否 对应平仓价格下的可用数量，默认为市价。
仅适用于杠杆只减仓

调整前：

参数名 类型 描述
availPos String 可平仓数量，适用于 币币杠杆,交割/永续（开平仓模式），期权

调整后：

参数名 类型 描述
availPos String 可平仓数量，适用于 币币杠杆,交割/永续（开平仓模式），期权
对于杠杆仓位，平仓时，杠杆还清负债后，余下的部分会视为币币交易，如果想要减少币币交易的数量，可通过"获取最大可用数量"接口获取只减仓的可用数量。
错误码 HTTP 状态码 错误提示
51400 200 由于订单已完成、已撤销或不存在，撤单失败
51503 200 由于订单已完成、已撤销或不存在，改单失败

2023-08-14

交易产品挂单数量限制调整

调整后，单个交易产品最多支持 500 笔挂单。例如，永续合约 BTC-USDT-SWAP、交割合约 BTC-USDT-230707、现货 BTC-USDT 分别最多支持 500 笔挂单。

单个账户的最大挂单数量仍为 4000 笔不变。现有的期权交易规则不变。新挂单限制不会影响用户现有的超额挂单，但必须待超额挂单被成交或取消，且挂单数量少于限制后，用户才能继续下单同一交易产品。

被计入到 500 笔挂单数量限制的订单类型包括：



新增错误码51174

错误码 HTTP 状态码 错误提示
51174 200 操作失败，当前 {param0} 的累计挂单数量已达上限 {param1} (单)

2023-08-02

参数名 类型 描述
> surplusLmtDetails Array 母子账户剩余可借额度详情，母子账户剩余可借额度的值取该数组中的最小值，可以用来判断是什么原因导致可借额度不足
仅适用于尊享借币
>> allAcctRemainingQuota String 母子账户剩余额度
>> curAcctRemainingQuota String 当前子账户剩余额度
仅适用于为子账户分配限额的场景
>> platRemainingQuota String 平台剩余额度，当平台剩余额度大于curAcctRemainingQuota或者allAcctRemainingQuota时，会显示大于某个值，如">1000"

2023-07-26

调整前

参数名 类型 描述
type String 账户无法Broker返佣的原因
2：用户手续费等级是VIP3或以上

调整后

参数名 类型 描述
type String 账户无法Broker返佣的原因
2：手续费等级为VIP4/5且月返佣金额达到上限
3：手续费等级大于等于VIP6
clientRebateRatio String 交易用户可获取返佣比例

2023-07-20

参数名 类型 描述
totIncomeCat Object 所有子账户返佣金额分类统计
> spot String 所有子账户 现货 总返佣金额，单位为USDT
> derivative String 所有子账户 衍生品 总返佣金额，单位为USDT
> convert String 所有子账户 闪兑 总返佣金额，单位为USDT
details Array 子账户返佣记录列表
> incomeCat Object 当前子账户返佣金额分类统计
>> spot String 当前子账户 现货 返佣金额，单位为USDT
>> derivative String 当前子账户 衍生品 返佣金额，单位为USDT
>> convert String 当前子账户 闪兑 返佣金额，单位为USDT
> netFee String 当前子账户净手续费，单位USDT
> netFeeCat Object 当前子账户净手续费分类统计
>> spot String 当前子账户 现货 净手续费汇总，单位为USDT
>> derivative String 当前子账户 衍生品 净手续费汇总，单位为USDT
> markupFee String 当前子账户加点后手续费，单位USDT
> markupFeeCat Object 当前子账户加点后手续费分类统计
>> spot String 当前子账户 现货 加点后手续费，单位为USDT
>> derivative String 当前子账户 衍生品 加点后手续费，单位为USDT
>> convert String 当前子账户 闪兑 加点后手续费，单位为USDT
参数名 描述
netFee 净手续费 (去除返佣卡、对手方等数据后进行返佣结算的手续费基数)，单位为USDT
settlementFee 结算手续费 (去除节点返佣、返佣卡等，Broker进行结算前的手续费基数)，单位为USDT
参数名 描述
rebateCat 返佣类别
spot：现货
derivative：衍生品
convert：闪兑
netFee 净手续费（去除返佣卡、对手方等数据后进行返佣结算的手续费基数），单位为USDT
markupFee 加点手续费，单位为USDT

2023-07-19

参数名 类型 描述
profitSharingRatio String 分润比例
取值范围[0,0.3]
如果是普通订单（既不是带单也不是跟单），该字段返回""
copyType String 分润订单类型
0：普通订单
1：普通跟单
2：分润跟单
3：带单
参数名 类型 描述
px String 价格，与 subType 相关。
为成交价格时有 1: 买入 2: 卖出 3：开多 4：开空 5：平多 6：平空 204: 大宗交易买 205: 大宗交易卖 206: 大宗交易开多 207: 大宗交易开空 208: 大宗交易平多 209: 大宗交易平空 114：自动换币买入 115：自动换币卖出
强平价格，100：强减平多 101：强减平空 102：强减买入 103：强减卖出 104：强平平多 105：强平平空 106：强平买入 107：强平卖出 16：强制还币 17：强制借币还息 110：强平换币转入 111：强平换币转出
交割价格，112：交割平多 113：交割平空
行权价格，170：到期行权 171：到期被行权 172：到期作废
标记价格，173：资金费支出 174：资金费收入
参数 类型 描述
volLv String 价平期权的隐含波动率
参数 类型 描述
ordType String mmp_and_post_only：做市商保护且只做maker单(仅适用于组合保证金账户模式下的期权订单)

2023-07-17

参数名 类型 描述
uid String 子账户UID
参数名 类型 是否必须 描述
cxlOnClosePos Boolean 否 决定用户所下的止盈止损订单是否与该交易产品对应的仓位关联。若关联，仓位被撤销时，该止盈止损订单会被同时撤销；若不关联，仓位被撤销时，该止盈止损订单不受影响。

有效值：
true：下单与仓位关联的止盈止损订单
false：下单与仓位不关联的止盈止损订单

默认值为false。若传入true，用户必须同时传入 reduceOnly = true，说明当下单与仓位关联的止盈止损订单时，必须为只减仓。

适用于单币种保证金模式、跨币种保证金模式。

2023-07-07

参数 类型 描述
ordType String mmp_and_post_only：做市商保护且只做maker单(仅适用于组合保证金账户模式下的期权订单)

2023-07-05

参数名 类型 是否必须 描述
type String 否 账单类型
24: 价差交易
subType String 否 账单子类型
270: 价差交易买; 271: 价差交易卖; 272: 价差交易开多; 273: 价差交易开空; 274: 价差交易平多; 275: 价差交易平空
参数名 类型 描述
fillPnl String 最新成交收益，适用于有成交的平仓订单。其他情况均为0。
参数名 类型 描述
> fillPnl String 最新成交收益，适用于有成交的平仓订单。其他情况均为0。
参数名 类型 是否必须 描述
> extraParams String 否 额外配置
>> updateInterval int 否 0: 仅根据事件推送数据
若不添加该字段或将其设置为除0外的其他值，数据将根据事件推送并定时推送。
使用该字段需严格遵守以下格式。
"extraParams": "
{
\"updateInterval\": \"0\"
}
"

2023-06-28

参数 类型 描述
ordType String mmp：做市商保护(仅适用于组合保证金账户模式下的期权订单)
参数 类型 描述
state String mmp_canceled：做市商保护机制导致的自动撤单

2023-06-27

参数 类型 描述
minFeeForCtAddr String 合约地址最小提币手续费数量
maxFeeForCtAddr String 合约地址最大提币手续费数量

2022-06-26

错误码 HTTP 状态码 错误提示
75001 200 交易 ID 不存在
75002 200 {sprdId} : 目前不接受新订单
75003 200 价格无效

2023-06-20

参数 类型 描述
> prevSeqId Integer 上一个推送的序列号。仅适用 books，books-l2-tbt，books50-l2-tbt
> seqId Integer 推送的序列号

调整前：

参数名 类型 是否必须 描述
closeFraction String 可选 策略委托触发时，平仓的百分比。1 代表100%
现在系统只支持全部平仓，唯一接受参数为1
对于同一个仓位，仅支持一笔全部平仓的止盈止损挂单

仅适用于交割或永续
仅适用于买卖模式 posSide = net
仅适用于减仓订单 reduceOnly = true
仅适用于止盈止损 ordType = conditional 或 oco
仅适用于止盈止损市价订单
不支持组合保证金模式
sz和closeFraction必填且只能填其一

调整后：

参数名 类型 是否必须 描述
closeFraction String 可选 策略委托触发时，平仓的百分比。1 代表100%
现在系统只支持全部平仓，唯一接受参数为1
对于同一个仓位，仅支持一笔全部平仓的止盈止损挂单

仅适用于交割或永续
当posSide = net时，reduceOnly必须为true
仅适用于止盈止损 ordType = conditional 或 oco
仅适用于止盈止损市价订单
不支持组合保证金模式
sz和closeFraction必填且只能填其一

调整前：

参数名 类型 是否必须 描述
ip String 可选 绑定ip地址，多个ip用半角逗号隔开，最多支持20个ip
如果子账户APIKey拥有 交易/提币 权限，必须绑定IP地址

调整后：

参数名 类型 是否必须 描述
ip String 否 绑定ip地址，多个ip用半角逗号隔开，最多支持20个ip

调整前：

参数名 类型 是否必须 描述
ip String 否 绑定ip地址，多个ip用半角逗号隔开，最多支持20个ip
如果填写该字段，则该字段会被重置
如果子账户APIKey拥有 交易/提币 权限，必须绑定IP地址

调整后：

参数名 类型 是否必须 描述
ip String 否 绑定ip地址，多个ip用半角逗号隔开，最多支持20个ip
如果填写该字段，则该字段会被重置
参数名 类型 是否必须 描述
uid String 否 子账户UID
参数名 类型 是否必须 描述
attachAlgoClOrdId String 否 下单附带止盈止损时，客户自定义的策略订单ID
字母（区分大小写）与数字的组合，可以是纯字母、纯数字且长度要在1-32位之间。
订单完全成交，下止盈止损委托单时，该值会传给algoClOrdId
参数 类型 描述
attachAlgoClOrdId String 下单附带止盈止损时，客户自定义的策略订单ID

调整前：

参数名 类型 描述
ordId String 订单ID
state String 订单状态 ，live：待生效 pause：暂停生效 partially_effective:部分生效

调整后：

参数名 类型 描述
ordId String 最新一笔订单ID
state String 订单状态 ，live：待生效 pause：暂停生效 partially_effective:部分生效 partially_failed：部分委托失败
ordIdList String 订单ID列表，当止盈止损存在市价拆单时，会有多个。

2023-06-19

2023-06-15

2023-06-07

参数 类型 是否必须 描述
stpId String 否 自成交保护ID。来自同一个母账户配着同一个ID的订单不能自成交
用户自定义1<=x<=999999999的整数
stpMode String 否 自成交保护模式
预设 cancel maker
cancel_maker,cancel_taker, cancel_both
Cancel both不支持FOK
参数 类型 描述
stpId String 自成交保护ID
如果自成交保护不适用则返回""
stpMode String 自成交保护模式
如果自成交保护不适用则返回""
cancelSource String 32: 自成交保护

调整前：

参数名 类型 描述
indexPx String 成交时的指数价格

调整后：

参数名 类型 描述
idxPx String 成交时的指数价格
参数名 类型 描述
fillIdxPx String 交易执行时的指数价格
对于交叉现货币对，返回 baseCcy-USDT 的指数价格。 例如LTC-ETH，该字段返回LTC-USDT的指数价格。
参数名 类型 描述
idxPx String 最新指数价格
参数名 类型 描述
kycLv String 母账户KYC等级
0: 未认证 1: 已完成 level 1 认证, 2: 已完成 level 2 认证, 3: 已完成 level 3认证.
如果请求来自子账户, kycLv 为其母账户的等级.
如果请求来自母账户, kycLv 为当前请求的母账户等级.

子账户

2023-06-02

调整前：

参数名 类型 描述
indexPx String 成交时的指数价格

调整后：

参数名 类型 描述
idxPx String 成交时的指数价格

2023-05-29

Parameter Type Description
state String 报价单的状态
有效值为 active pending_fill canceled filled expired or failed.

2023-05-24

参数名 类型 描述
mainUid String 当前请求的母账户ID
如果 uid = mainUid，代表当前账号为母账户；如果 uid != mainUid，代表当前账户为子账户。
perm String 当前请求的 API key权限
read_only：读取
trade：交易
withdraw：提币
参数名 类型 描述
algoClOrdId String 用户自定义策略ID
tag String 订单标签
参数名 类型 描述
algoClOrdId String 用户自定义策略ID

2023-05-10

参数名 类型 描述
> uid String 子账户ID

2023-04-27

参数名 类型 是否必须 描述
newTpTriggerPx String 可选 止盈触发价
如果止盈触发价或者委托价为0，那代表删除止盈
newTpOrdPx String 可选 止盈委托价
委托价格为-1时，执行市价止盈
newSlTriggerPx String 可选 止损触发价
如果止损触发价或者委托价为0，那代表删除止损
newSlOrdPx String 可选 止损委托价
委托价格为-1时，执行市价止损
newTpTriggerPxType String 可选 止盈触发价类型
last：最新价格
index：指数价格
mark：标记价格
newSlTriggerPxType String 可选 止损触发价类型
last：最新价格
index：指数价格
mark：标记价格
参数名 类型 描述
> reqId String 修改订单时使用的request ID，如果没有修改，该字段为""
> amendResult String 修改订单的结果
-1： 失败
0：成功
参数名 类型 是否必须 描述
> tdMode String 否 交易模式
保证金模式：cross全仓 isolated逐仓
非保证金模式：cash非保证金.
如未提供，tdMode 将继承系统设置的默认值：
单币种保证金模式 & 现货: cash
单币种保证金和多币种保证金模式下买入期权： isolated
其他情况: cross
> ccy String 否 保证金币种，仅适用于单币种保证金模式下的全仓杠杆订单
在其他情况下该参数将被忽略。
参数名 类型 描述
>> tdMode String 交易模式
保证金模式：cross全仓 isolated逐仓
非保证金模式：cash非保证金.
如未提供，tdMode 将继承系统设置的默认值：
单币种保证金模式 & 现货: cash
单币种保证金和多币种保证金模式下买入期权： isolated
其他情况: cross
>> ccy String 保证金币种，仅适用于单币种保证金模式下的全仓杠杆订单
在其他情况下该参数将被忽略。

2023-04-26

调整前：

参数名 类型 是否必须 描述
mgnType String 否 保证金类型
1：USDT本位
2：币本位
适用于交割/永续

调整后：

参数名 类型 是否必须 描述
quoteCcyType String 否 计价币类型
2：USDT/USDⓈ/Crypto
3：USDC
适用于币币
当指定该参数时，instType必传
mgnType String 否 保证金类型
1：USDT本位
2：币本位
3：USDC本位
适用于交割/永续
当指定该参数时，instType必传

调整前：

参数名 类型 描述
> loanQuota String 母账户维度借币限额
> surplusLmt String 母子账户剩余可借
> usedLmt String 母子账户已借额度

调整后：

参数名 类型 描述
loanAlloc String 当前交易账户尊享借币可用额度的比率（百分比）
1. 范围为[0, 100]. 精度为 0.01% (2位小数)
2. 0 代表母账户没有为子账户分配；
3. "" 代表母子账户共享
> loanQuota String 母账户维度借币限额
如果已配置可用额度，该字段代表当前交易账户的借币限额
> surplusLmt String 母子账户剩余可借
如果已配置可用额度，该字段代表当前交易账户的剩余可借
> usedLmt String 母子账户已借额度
如果已配置可用额度，该字段代表当前交易账户的已借额度
参数名 类型 描述
uplLastPx String 以最新成交价格计算的未实现收益，主要做展示使用，实际值还是 upl
uplRatioLastPx String 以最新成交价格计算的未实现收益率

2023-04-19

2023-04-10

2023-04-07

2023-04-06

参数名 类型 描述
> cancelSource String 订单取消的来源
31: 当前只挂单订单 (Post only) 将会吃掉挂单深度
> amendSource String 订单修改的来源
1: 用户主动改单，改单成功
2: 用户主动改单，并且当前这笔订单被只减仓修改，改单成功
3: 用户主动下单，并且当前这笔订单被只减仓修改，改单成功
4: 用户当前已存在的挂单（非当前操作的订单），被只减仓修改，改单成功

2023-04-03

参数名 类型 描述
maintType String 维护类型。
1：计划维护；2：临时维护；3：系统故障
env String 环境。
1：实盘，2：模拟盘

2023-03-30

调整前：

参数名 类型 描述
volUsd String 24小时平台总成交量，以美元为单位
volCny String 24小时平台总成交量，以人民币为单位
blockVolUsd String 24小时平台场外交易总量，以美元为单位
blockVolCny String 24小时平台场外交易总量，以人民币为单位

调整后：

参数名 类型 描述
volUsd String 订单簿交易近24小时总成交量，以美元为单位
volCny String 订单簿交易近24小时总成交量，以人民币为单位

2023-03-29

2023-03-27

调整前：

参数名 类型 描述
volUsd String 24小时平台总成交量，以美元为单位
volCny String 24小时平台总成交量，以人民币为单位
blockVolUsd String 24小时平台场外交易总量，以美元为单位
blockVolCny String 24小时平台场外交易总量，以人民币为单位

调整后：

参数名 类型 描述
volUsd String 订单簿交易近24小时总成交量，以美元为单位
volCny String 订单簿交易近24小时总成交量，以人民币为单位

2023-03-24

2023-03-16

2023-03-15

2023-03-14

2023-03-01

参数名 类型 描述
failCode String 代表策略触发失败的原因，已撤销和已生效时为""，委托失败时有值，如 51008；
仅适用于单向止盈止损委托、双向止盈止损委托、移动止盈止损委托、计划委托。
algoClOrdId String 客户自定义策略订单ID


调整请求参数

调整前：

参数名 类型 是否必须 描述
clOrdId String 否 客户自定义订单ID
字母（区分大小写）与数字的组合，可以是纯字母、纯数字且长度要在1-32位之间

调整后：

参数名 类型 是否必须 描述
algoClOrdId String 否 客户自定义策略订单ID
字母（区分大小写）与数字的组合，可以是纯字母、纯数字且长度要在1-32位之间。

新增返回参数

参数名 类型 描述
algoClOrdId String 客户自定义策略订单ID
参数名 类型 描述
algoClOrdId String 客户自定义策略订单ID。策略订单触发，且策略单有algoClOrdId时有值，否则为"",
algoId String 策略委托单ID，策略订单触发时有值，否则为""

2023-02-20

调整前：

参数名 类型 描述
> cancelSource String 订单取消的来源
有效值及对应的含义是：
0,5,7,8,10,11,12,15,16,18,19: 已撤单：系统撤单
1: 用户主动撤单
2: 已撤单：预减仓撤单，用户保证金不足导致挂单被撤回
3: 已撤单：风控撤单，用户保证金不足有爆仓风险，导致挂单被撤回
4: 已撤单：币种借币量达到平台硬顶，系统已撤回该订单
6: 已撤单：触发 ADL 撤单，用户保证金率较低且有爆仓风险，导致挂单被撤回
9: 已撤单：扣除资金费用后可用余额不足，系统已撤回该订单
13: 已撤单：FOK 委托订单未完全成交，导致挂单被完全撤回
14: 已撤单：IOC 委托订单未完全成交，仅部分成交，导致部分挂单被撤回
17: 已撤单：平仓单被撤单，由于仓位已被市价全平
20: 系统倒计时撤单

调整后：

参数名 类型 描述
> cancelSource String 订单取消的来源
有效值及对应的含义是：
0: 已撤单：系统撤单
1: 用户主动撤单
2: 已撤单：预减仓撤单，用户保证金不足导致挂单被撤回
3: 已撤单：风控撤单，用户保证金不足有爆仓风险，导致挂单被撤回
4: 已撤单：币种借币量达到平台硬顶，系统已撤回该订单
6: 已撤单：触发 ADL 撤单，用户保证金率较低且有爆仓风险，导致挂单被撤回
9: 已撤单：扣除资金费用后可用余额不足，系统已撤回该订单
13: 已撤单：FOK 委托订单未完全成交，导致挂单被完全撤回
14: 已撤单：IOC 委托订单未完全成交，仅部分成交，导致部分挂单被撤回
17: 已撤单：平仓单被撤单，由于仓位已被市价全平
20: 系统倒计时撤单
21: 已撤单：相关仓位被完全平仓，系统已撤销该止盈止损订单
22, 23: 已撤单：只减仓订单仅允许减少仓位数量，系统已撤销该订单

2023-02-17

2023-02-15

错误码 HTTP 状态码 错误提示
58127 200 主账户 API Key 不支持当前 type 划转类型参数，请参考 API 文档描述
58128 200 子账户 API Key 不支持当前 type 划转类型参数，请参考 API 文档描述
参数名 类型 描述
fillTime String 成交时间，与订单频道的fillTime相同

2023-02-08

参数名 类型 描述
> fromWdId String 内部转账发起者提币申请 ID
如果该笔充值来自于内部转账，则该字段展示内部转账发起者的提币申请 ID，其他情况返回""
参数名 类型 描述
> nonTradableAsset String 是否为不可交易资产
true：不可交易资产，false：可交易资产
> feeCcy String 提币手续费币种，如 USDT

2023-02-07

2023-02-02

参数名 类型 描述
ip String 绑定的ip地址，多个ip用半角逗号隔开，如：117.37.203.58,117.37.203.57。
如果没有绑定ip，会返回空字符串""

2023-02-01

参数名 类型 描述
type String 账单类型
225：鲨鱼鳍申购
226：鲨鱼鳍回款
227：鲨鱼鳍收益
228：鲨鱼鳍退款

2023-01-30

请求参数

参数名 类型 是否必须 描述
rfqId String 否 询价单ID

2023-01-19

2023-01-09

2022-12-30

请求参数

参数名 类型 是否必须 描述
fromWdId String 否 内部转账发起者提币申请 ID
如果该笔充值来自于内部转账，则该字段展示内部转账发起者的提币申请 ID

返回参数

参数名 类型 描述
fromWdId String 内部转账发起者提币申请 ID
如果该笔充值来自于内部转账，则该字段展示内部转账发起者的提币申请 ID

2022-12-28

2022-12-23

参数名 类型 描述
opAuth String 是否开通期权交易
0 未开通，1 已经开通

2022-12-20

参数名 类型 描述
last String 下单时的最新成交价
参数名 类型 是否必须 描述
quickMgnType String 否 一键借币类型，仅适用于杠杆逐仓的一键借币模式：
manual：手动，auto_borrow： 自动借币，auto_repay： 自动还币
默认是manual：手动
参数名 类型 描述
baseBorrowed String 交易币已借，适用于 币币杠杆（逐仓一键借币模式）
baseInterest String 交易币计息，适用于 币币杠杆（逐仓一键借币模式）
quoteBorrowed String 计价币已借，适用于 币币杠杆（逐仓一键借币模式）
quoteInterest String 计价币计息，适用于 币币杠杆（逐仓一键借币模式）
参数名 类型 描述
quickMgnType String 一键借币类型，仅适用于杠杆逐仓的一键借币模式
manual：手动，auto_borrow： 自动借币，auto_repay： 自动还币

调整前：

参数名 类型 是否必须 描述
type String 是 增加/减少保证金
add：增加
reduce：减少
ccy String 否 增加或减少的保证金的币种，
仅适用于逐仓自主划转保证金模式下的币币杠杆

调整后：

参数名 类型 是否必须 描述
type String 是 增加/减少保证金
add：增加，或者转入质押资产(一键借币)
reduce：减少，或者转出质押资产（一键借币）
ccy String 否 增加或减少的保证金的币种，
仅适用于逐仓自主划转和一键借币模式下的币币杠杆
参数名 类型 描述
mgnIsoMode String quick_margin：一键借币（对于新的账户，包括新的子账户，有些默认是开仓划转，另外的默认是一键借币）
参数名 类型 描述
isoMode String quick_margin：一键借币
参数名 类型 是否必须 描述
type String 否 账单类型
15: 一键借币
subType String 否 账单子类型
210: 手动借币 211: 手动还币 212: 自动借币 213：自动还币" 16：强制还币 17：强制借币还息
错误码 HTTP 状态码 错误提示
59313 200 无法还币。在一键借币模式下，您目前没有 ${ccy} 借币（币对：${ccyPair}）
51152 200 一键借币模式下，不支持自动借币与自动还币和手动类型混合下单。

2022-12-15

参数名 类型 描述
state String 项目状态
purchasable：可申购
sold_out：售罄
stop：暂停申购

请求参数

参数名 类型 是否必须 描述
tag String 否 订单标签
字母（区分大小写）与数字的组合，可以是纯字母、纯数字，且长度在1-16位之间

返回参数

参数名 类型 描述
tag String 订单标签
参数名 类型 描述
tag String 订单标签
参数名 类型 描述
estSettlementTime String 预估赎回到账时间
cancelRedemptionDeadline String 撤销赎回申请截止时间
tag String 订单标签
错误码 HTTP 状态码 错误提示
51732 200 用户KYC等级不符合要求
51733 200 用户被风险管理中
51734 200 不支持用户所属KYC国家
51735 200 不支持子帐户
51736 200 {ccy} 余额不足
参数名 类型 描述
roleType String 用户角色。
0：普通用户；1：带单者；2：跟单者
traderInsts String 当前账号已经设置的带单合约，仅适用于带单者
参数名 类型 是否必须 描述
type String 否 账单类型
18: 分润
subType String 否 账单子类型
250: 分润支出; 251: 分润退还; 252: 分润收入;
错误码 HTTP 状态码 错误提示
51156 200 您当前身份为带单交易员。在开平仓模式下，对于带单合约标的不支持使用该接口平仓
51159 200 您当前身份为带单交易员，在买卖模式下，如需使用该接口下单，委托的方向必须与现有持仓和挂单保持一致
51162 200 您当前有 {instrument} 挂单，请撤单后重试
51163 200 您当前有 {instrument} 持仓，请平仓后重试
51166 200 当前产品不支持带单
51321 200 您正在带单。暂不支持使用套利、冰山或时间加权 (TWAP) 策略带单
51322 200 您当前身份为带单交易员。您的带单合约持仓已经市价全平，系统已撤销止盈止损委托并进行平仓
51323 200 您当前身份为带单交易员。您的带单合约仓位已设置止盈止损，请先撤销原有止盈止损订单
51324 200 您当前身份为带单交易员，并持有 {instrument} 仓位。平仓委托张数需要与可平张数一致
51325 200 您当前身份为带单交易员。下止盈止损单时，请选择市价作为委托价格
59128 200 您当前身份为带单交易员。您设置的带单合约 {instrument} 杠杆倍数不能超过 {num}×
59216 200 仓位不存在，请稍后重试

2022-12-14

参数名 类型 描述
bizRefId String 外部业务id，e.g. 体验券id
bizRefType String 外部业务类型
参数名 类型 描述
cancelSource String 订单取消来源的原因枚举值代码
cancelSourceReason String 订单取消来源的对应具体原因

调整返回参数

调整前：

参数名 类型 描述
amt String 借/还币的数量
loanQuota String 借币限额
posLoan String 当前账户负债占用（锁定额度内）
availLoan String 当前账户剩余可用（锁定额度内）
usedLoan String 当前账户已借额度

调整后：

参数名 类型 描述
amt String 已借/还币的数量

新增请求参数

参数名 类型 是否必须 描述
ordId String 可选 借币订单ID，还币时，该字段必填

新增返回参数

参数名 类型 描述
ordId String 借币订单ID
state String 订单状态
1:借币申请中
2:借币中
3:还币申请中
4:已还币
5:借币失败
参数名 类型 描述
> avgRate String 币种已借平均利率，仅适用于尊享借币

2022-12-12

2022-12-09

2022-12-08

参数名 类型 描述
depQuoteDailyLayer2 String Layer2网络每日充值上限

请求参数

参数名 类型 是否必须 描述
tag String 否 询价单标签，与此询价单关联的大宗交易将有相同的标签。
字母（区分大小写）与数字的组合，可以是纯字母、纯数字，且长度在1-16位之间。
> posSide String 否 持仓方向
买卖模式下默认为net。在开平仓模式下仅可选择long或short。
如未指定，则处于开平仓模式下的用户始终会开新仓位。
仅适用交割、永续。

返回参数

参数名 类型 描述
> tag String 询价单标签，与此询价单关联的大宗交易将有相同的标签。
>> posSide String 持仓方向
买卖模式下默认为net。如未指定，则返回""，相当于net。
在开平仓模式下仅可选择long或short。 如未指定，则返回""，对应于为交易开新仓位的方向（买入=>long，卖出=>short）。
仅适用交割、永续。

请求参数

参数名 类型 是否必须 描述
tag String 否 报价单标签，与此报价单关联的大宗交易将有相同的标签。
字母（区分大小写）与数字的组合，可以是纯字母、纯数字，且长度在1-16位之间。
> posSide String 否 持仓方向
买卖模式下默认为net。在开平仓模式下仅可选择long或short。
如未指定，则处于开平仓模式下的用户始终会开新仓位。
仅适用交割、永续。

返回参数

参数名 类型 描述
> tag String 报价单标签，与此报价单关联的大宗交易将有相同的标签。
>> posSide String 持仓方向
买卖模式下默认为net。如未指定，则返回""，相当于net。
在开平仓模式下仅可选择long或short。 如未指定，则返回""，对应于为交易开新仓位的方向（买入=>long，卖出=>short）。
仅适用交割、永续。
参数名 类型 描述
> tag String 询价单标签，与此询价单关联的大宗交易将有相同的标签。
>> posSide String 持仓方向
买卖模式下默认为net。如未指定，则返回""，相当于net。
在开平仓模式下仅可选择long或short。 如未指定，则返回""，对应于为交易开新仓位的方向（买入=>long，卖出=>short）。
仅适用交割、永续。
参数名 类型 描述
> tag String 报价单标签，与此报价单关联的大宗交易将有相同的标签。
>> posSide String 持仓方向
买卖模式下默认为net。如未指定，则返回""，相当于net。
在开平仓模式下仅可选择long或short。 如未指定，则返回""，对应于为交易开新仓位的方向（买入=>long，卖出=>short）。
仅适用交割、永续。
参数名 类型 描述
> tag String 交易标签，大宗交易将有与其对应的询价单或报价单相同的标签。
参数名 类型 描述
> tag String 询价单标签，与此询价单关联的大宗交易将有相同的标签。
>> posSide String 持仓方向
买卖模式下默认为net。如未指定，则返回""，相当于net。
在开平仓模式下仅可选择long或short。 如未指定，则返回""，对应于为交易开新仓位的方向（买入=>long，卖出=>short）。
仅适用交割、永续。
参数名 类型 描述
> tag String 报价单标签，与此报价单关联的大宗交易将有相同的标签。
>> posSide String 持仓方向
买卖模式下默认为net。如未指定，则返回""，相当于net。
在开平仓模式下仅可选择long或short。 如未指定，则返回""，对应于为交易开新仓位的方向（买入=>long，卖出=>short）。
仅适用交割、永续。
参数名 类型 描述
> tag String 交易标签，大宗交易将有与其对应的询价单或报价单相同的标签。

2022-12-06

2022-12-01

调整前：

参数名 类型 描述
sMsg String 事件执行失败时的msg

调整后：

参数名 类型 描述
sMsg String 事件执行失败或成功时的msg
参数名 类型 描述
nonTradableAsset Boolean 是否为不可交易资产
true：不可交易资产，false：可交易资产
feeCcy String 提币手续费币种，如 USDT
错误码 HTTP 状态码 错误提示
58125 200 不可交易资产仅支持子账户转母账户
58126 200 不可交易资产划转，只能在资金账户间互转
58127 200 不可交易资产提币只能全部提出
58128 200 不可交易资产提币要求APIKey必须绑定IP
58129 200 资金账户手续费不足 {fee} USDT

2022-11-30

参数名 类型 描述
label String 当前请求API Key的备注名，不超过50位字母（区分大小写）或数字，可以是纯字母或纯数字。
参数名 类型 描述
perm String API Key权限
withdraw：提币

调整限速规则

调整前：
* 限速规则：衍生品：UserID + (instrumentType + underlying)
* 限速规则：币币和币币杠杆：UserID + (instrumentType + instrumentID

调整后：
* 限速规则（期权以外）：UserID + Instrument ID
* 限速规则（只限期权）：UserID + Instrument Family

参数名 类型 是否必须 描述
sz String 可选 委托数量
sz和closeFraction必填且只能填其一
closeFraction String 可选 策略委托触发时，平仓的百分比。1 代表100%
现在系统只支持全部平仓，唯一接受参数为1
对于同一个仓位，仅支持一笔全部平仓的止盈止损挂单

仅适用于交割或永续
仅适用于买卖模式 posSide = net
仅适用于减仓订单 reduceOnly = true
仅适用于止盈止损 ordType = conditional 或 oco
仅适用于止盈止损市价订单
sz和closeFraction必填且只能填其一
参数名 类型 描述
closeFraction String 策略委托触发时，平仓的百分比
参数名 类型 描述
> closeOrderAlgo Array 平仓策略委托订单
>> algoId String 策略委托单ID
>> slTriggerPx String 止损触发价
>> slTriggerPxType String 止损触发价类型
last：最新价格
index：指数价格
mark：标记价格
>> tpTriggerPx String 止盈委托价
>> tpTriggerPxType String 止盈触发价类型
last：最新价格
index：指数价格
mark：标记价格
>> closeFraction String 策略委托触发时，平仓的百分比。1 代表100%
错误码 HTTP 状态码 错误提示
51327 200 closeFraction 仅适用于交割合约和永续合约
51328 200 closeFraction 仅适用于只减仓订单
51329 200 closeFraction 仅适用于买卖模式
51330 200 closeFraction 仅适用于止盈止损市价订单
参数名 类型 是否必须 描述
quickMgnType String 否 一键借币类型，仅适用于杠杆逐仓的一键借币模式：
manual：手动，auto_borrow： 自动借币，auto_repay： 自动还币
默认是manual：手动
参数名 类型 描述
baseBorrowed String 交易币已借，适用于 币币杠杆（逐仓一键借币模式）
baseInterest String 交易币计息，适用于 币币杠杆（逐仓一键借币模式）
quoteBorrowed String 计价币已借，适用于 币币杠杆（逐仓一键借币模式）
quoteInterest String 计价币计息，适用于 币币杠杆（逐仓一键借币模式）
参数名 类型 描述
quickMgnType String 一键借币类型，仅适用于杠杆逐仓的一键借币模式
manual：手动，auto_borrow： 自动借币，auto_repay： 自动还币

调整前：

参数名 类型 是否必须 描述
type String 是 增加/减少保证金
add：增加
reduce：减少
ccy String 否 增加或减少的保证金的币种，
仅适用于逐仓自主划转保证金模式下的币币杠杆

调整后：

参数名 类型 是否必须 描述
type String 是 增加/减少保证金
add：增加，或者转入质押资产(一键借币)
reduce：减少，或者转出质押资产（一键借币）
ccy String 否 增加或减少的保证金的币种，
仅适用于逐仓自主划转和一键借币模式下的币币杠杆
参数名 类型 描述
mgnIsoMode String quick_margin：一键借币
参数名 类型 是否必须 描述
type String 否 账单类型
15: 一键借币
subType String 否 账单子类型
210: 手动借币 211: 手动还币 212: 自动借币 213：自动还币" 16：强制还币 17：强制借币还息
错误码 HTTP 状态码 错误提示
59313 200 无法还币。在一键借币模式下，您目前没有 ${ccy} 借币（币对：${ccyPair}）
51152 200 一键借币模式下，不支持自动借币与自动还币和手动类型混合下单。

2022-11-29

调整返回参数

调整前：

参数名 类型 描述
amt String 借/还币的数量

调整后：

参数名 类型 描述
amt String 已借/还币的数量

新增请求参数

参数名 类型 是否必须 描述
ordId String 可选 借币订单ID，还币时，该字段必填

新增返回参数

参数名 类型 描述
ordId String 借币订单ID
state String 订单状态
1:借币申请中
2:借币中
3:还币申请中
4:已还币
5:借币失败
参数名 类型 描述
> avgRate String 币种已借平均利率，仅适用于尊享借币

2022-11-28

参数名 类型 描述
confirm String K线状态
0 代表 K 线未完结，1 代表 K 线已完结。

2022-11-25

2022-11-24

参数名 类型 是否必须 描述
mgnType String 否 保证金类型
1：USDT本位
2：币本位
适用于交割/永续

2022-11-21

参数名 类型 描述
confirm String K线状态
0 代表 K 线未完结，1 代表 K 线已完结。
参数名 类型 是否必须 描述
tpTriggerPx String 否 止盈触发价，如果填写此参数，必须填写 止盈委托价
tpOrdPx String 否 止盈委托价，如果填写此参数，必须填写 止盈触发价
委托价格为-1时，执行市价止盈
slTriggerPx String 否 止损触发价，如果填写此参数，必须填写 止损委托价
slOrdPx String 否 止损委托价，如果填写此参数，必须填写 止损触发价
委托价格为-1时，执行市价止损
tpTriggerPxType String 否 止盈触发价类型
last：最新价格
index：指数价格
mark：标记价格
默认为last
slTriggerPxType String 否 止损触发价类型
last：最新价格
index：指数价格
mark：标记价格
默认为last

2022-11-11

参数名 类型 是否必须 描述
areaCode String 可选 手机区号
当toAddr为手机号时，该参数必填
参数名 类型 描述
areaCodeFrom String 如果from为手机号，该字段为该手机号的区号
参数名 类型 描述
areaCodeFrom String 如果from为手机号，该字段为该手机号的区号
areaCodeTo String 如果to为手机号，该字段为该手机号的区号

2022-11-10

参数名 类型 描述
> cancelSource String 订单取消的来源
有效值及对应的含义是：
0,5,7,8,10,11,12,15,16,18,19: 已撤单：系统撤单
1: 用户主动撤单
2: 已撤单：预减仓撤单，用户保证金不足导致挂单被撤回
3: 已撤单：风控撤单，用户保证金不足有爆仓风险，导致挂单被撤回
4: 已撤单：币种借币量达到平台硬顶，系统已撤回该订单
6: 已撤单：触发 ADL 撤单，用户保证金率较低且有爆仓风险，导致挂单被撤回
9: 已撤单：扣除资金费用后可用余额不足，系统已撤回该订单
13: 已撤单：FOK 委托订单未完全成交，导致挂单被完全撤回
14: 已撤单：IOC 委托订单未完全成交，仅部分成交，导致部分挂单被撤回
17: 已撤单：平仓单被撤单，由于仓位已被市价全平
20: 系统倒计时撤单

请求参数

参数名 类型 是否必须 描述
spotOffsetType String 否 现货对冲模式
1：现货对冲模式U模式 2：现货对冲模式币模式 3：衍生品模式
默认是 3

返回参数

参数名 类型 描述
acctImr String 账户维度的最低初始保证金
acctMmr String 账户维度的维持保证金

2022-11-08

参数名 类型 描述
volCcyQuote String 交易量，以计价货币为单位
如：BTC-USDT 和 BTC-USDT-SWAP, 单位均是 USDT；
BTC-USD-SWAP 单位是 USD

2022-11-07

参数名 类型 是否必须 描述
brokerType String 可选 经纪商类型
api：API经纪商
oauth：Oauth经纪商
当经纪商只有一种类型时，该参数可以不填
当经纪商有多种类型时，该参数必填
错误码 HTTP 状态码 错误提示
50044 200 必须指定一种broker类型

2022-11-01

参数名 类型 描述
volCcyQuote String 交易量，以计价货币为单位
如：BTC-USDT 和 BTC-USDT-SWAP, 单位均是 USDT；
BTC-USD-SWAP 单位是 USD

2022-10-28

参数名 类型 是否必须 描述
beginTs String 否 用开始时间戳筛选交易执行时间（UTC时区）。Unix时间戳的毫秒数格式，例如 1597026383085。
endTs String 否 用结束时间戳筛选交易执行时间（UTC时区）。Unix时间戳的毫秒数格式，例如 1597026383085。
错误码 HTTP 状态码 错误提示
70010 200 时间戳参数必须是Unix时间戳的毫秒格式
70013 200 endTs必须大于等于beginTs
70016 200 交易产品设置中需选择至少一个交易品种

2022-10-27

参数名 类型 是否必须 描述
begin String 否 筛选的开始时间戳，Unix 时间戳为毫秒数格式，如 1597026383085
end String 否 筛选的结束时间戳，Unix 时间戳为毫秒数格式，如 1597027383085

使用begin end进行时间筛选的规则如下：
1. 返回结果包含begin end传参；
2. begin end同时存在时，靠近end返回；
3. begin或end和after或 before同时存在时，接口会先使用begin或end进行筛选，然后使用after或before在进行分页。

2022-10-20

参数名 类型 描述
reduceOnly String 是否只减仓，true 或 false

调整前：推送频率最快是间隔500ms推送一次数据。
调整后：推送频率最快是间隔1秒推送一次数据。

2022-10-19

2022-10-14

参数名 类型 描述
instFamily String 交易品种
适用于交割/永续/期权
参数名 类型 是否必须 描述
instFamily String 否 交易品种
适用于交割/永续/期权

请求参数：

参数名 类型 是否必须 描述
instFamily String 可选 交易品种，如BTC-USDT，支持多个查询（不超过5个），instFamily之间半角逗号分隔
适用于交割/永续/期权
uly与instFamily必须传一个,若传两个，以instFamily为主

返回参数：

参数名 类型 描述
instFamily String 交易品种
适用于交割/永续/期权

请求参数：

参数名 类型 是否必须 描述
instFamily String 可选 交易品种
适用于交割/永续/期权
uly与instFamily必须传一个,若传两个，以instFamily为主

返回参数：

参数名 类型 描述
instFamily String 交易品种
适用于交割/永续/期权
参数名 类型 是否必须 描述
instFamily String 可选 交易品种
适用于交割/永续/期权
uly与instFamily必须传一个,若传两个，以instFamily为主

调整前：

参数名 类型 是否必须 描述
> uly String 可选 标的指数

调整后：

参数名 类型 是否必须 描述
> instFamily String 可选 交易品种
适用于交割/永续/期权

调整前：

参数名 类型 是否必须 描述
uly String 是 标的指数，如BTC-USDT，支持多个查询（不超过3个），uly之间半角逗号分隔

调整后：

参数名 类型 是否必须 描述
uly String 可选 标的指数，如BTC-USDT，支持多个查询（不超过3个），uly之间半角逗号分隔
uly与instFamily必须传一个,若传两个，以instFamily为主
instFamily String 可选 交易品种，如BTC-USDT，支持多个查询（不超过5个），instFamily之间半角逗号分隔
适用于交割/永续/期权
uly与instFamily必须传一个,若传两个，以instFamily为主

调整前：

参数名 类型 是否必须 描述
uly String 是 标的指数

调整后：

参数名 类型 是否必须 描述
uly String 可选 标的指数
uly与instFamily必须传一个,若传两个，以instFamily为主
instFamily String 可选 交易品种
适用于交割/永续/期权
uly与instFamily必须传一个,若传两个，以instFamily为主

调整前：

参数 类型 描述
> uly String 标的指数

调整后：

参数 类型 描述
> instFamily String 交易品种
适用于交割/永续/期权
参数名 类型 描述
> instFamily String 交易品种
适用于交割/永续/期权

2022-10-13

参数名 类型 描述
> nextFundingTime String 下一期资金费时间，Unix时间戳的毫秒数格式，如 1622851200000

2022-10-10

参数名 类型 是否必须 描述
allowPartialExecution Boolean 否 RFQ是否可以被部分执行，如果腿的比例和原RFQ一致。有效值为true或false。默认为false。
参数名 类型 是否必须 描述
legs Array of objects 否 用于部分执行的腿的数量。腿的数量比例必须与原RFQ相同。注意：每条腿的tgtCcy和side和原RFQ一致，px和对应Quote一致。
> instId String 是 产品ID, 如 "BTC-USDT-SWAP".
> sz String 是 该条腿的部分执行数量
参数名 类型 是否必须 描述
includeAll Boolean 否 是否接收该instType下所有产品。有效值为true或false。默认false。
参数名 类型 描述
allowPartialExecution Boolean RFQ是否可以被部分执行，如果腿的比例和原RFQ一致。有效值为true或false。默认为false。
错误提示 错误码
交易产品设置中需选择至少一个交易品种 70013
不允许对所有产品类别设置includeAll=True 70014
全现货的RFQ总价值应该大于最小名义值{spotMinNotional} 70108
执行腿的价值总和小于大宗交易的最小名义值 70503
腿的数量比例与原RFQ不一致 70506
部分执行尝试失败。须设置allowPartialExecution为true 70507

2022-10-10

参数名 类型 是否必须 描述
type String 否 充值方式
3：内部转账
4：链上充值

请求参数：

参数名 类型 是否必须 描述
type String 否 提币方式
3：内部转账
4：链上提币

返回参数：

参数名 类型 描述
addrEx Object 提币地址备注，部分币种提币需要，若不需要则不返回此字段。如币种TONCOIN的提币地址备注标签名为comment,则该字段返回：{'comment':'123456'}

2022-09-28

参数名 类型 描述
instFamily String 交易品种
适用于交割/永续/期权
参数名 类型 是否必须 描述
instFamily String 否 交易品种
适用于交割/永续/期权

请求参数：

参数名 类型 是否必须 描述
instFamily String 可选 交易品种，如BTC-USDT，支持多个查询（不超过5个），instFamily之间半角逗号分隔
适用于交割/永续/期权
uly与instFamily必须传一个,若传两个，以instFamily为主

返回参数：

参数名 类型 描述
instFamily String 交易品种
适用于交割/永续/期权

请求参数：

参数名 类型 是否必须 描述
instFamily String 可选 交易品种
适用于交割/永续/期权
uly与instFamily必须传一个,若传两个，以instFamily为主

返回参数：

参数名 类型 描述
instFamily String 交易品种
适用于交割/永续/期权
参数名 类型 是否必须 描述
instFamily String 可选 交易品种
适用于交割/永续/期权
uly与instFamily必须传一个,若传两个，以instFamily为主

调整前：

参数名 类型 是否必须 描述
> uly String 可选 标的指数

调整后：

参数名 类型 是否必须 描述
> instFamily String 可选 交易品种
适用于交割/永续/期权

调整前：

参数名 类型 是否必须 描述
uly String 是 标的指数，如BTC-USDT，支持多个查询（不超过3个），uly之间半角逗号分隔

调整后：

参数名 类型 是否必须 描述
uly String 可选 标的指数，如BTC-USDT，支持多个查询（不超过3个），uly之间半角逗号分隔
uly与instFamily必须传一个,若传两个，以instFamily为主
instFamily String 可选 交易品种，如BTC-USDT，支持多个查询（不超过5个），instFamily之间半角逗号分隔
适用于交割/永续/期权
uly与instFamily必须传一个,若传两个，以instFamily为主

调整前：

参数名 类型 是否必须 描述
uly String 是 标的指数

调整后：

参数名 类型 是否必须 描述
uly String 可选 标的指数
uly与instFamily必须传一个,若传两个，以instFamily为主
instFamily String 可选 交易品种
适用于交割/永续/期权
uly与instFamily必须传一个,若传两个，以instFamily为主

调整前：

参数 类型 描述
> uly String 标的指数

调整后：

参数 类型 描述
> instFamily String 交易品种
适用于交割/永续/期权
参数名 类型 描述
> instFamily String 交易品种
适用于交割/永续/期权

2022-09-22

2022-09-08

调整前：

参数名 类型 描述
taker String 吃单手续费率，永续和交割合约时，为币本位合约费率
maker String 挂单手续费率，永续和交割合约时，为币本位合约费率
takerU String U本位合约吃单手续费率，仅适用于交割/永续
makerU String U本位合约挂单手续费率，仅适用于交割/永续

调整后：

参数名 类型 描述
taker String USDT&USDⓈ&Crypto 交易区的吃单手续费率，永续和交割合约时，为币本位合约费率
maker String USDT&USDⓈ&Crypto 交易区挂单手续费率，永续和交割合约时，为币本位合约费率
takerU String USDT 合约吃单手续费率，仅适用于交割/永续
makerU String USDT 合约挂单手续费率，仅适用于交割/永续
takerUSDC String USDC 交易区的吃单手续费率
makerUSDC String USDC 交易区的挂单手续费率
参数名 类型 描述
clOrdId String 客户自定义订单ID
字母（区分大小写）与数字的组合，可以是纯字母、纯数字且长度要在1-32位之间。

2022-09-06

参数名 类型 描述
depQuotaFixed String 充币固定限额，单位为BTC
没有充币限制则返回""
usedDepQuotaFixed String 已用充币固定额度，单位为BTC
没有充币限制则返回""

调整前：

参数名 类型 描述
taker String 吃单手续费率，永续和交割合约时，为币本位合约费率
maker String 挂单手续费率，永续和交割合约时，为币本位合约费率
takerU String U本位合约吃单手续费率，仅适用于交割/永续
makerU String U本位合约挂单手续费率，仅适用于交割/永续

调整后：

参数名 类型 描述
taker String USDT&USDⓈ&Crypto 交易区的吃单手续费率，永续和交割合约时，为币本位合约费率
maker String USDT&USDⓈ&Crypto 交易区挂单手续费率，永续和交割合约时，为币本位合约费率
takerU String USDT 合约吃单手续费率，仅适用于交割/永续
makerU String USDT 合约挂单手续费率，仅适用于交割/永续
takerUSDC String USDC 交易区的吃单手续费率
makerUSDC String USDC 交易区的挂单手续费率

2022-09-05

参数名 描述
affiliated 是否有节点关系, true 或 false

2022-09-01

参数名 类型 描述
> maxBlockSz String 该种产品最大可交易数量。FUTURES, OPTION and SWAP 的单位是合约数量。SPOT的单位是交易货币。
> makerPxBand String 价格限制以价格精度tick为单位，以标记价格为参考。
设置makerPxBand为1个tick代表:
如果买一价 > 标记价格 + 1 tick, 操作将被拦截
如果 买一价 < 标记价格 - 1 tick, 操作将被拦截
参数名 类型 描述
> reason String 状态原因. 有效值包括 mmp_canceled.
参数名 类型 描述
clOrdId String 客户自定义ID
字母（区分大小写）与数字的组合，可以是纯字母、纯数字且长度要在1-32位之间。
参数 类型 描述
algoOrdType String moon_grid: 天地网格
错误提示 HTTP 状态码 错误码
MMP状态下操作失败。冻结时间为 {0} 秒 200 70008
同一个instType{1}下的instFamily/instId{0} 存在重复设置 200 70012
instId {0} 报价不可以超过你预设的价格限制 200 70310

2022-08-29

参数名 类型 描述
clOrdId String 客户自定义ID
字母（区分大小写）与数字的组合，可以是纯字母、纯数字且长度要在1-32位之间。

调整前：

参数名 类型 是否必须 描述
chgTaker String 可选 Taker手续费加点
固定加点：单位bp(1bp = 0.01%)，范围【0.1bp，1,000bp】，即【0.001%，10%】，精度为0.1bp
百分比加点：单位%范围【1%，1,0000%】，精度为1%
chgMaker String 可选 Maker手续费加点
固定加点：单位bp(1bp = 0.01%)，范围【0.1bp，1,000bp】，即【0.001%，10%】，精度为0.1bp
百分比加点：单位%范围【1%，1,0000%】，精度为1%
chgTaker和chgMaker必须填写一个

调整后：

参数名 类型 是否必须 描述
chgTaker String 可选 Taker手续费加点
固定加点：单位bp(1bp = 0.01%)，范围【0.0bp，1,000bp】，即【0.00%，10%】，精度为0.1bp
百分比加点：单位%范围【0%，1,0000%】，精度为1%
chgMaker String 可选 Maker手续费加点
固定加点：单位bp(1bp = 0.01%)，范围【0.0bp，1,000bp】，即【0.00%，10%】，精度为0.1bp
百分比加点：单位%范围【0%，1,0000%】，精度为1%
chgTaker和chgMaker必须填写一个

2022-08-26

参数名 类型 描述
tag String 订单标签
字母（区分大小写）与数字的组合，可以是纯字母、纯数字，且长度在1-16位之间。
错误提示 HTTP 状态码 错误码
询价数量不能低于下限 200 52917
询价数量不能超过上限 200 52918
闪兑交易参数{param}与报价不一致 200 52919
闪兑交易数量不能超过报价数量 200 52920
报价已交易，请重新询价 200 52921
报价已过期，请重新询价 200 52922
服务异常，请稍后重试 200 52923

2022-08-25

错误提示 HTTP 状态码 错误码
下单失败，现货交易仅支持设置最新价为触发价格，请更改触发价格并重试 200 51415

2022-08-24

更多详情参考 欧易关于升级组合保证金账户——新增现货对冲功能的公告.

参数名 类型 是否必须 描述
unSpotOffset Boolean 否 true：禁止现货对冲，false：允许现货对冲
默认为false
仅适用于组合保证金模式
开启现货对冲模式下有效，否则忽略此参数。
参数名 类型 描述
spotOffsetMaxWd String 现货对冲不支持借币最大可转数量
仅适用于组合保证金模式
spotOffsetMaxWdEx String 现货对冲支持借币的最大可转数量
仅适用于组合保证金模式
参数名 类型 描述
spotOffsetType String 现货对冲类型
1：现货对冲模式U模式 2：现货对冲模式币模式 3：非现货对冲模式
适用于组合保证金模式
参数名 类型 是否必须 描述
omitPosRisk String 否 是否忽略仓位风险
默认为false
仅适用于组合保证金模式
参数名 类型 描述
> spotInUseAmt String 现货对冲占用数量
适用于组合保证金模式
参数名 类型 描述
> spotInUseAmt String 现货对冲占用数量
适用于组合保证金模式
> spotInUseCcy String 现货对冲占用币种，如 BTC
适用于组合保证金模式
错误提示 HTTP 状态码 错误码
此次划转将导致您的仓位风险水平较高，进而可能引起爆仓。您需要重新调整划转金额，确保仓位处于安全水平后，再进行划转操作。 200 58121
您的一部分现货正用于仓位间的 Delta 对冲，若划转数量超过可用金额，可能会影响现有的现货对冲结构，进而导致维持保证金率增加，请留意您的风险水平。 200 58122

2022-08-15

参数名 类型 描述
uid String 账户ID

调整前：

参数名 类型 是否必须 描述
label String 是 API Key的备注，如果填写该字段，那该字段会被重置
不超过50位字母（区分大小写）或数字，可以是纯字母或纯数字。
perm String 是 API Key权限
read_only：读取
trade：交易
多个权限用半角逗号隔开。
如果填写该字段，那该字段会被重置。

调整后：

参数名 类型 是否必须 描述
label String 否 API Key的备注，如果填写该字段，那该字段会被重置
不超过50位字母（区分大小写）或数字，可以是纯字母或纯数字。
perm String 否 API Key权限
read_only: 读取
trade: 交易
多个权限用半角逗号隔开。
如果填写该字段，那该字段会被重置。

2022-08-10

错误提示 HTTP 状态码 错误码
该产品类型 {0} 的标的指数 {0} 不存在 200 70007
Data数组必须至少含有一个有效元素 200 70009
产品类型 {0} 存在重复设置 200 70011
所选产品无有效对手方 200 70109

2022-08-03

错误提示 HTTP 状态码 错误码
提币地址需要标签 200 58221
提币地址不合法 200 58222
该类型币种暂不支持链上提币到 OKX 地址，请通过内部转账进行提币 200 58224

2022-08-02

2022-07-25

参数名 类型 是否必须 描述
posId String 否 持仓ID

2022-07-22

2022-07-18

2022-07-15

参数名 类型 描述
tag String 订单标签

2022-07-11

调整前：

参数名 类型 是否必须 描述
after String 否 请求此ID之前（更旧的数据）的分页内容，传的值为对应接口的 tradeId
before String 否 请求此ID之后（更新的数据）的分页内容，传的值为对应接口的 tradeId

调整后：

参数名 类型 是否必须 描述
type String 否 分页类型
1：tradeId 分页 2：时间戳分页
默认为1：tradeId 分页
after String 否 请求此 ID 或 ts 之前的分页内容，传的值为对应接口的 tradeId 或 ts
before String 否 请求此ID之后（更新的数据）的分页内容，传的值为对应接口的 tradeId。
不支持时间戳分页。

2022-07-01

2022-06-30

参数名 类型 描述
minDep String 币种单笔最小充值量
needTag Boolean 当前链是否需要标签（tag/memo）信息
minDepArrivalConfirm String 充值到账最小网络确认数
minWdUnlockConfirm String 提现解锁最小网络确认数
参数名 类型 描述
actualDepBlkConfirm String 最新的充币网络确认数

2022-06-24

调整前：

参数名 类型 是否必须 描述
uly String 可选 标的指数， 当产品类型是 永续、交割、期权 之一时必填，当产品类型是 MARGIN 时忽略
instId String 可选 产品ID， 仅适用币币杠杆，且必填写

调整后：

参数名 类型 是否必须 描述
uly String 可选 标的指数，支持多uly，半角逗号分隔，最大不超过3个
当产品类型是 永续、交割、期权 之一时必填，当产品类型是 MARGIN 时忽略
instId String 可选 产品ID，支持多instId，半角逗号分隔，最大不超过5个
仅适用币币杠杆，且必填写

2022-06-23

调整前：

参数名 类型 描述
type String 平仓类型
partClose：部分平仓;allClose：完全平仓;
状态叠加时，以最新的平仓类型为准状态为准。
posSide String 持仓方向 long：多 short：空
仅适用于 币币杠杆/交割/永续/期权

调整后：

参数名 类型 描述
type String 平仓类型
1：部分平仓;2：完全平仓;3：强平;4：强减; 5：ADL自动减仓;
状态叠加时，以最新的平仓类型为准状态为准。
direction String 持仓方向 long：多 short：空
仅适用于 币币杠杆/交割/永续/期权

2022-06-20

请求参数调整前：

参数名 类型 是否必须 描述
state String No 系统的状态，scheduled:等待中 ; ongoing:进行中 ; completed:已完成 canceled: 已取消
不填写此参数，默认返回 等待中和进行中 的数据

请求参数调整后：

参数名 类型 是否必须 描述
state String No 系统的状态，scheduled:等待中 ; ongoing:进行中 ; pre_open:预开放；completed:已完成 canceled: 已取消
当维护时间过长，会存在预开放时间，一般持续10分钟左右。
不填写此参数，默认返回 等待中、进行中和预开放 的数据

返回参数调整前：

参数名 类型 描述
end String 系统维护的结束时间，Unix时间戳的毫秒数格式 如：1617788463867
在维护完成前，是预期结束时间；维护完成后，会变更为实际结束时间。
serviceType String 服务类型， 0：WebSocket ; 5：交易服务

返回参数调整后：

参数名 类型 描述
end String 交易全面开放的时间，Unix时间戳的毫秒数格式 如：1617788463867
在维护完成前，是预期结束时间；维护完成后，会变更为实际结束时间。
preOpenBegin String 预开放开始的时间，开放撤单、Post Only 下单和资金转入功能的时间
serviceType String 服务类型， 0：WebSocket ; 5：交易服务；99：其他（如：停止部分产品交易）

调整前：

参数名 类型 描述
> end String 系统维护的结束时间，Unix时间戳的毫秒数格式 如：1617788463867
在维护完成前，是预期结束时间；维护完成后，会变更为实际结束时间。
> serviceType String 服务类型， 0：WebSocket ; 5：交易服务

调整后：

参数名 类型 描述
> end String 交易全面开放的时间，Unix时间戳的毫秒数格式 如：1617788463867
在维护完成前，是预期结束时间；维护完成后，会变更为实际结束时间。
> preOpenBegin String 预开放开始的时间，开放撤单、Post Only 下单和资金转入功能的时间
> serviceType String 服务类型， 0：WebSocket ; 5：交易服务；99：其他（如：停止部分产品交易）

2022-06-16

2022-06-14

调整前：

参数名 类型 描述
type String 平仓类型
partClose：部分平仓;allClose：完全平仓;
状态叠加时，以最新的平仓类型为准状态为准。
posSide String 持仓方向 long：多 short：空
仅适用于 币币杠杆/交割/永续/期权

调整后：

参数名 类型 描述
type String 平仓类型
1：部分平仓;2：完全平仓;3：强平;4：强减; 5：ADL自动减仓;
状态叠加时，以最新的平仓类型为准状态为准。
direction String 持仓方向 long：多 short：空
仅适用于 币币杠杆/交割/永续/期权

2022-06-10

错误提示 HTTP 状态码 错误码
组合保证金模式暂不支持合约网格 200 51055
当前策略不支持该操作 200 51056
简单交易模式下不可用合约网格 200 51057
该策略无仓位 200 51058
策略当前状态不支持此操作 200 51059
投入保证金需大于{0}{1} 200 51340
当前策略状态下暂不支持平仓 200 51341
已有平仓单，请稍后重试 200 51342
止盈价格需小于区间最低价格 200 51343
止损价格需大于区间最高价格 200 51344
策略类型不是网格策略 200 51345
最高价格不能低于最低价格 200 51346
暂无可提取利润 200 51347
止损价格需小于区间最低价格 200 51348
止盈价格需大于区间最高价格 200 51349
单格收益必须大于0 200 51351

2022-06-09

调整前：

参数名 类型 是否必须 描述
label String 否 子账户的备注

调整后：

参数名 类型 是否必须 描述
label String 否 子账户的备注
不超过50位字母（区分大小写）或数字，可以是纯字母或纯数字。

调整前：

参数名 类型 是否必须 描述
label String 是 APIKey的备注

调整后：

参数名 类型 是否必须 描述
label String 是 APIKey的备注
不超过50位字母（区分大小写）或数字，可以是纯字母或纯数字。

调整前：

参数名 类型 是否必须 描述
label String 是 APIKey的备注

调整后：

参数名 类型 是否必须 描述
label String 是 APIKey的备注
不超过50位字母（区分大小写）或数字，可以是纯字母或纯数字。

2022-06-07

2022-06-01

2022-05-26

参数名 类型 是否必须 描述
banAmend Boolean 否 是否禁止币币市价改单，true 或 false，默认false
为true时，余额不足时，系统不会改单，下单会失败，仅适用于币币市价单

2022-05-23

2022-05-20

参数名 类型 是否必须 描述
begin String 否 筛选的开始时间戳，Unix 时间戳为毫秒数格式，如 1597026383085
end String 否 筛选的结束时间戳，Unix 时间戳为毫秒数格式，如 1597027383085

使用begin end进行时间筛选的规则如下：
1. 返回结果包含begin end传参；
2. begin end同时存在时，靠近end返回；
3. begin或end和after或 before同时存在时，接口会先使用begin或end进行筛选，然后使用after或before在进行分页。

2022-05-19

2022-05-18

调整前：

参数名 类型 是否必须 描述
passphrase String 是 APIKey的密码，6-32位小写字母数字组合，及至少包含一个大写字母或特殊字符
ip String 是 绑定ip地址，多个ip用半角逗号隔开，最多支持20个ip

调整后：

参数名 类型 是否必须 描述
passphrase String 是 APIKey的密码，8-32位字母数字组合，至少包含一个数字、一个大写字母、一个小写字母、一个特殊字符
ip String 可选 绑定ip地址，多个ip用半角逗号隔开，最多支持20个ip
如果子账户APIKey拥有交易权限，必须绑定IP地址

调整前：

参数名 类型 是否必须 描述
ip String 否 绑定ip地址，多个ip用半角逗号隔开，最多支持20个ip

调整后：

参数名 类型 是否必须 描述
ip String 否 绑定ip地址，多个ip用半角逗号隔开，最多支持20个ip
如果子账户APIKey拥有交易权限，必须绑定IP地址

2022-05-13

参数名 类型 描述
clientId String 客户自定义ID
字母（区分大小写）与数字的组合，可以是纯字母、纯数字且长度要在1-32位之间。

2022-05-07

详情请参考：关于“获取当前账户交易手续费费率”接口调整的公告

2022-05-05

深度频道 更新前 更新后
bbo-tbt 无 1、新增bbo深度频道，实时推送买卖1档深度数据
2、所有API用户均可订阅
3、公共深度频道，无需身份验证
books-l2-tbt 1、所有API用户均可订阅
2、公共深度频道，无需身份验证		 1、仅手续费等级达到VIP5及以上的用户可以订阅
2、该TBT深度频道需要身份验证后才可订阅，身份认证参考登录功能
books50-l2-tbt 1、所有API用户均可订阅
2、公共深度频道，无需身份验证		 1、仅手续费等级达到VIP4及以上的用户可以订阅
2、该TBT深度频道需要身份验证后才可订阅，身份认证参考登录功能
books 1、所有API用户均可订阅
2、公共深度频道，无需身份验证		 无更新
books5 1、所有API用户均可订阅
2、公共深度频道，无需身份验证		 无更新
从每"200"毫秒调整为每"100"毫秒,有深度变化推送一次的变动将在两周内上线
参数名 类型 是否必须 描述
type String 否 3：子账户转母账户(仅适用于子账户APIKey)
4：子账户转子账户(仅适用于子账户APIKey，且目标账户需要是同一母账户下的其他子账户)
参数名 类型 描述
canTransOut Boolean 是否可以主动转出
false：不可转出
true：可以转出
错误消息 错误码
{0} 子账户没有转出权限，请先设置 58119

2022-04-28

参数名 类型 描述
> maxLmtSz String 合约或现货限价单的单笔最大委托数量
> maxMktSz String 合约或现货市价单的单笔最大委托数量
> maxTwapSz String 合约或现货时间加权单的单笔最大委托数量
> maxIcebergSz String 合约或现货冰山委托的单笔最大委托数量
> maxTriggerSz String 合约或现货计划委托委托的单笔最大委托数量
> maxStopSz String 合约或现货止盈止损委托的单笔最大委托数量
参数名 类型 是否必须 描述
op String 是 操作，subscribe unsubscribe
args Array 是 请求订阅的频道列表
> channel String 是 频道名，instruments
> instType String 是 产品类型
MARGIN：币币杠杆


参数名 类型 描述
> maxLmtSz String 合约或现货限价单的单笔最大委托数量
> maxMktSz String 合约或现货市价单的单笔最大委托数量
> maxTwapSz String 合约或现货时间加权单的单笔最大委托数量
> maxIcebergSz String 合约或现货冰山委托的单笔最大委托数量
> maxTriggerSz String 合约或现货计划委托委托的单笔最大委托数量
> maxStopSz String 合约或现货止盈止损委托的单笔最大委托数量

2022-04-26

参数名 类型 描述
logoLink String 币种Logo链接

2022-04-25

深度频道 更新前 更新后
bbo-tbt 无 1、新增bbo深度频道，实时推送买卖1档深度数据
2、所有API用户均可订阅
3、公共深度频道，无需身份验证
books-l2-tbt 1、所有API用户均可订阅
2、公共深度频道，无需身份验证		 1、仅手续费等级达到VIP5及以上的用户可以订阅
2、该TBT深度频道需要身份验证后才可订阅，身份认证参考登录功能
books50-l2-tbt 1、所有API用户均可订阅
2、公共深度频道，无需身份验证		 1、仅手续费等级达到VIP4及以上的用户可以订阅
2、该TBT深度频道需要身份验证后才可订阅，身份认证参考登录功能
books 1、所有API用户均可订阅
2、公共深度频道，无需身份验证		 无更新
books5 1、所有API用户均可订阅
2、公共深度频道，无需身份验证		 1、所有API用户均可订阅
2、公共深度频道，无需身份验证
3、从每200ms推送一次，调整为每100ms推送一次

2022-04-15

详情请参考：关于“获取当前账户交易手续费费率”接口调整的公告

2022-04-14

{
    "op": "subscribe",
    "args": [{
        "channel": "bbo-tbt",
        "instId": "BTC-USDT"
    }]
}

请求参数

参数 类型 是否必须 描述
op String 是 操作，subscribe unsubscribe
args Array 是 请求订阅的频道列表
> channel String 是 频道名，books books5 books-l2-tbt books50-l2-tbt bbo-tbt
> instId String 是 产品ID

返回示例

{
    "event": "subscribe",
    "arg": {
        "channel": "bbo-tbt",
        "instId": "BTC-USDT"
    }
}

失败示例

{
    "event": "error",
    "code": "Invalid",
    "msg": "Invalid request: {\"op\": \"subscribe\", \"argss\":[{ \"channel\" : \"bbo-tbt\", \"instId\" : \"BTC-USDT\"}]}"
}

返回参数

参数 类型 是否必须 描述
event String 是 事件，subscribe unsubscribe error
arg Object 否 订阅的频道
> channel String 是 频道名
> instId String 是 产品ID
msg String 否 错误消息
code String 否 错误码

推送示例 ：

{
    "arg": {
        "channel": "bbo-tbt",
        "instId": "BTC-USDT"
    },
    "data": [{
        "asks": [
            ["8506.96", "100", "0", "2"]
        ],
        "bids": [
            ["8446", "95", "0", "3"]
        ],
        "ts": "1597026383085"
    }]
}

推送示例：仅买方有深度时

{
    "arg": {
        "channel": "bbo-tbt",
        "instId": "BTC-USDT"
    },
    "data": [{
        "asks": [],
        "bids": [
            ["8446", "95", "0", "3"]
        ],
        "ts": "1597026383085"
    }]
}

* book5深度频道由每"200"毫秒有深度变化推送一次5档数据 调整为 每"100"毫秒有深度变化推送一次5档数据
* books-l2-tbt400档深度频道，只允许交易手续费等级VIP5及以上的API用户订阅。此更改仅影响WebSocket API用户，详细内容如下：
* books50-l2-tbt50档深度频道，只允许交易手续费等级VIP4及以上的API用户订阅。此更改仅影响WebSocket API用户，详细内容如下：

深度频道 更新前 更新后
bbo-tbt 无 1、新增bbo深度频道，实时推送买卖1档深度数据
2、所有API用户均可订阅
3、公共深度频道，无需身份验证
books-l2-tbt 1、所有API用户均可订阅
2、公共深度频道，无需身份验证		 1、仅手续费等级达到VIP5及以上的用户可以订阅
2、该TBT深度频道需要身份验证后才可订阅，身份认证参考登录功能
books50-l2-tbt 1、所有API用户均可订阅
2、公共深度频道，无需身份验证		 1、仅手续费等级达到VIP4及以上的用户可以订阅
2、该TBT深度频道需要身份验证后才可订阅，身份认证参考登录功能
books 1、所有API用户均可订阅
2、公共深度频道，无需身份验证		 无更新
books5 1、所有API用户均可订阅
2、公共深度频道，无需身份验证		 1、所有API用户均可订阅
2、公共深度频道，无需身份验证
3、从每200ms推送一次，调整为每100ms推送一次

2022-04-08

2022-04-07

参数名 类型 是否必须 描述
tag String 否 订单标签
参数名 类型 描述
maxWd String 币种单笔最大提币量
wdTickSz String 提币精度,表示小数点后的位数
wdQuota String 过去24小时内提币额度，单位为USD
usedWdQuota String 过去24小时内已用提币额度，单位为USD
参数名 类型 是否必须 描述
depId String 否 充值记录ID
参数名 类型 是否必须 描述
wdId String 否 提币申请ID
错误消息 错误码
小额兑换功能每日使用次数超限 58370
小额资产超过最大限制 58371
小额资产不足 58372
提币申请ID不存在 58215
不允许执行该操作 58216

2022-03-10

若用户继续传入资金密码参数会忽略，不报错

参数名 类型 描述
mr1 String 现货&波动率压力测试值
mr2 String 时间价值压力测试值
mr3 String 波动率跨期压力测试值
mr4 String 基差压力测试值
mr5 String 利率风险压力测试值
mr6 String 极端市场波动压力测试值
mr7 String 减仓成本压力测试值
错误消息 错误码
您当前不在白名单列表，请联系客服 50041
该接口要求APIKey必须绑定IP 50035
起始日期和结束日期的时间间隔不能超过180天。 59615
起始日期不能大于结束日期 59616

2022-03-02

2022-02-17

参数名 类型 是否必须 描述
rate String 否 申购年利率
仅适用于申购，新申购的利率会覆盖上次申购的利率
如果不填按照默认1%的利率申购
参数取值范围在1%到365%之间

调整后：

参数名 类型 是否必须 描述
rate String 是 申购年利率
仅适用于申购，新申购的利率会覆盖上次申购的利率
参数取值范围在1%到365%之间

业务公告

2022-01-26

参数名 类型 描述
type String 子账户类型,1:普通子账户 2:托管子账户

2022-01-25

参数名 类型 描述
addrEx Object 充值地址备注，部分币种充值需要，若不需要则不返回此字段
如币种TONCOIN的充值地址备注标签名为comment,则该字段返回：{'comment':'123456'}

2022-01-20

2022-01-18

参数名 类型 描述
tag String 订单标签
字母（区分大小写）与数字的组合，可以是纯字母、纯数字，且长度在1-16位之间。

2022-01-17

参数名 类型 描述
triggerPxType String 计划委托触发价类型
last：最新价格
index：指数价格
mark：标记价格
默认为last
参数名 类型 是否必须 描述
triggerPxType String 否 计划委托触发价类型
last：最新价格
index：指数价格
mark：标记价格
默认为last

2022-01-14

2022-01-11

2022-01-06

参数名 类型 描述
callbackRatio String 回调幅度的比例
仅适用于移动止盈止损
callbackSpread String 回调幅度的价距
仅适用于移动止盈止损
activePx String 移动止盈止损激活价格
仅适用于移动止盈止损
moveTriggerPx String 移动止盈止损触发价格
仅适用于移动止盈止损

ordType新增枚举值：

参数名 类型 描述
ordType String move_order_stop：移动止盈止损


参数名 类型 是否必须 描述
callbackRatio String 可选 回调幅度的比例，如 0.05
callbackRatio和callbackSpread只能传入一个
callbackSpread String 可选 回调幅度的价距
activePx String 否 激活价格

ordType新增枚举值：

参数名 类型 是否必须 描述
ordType String 是 move_order_stop：移动止盈止损
错误消息 错误码
passphrase不正确 60024

2021-12-24

参数名 类型 描述
ctIsoMode String 衍生品的逐仓保证金划转模式
automatic：开仓划转 autonomy：自主划转
mgnIsoMode String 币币杠杆的逐仓保证金划转模式
automatic：开仓划转 autonomy：自主划转


参数名 类型 描述
baseBal String 交易币余额，适用于 币币杠杆（逐仓自主划转模式）
quoteBal String 计价币余额 ，适用于 币币杠杆（逐仓自主划转模式）


参数名 类型 是否必须 描述
ccy String 否 增加或减少的保证金的币种，
仅适用于逐仓自主划转保证金模式下的币币杠杆
auto Boolean 否 是否自动借币转 true 或 false，默认false
仅适用于逐仓自主划转保证金模式下的币币杠杆


参数名 类型 是否必须 描述
px String 否 委托价格
当不填委托价时会按当前最新成交价计算
当指定多个产品ID查询时，忽略该参数，按当前最新成交价计算

2021-12-14

参数名 类型 描述
rate String 最新出借利率
loanAmt String 已出借数量
pendingAmt String 未出借数量
redemptAmt String 赎回中的数量


参数名 类型 描述
rate String 申购年利率
参数名 类型 描述
> irDiscount String 利率的折扣率
该字段已废弃，始终返回""

2021-12-06

参数名 类型 是否必须 描述
loanTrans Boolean 否 是否支持跨币种保证金模式下的借币转出/转入
默认为false。


参数名 类型 描述
maxWdEx String 最大可划转数量（支持跨币种保证金模式借币转出）
参数名 类型 描述
> level String 用户VIP等级，如 VIP5

2021-12-04

参数名 类型 描述
tpTriggerPxType String 止盈触发价类型
last：最新价格
index：指数价格
mark：标记价格
slTriggerPxType String 止损触发价类型
last：最新价格
index：指数价格
mark：标记价格
参数名 类型 是否必须 描述
tpTriggerPxType String 否 止盈触发价类型
last：最新价格
index：指数价格
mark：标记价格
默认为last
slTriggerPxType String 否 止损触发价类型
last：最新价格
index：指数价格
mark：标记价格
默认为last

2021-11-26

参数名 类型 是否必须 描述
reduceOnly Boolean 否 是否只减仓，true 或 false，默认false
仅适用于币币杠杆，以及买卖模式下的交割/永续
仅适用于单币种保证金模式和跨币种保证金模式

2021-11-25

参数名 类型 描述
type String 借币类型
1：尊享借币
2：市场借币


参数名 类型 描述
subType String 14：尊享借币扣息
错误提示 HTTP 状态码 错误码
可用保证金不足，请尝试增加保证金或减少借币数量 200 59303
借币币种权益不足，请至少留有一天的利息 200 59304
您当前没有进行尊享借币，无法设置尊享借币优先 200 59305
借币数量超过总额度，不可继续借币 200 59306
当前用户不满足尊享借币条件 200 59307
市场化借币额度不足，VIP还币失败 200 59308
还币数量超出已借数量，还币失败 200 59309
当前账户不支持尊享借币 200 59310
存在尊享借币，无法设置 200 59311
{币种}不支持尊享借币 200 59312

2021-11-23

2021-11-20

参数名 类型 描述
leverage String 调整保证金后的实际杠杆倍数

2021-11-02

参数名 类型 是否必须 描述
leverage String 否 开仓杠杆倍数
默认为当前杠杆倍数
仅适用于币币杠杆/交割/永续

2021-11-01

参数名 类型 描述
category String ddh：对冲减仓类型订单
参数名 类型 描述
category String ddh：对冲减仓类型订单
参数名 类型 描述
category String ddh：对冲减仓类型订单
参数名 类型 描述
category String ddh：对冲减仓类型订单
参数名 类型 是否必须 描述
type String 否 账单类型
1：划转 2：交易 3：交割 4：自动换币 5：强平 6：保证金划转 7：扣息 8：资金费 9：自动减仓 10：穿仓补偿 11：系统换币 12：策略划拨 13：对冲减仓
subType String 否 账单子类型
1：买入 2：卖出 3：开多 4：开空 5：平多 6：平空 9：扣息 11：转入 12：转出 160：手动追加保证金 161：手动减少保证金 162：自动追加保证金 114：自动换币买入 115：自动换币卖出 118：系统换币转入 119：系统换币转出 100：强减平多 101：强减平空 102：强减买入 103：强减卖出 104：强平平多 105：强平平空 106：强平买入 107：强平卖出 110：强平换币转入 111：强平换币转出 125：自动减仓平多 126：自动减仓平空 127：自动减仓买入 128：自动减仓卖出 131：对冲买入 132：对冲卖出 170：到期行权 171：到期被行权 172：到期作废 112：交割平多 113：交割平空 117：交割/期权穿仓补偿 173：资金费支出 174：资金费收入 200:系统转入 201:手动转入 202:系统转出 203:手动转出
参数名 类型 是否必须 描述
type String 否 账单类型
1：划转 2：交易 3：交割 4：自动换币 5：强平 6：保证金划转 7：扣息 8：资金费 9：自动减仓 10：穿仓补偿 11：系统换币 12：策略划拨 13：对冲减仓
subType String 否 账单子类型
1：买入 2：卖出 3：开多 4：开空 5：平多 6：平空 9：扣息 11：转入 12：转出 160：手动追加保证金 161：手动减少保证金 162：自动追加保证金 114：自动换币买入 115：自动换币卖出 118：系统换币转入 119：系统换币转出 100：强减平多 101：强减平空 102：强减买入 103：强减卖出 104：强平平多 105：强平平空 106：强平买入 107：强平卖出 110：强平换币转入 111：强平换币转出 125：自动减仓平多 126：自动减仓平空 127：自动减仓买入 128：自动减仓卖出 131：对冲买入 132：对冲卖出 170：到期行权 171：到期被行权 172：到期作废 112：交割平多 113：交割平空 117：交割/期权穿仓补偿 173：资金费支出 174：资金费收入 200:系统转入 201:手动转入 202:系统转出 203:手动转出
参数名 类型 描述
acctLv String 账户层级
1：简单交易模式，2：单币种保证金模式 ，3：跨币种保证金模式 ，4：组合账户
参数名 类型 是否必须 描述
bar String 否 时间粒度，默认值1m
如 [1m/3m/5m/15m/30m/1H/2H/4H]
香港时间开盘价k线：[6H/12H/1D/1W/1M/3M/6M/1Y]
UTC时间开盘价k线：[/6Hutc/12Hutc/1Dutc/1Wutc/1Mutc/3Mutc/6Mutc/1Yutc]
参数 类型 是否必须 描述
> channel String 是 频道名，
index-candle1Y
index-candle6M
index-candle3M
index-candle1M
index-candle1W
index-candle1D
index-candle2D
index-candle3D
index-candle5D
index-candle12H
index-candle6H
index-candle4H
index -candle2H
index-candle1H
index-candle30m
index-candle15m
index-candle5m
index-candle3m
index-candle1m
index-candle1Yutc
index-candle3Mutc
index-candle1Mutc
index-candle1Wutc
index-candle1Dutc
index-candle2Dutc
index-candle3Dutc
index-candle5Dutc
index-candle12Hutc
index-candle6Hutc
参数 类型 是否必须 描述
> channel String 是 频道名
mark-price-candle1Y
mark-price-candle6M
mark-price-candle3M
mark-price-candle1M
mark-price-candle1W
mark-price-candle1D
mark-price-candle2D
mark-price-candle3D
mark-price-candle5D
mark-price-candle12H
mark-price-candle6H
mark-price-candle4H
mark-price-candle2H
mark-price-candle1H
mark-price-candle30m
mark-price-candle15m
mark-price-candle5m
mark-price-candle3m
mark-price-candle1m
mark-price-candle1Yutc
mark-price-candle3Mutc
mark-price-candle1Mutc
mark-price-candle1Wutc
mark-price-candle1Dutc
mark-price-candle2Dutc
mark-price-candle3Dutc
mark-price-candle5Dutc
mark-price-candle12Hutc
mark-price-candle6Hutc
参数 类型 是否必须 描述
> channel String 是 频道名，
candle1Y
candle6M candle3M candle1M
candle1W
candle1D candle2D candle3D candle5D
candle12H candle6H candle4H candle2H candle1H
candle30m candle15m candle5m candle3m candle1m
candle1Yutc candle3Mutc candle1Mutc candle1Wutc candle1Dutc candle2Dutc candle3Dutc candle5Dutc candle12Hutc candle6Hutc
参数名 类型 描述
execType String 流动性方向 T：taker M：maker
参数名 类型 描述
execType String 流动性方向 T：taker M：maker
错误提示 HTTP 状态码 错误码
当前账户风险状态，仅支持降低账户风险方向的IOC订单 200 51037
当前风险模块下已经存在降低账户风险方向的IOC类型订单 200 51038
PM账户下交割和永续的全仓不能调整杠杆倍数 200 51039
期权逐仓的买方不能调整保证金 200 51040
当前账户模式不支持此API接口 200 51010
PM账户不支持ordType为{0}的策略委托单 200 51295
PM账户仅支持买卖模式 200 51041
修改订单失败，PM账户下，批量改单不允许一批量请求中包含相同的订单 200 51512
期权全仓不能有净开多持仓 200 51019

2021-10-19

参数名 类型 描述
markPx String 标记价格
参数名 类型 描述
>markPx String 标记价格

2021-10-18

参数名 类型 描述
mainNet Boolean 当前链是否为主链
如果是则返回true，否则返回false
错误提示 HTTP 状态码 错误码
用户没有使用此API接口的权限 200 50030
交割、永续合约的买卖模式下，不支持计划委托 200 51298
{chainName}维护中，暂停提币 200 58214
只支持同一业务线下交易产品ID 200 59004

2021-10-15

实盘支持冰山委托和时间加权委托

参数名 类型 是否必须 描述
ordType String 是 订单类型
conditional：单向止盈止损
oco：双向止盈止损
trigger：计划委托

调整后：

参数名 类型 是否必须 描述
ordType String 是 订单类型
conditional：单向止盈止损
oco：双向止盈止损
trigger：计划委托
iceberg：冰山委托
twap：时间加权委托

请求参数字段新增：

冰山委托

参数名 类型 是否必须 描述
pxVar String 可选 挂单价距离盘口的比例
pxVar和pxSpread只能传入一个
pxSpread String 可选 挂单价距离盘口的价距
szLimit String 是 单笔数量
pxLimit String 是 挂单限制价

时间加权

参数名 类型 是否必须 描述
pxVar String 可选 吃单价优于盘口的比例
pxVar和pxSpread只能传入一个
pxSpread String 可选 吃单单价优于盘口的价距
szLimit String 是 单笔数量
pxLimit String 是 挂单限制价
timeInterval String 是 下单间隔

调整前：

参数名 类型 是否必须 描述
ordType String 是 订单类型
conditional：单向止盈止损
oco：双向止盈止损
trigger：计划委托

调整后：

参数名 类型 是否必须 描述
ordType String 是 订单类型
conditional：单向止盈止损
oco：双向止盈止损
trigger：计划委托
iceberg：冰山委托
twap：时间加权委托

新增返回字段：

参数名 类型 描述
pxVar String 价格比例
仅适用于冰山委托和时间加权委托
pxSpread String 价距
仅适用于冰山委托和时间加权委托
szLimit String 单笔数量
仅适用于冰山委托和时间加权委托
pxLimit String 挂单限制价
仅适用于冰山委托和时间加权委托
timeInterval String 下单间隔
仅适用于时间加权委托

2021-10-14

2021-10-12

2021-09-30

错误提示 HTTP 状态码 错误码
invoice已经过期 200 58351
invoice无效 200 58352
充币数量需要在限额范围内 200 58353
单日达到生成invoice 10,000 个的上限 200 58354
用户没有使用此API接口的权限 200 58355
同节点账户不支持闪电网络充币或提币 200 58356

2021-09-08

错误提示 HTTP 状态码 错误码
吃单价优于盘口的比例范围 200 51282
时间间隔的范围{0}s~{1}s 200 51283
单笔数量的范围{0}~{1} 200 51284
委托总量的范围{0}~{1} 200 51285
下单金额需大于等于{0} 200 51286
策略不支持此合约 200 51287
策略正在停止中，请勿重复点击 200 51288
策略配置不存在，请稍后再试 200 51289
策略引擎正在升级，请稍后重试 200 51290
策略不存在或已停止 200 51291
策略类型不存在 200 51292
策略不存在 200 51293
该策略暂不能创建，请稍后再试 200 51294

2021-09-07

参数名 类型 是否必须 描述
instId String 是 产品ID
支持多产品ID查询（不超过20个）,半角逗号分隔

2021-09-06

模拟盘支持冰山委托和时间加权委托

参数名 类型 是否必须 描述
ordType String 是 订单类型
conditional：单向止盈止损
oco：双向止盈止损
trigger：计划委托

调整后：

参数名 类型 是否必须 描述
ordType String 是 订单类型
conditional：单向止盈止损
oco：双向止盈止损
trigger：计划委托
iceberg：冰山委托
twap：时间加权委托

请求参数字段新增：

冰山委托

参数名 类型 是否必须 描述
pxVar String 可选 挂单价距离盘口的比例
pxVar和pxSpread只能传入一个
pxSpread String 可选 挂单价距离盘口的价距
szLimit String 是 单笔数量
pxLimit String 是 挂单限制价

时间加权

参数名 类型 是否必须 描述
pxVar String 可选 吃单价优于盘口的比例
pxVar和pxSpread只能传入一个
pxSpread String 可选 吃单单价优于盘口的价距
szLimit String 是 单笔数量
pxLimit String 是 挂单限制价
timeInterval String 是 下单间隔

调整前：

参数名 类型 是否必须 描述
ordType String 是 订单类型
conditional：单向止盈止损
oco：双向止盈止损
trigger：计划委托

调整后：

参数名 类型 是否必须 描述
ordType String 是 订单类型
conditional：单向止盈止损
oco：双向止盈止损
trigger：计划委托
iceberg：冰山委托
twap：时间加权委托

新增返回字段：

参数名 类型 描述
pxVar String 价格比例
仅适用于冰山委托和时间加权委托
pxSpread String 价距
仅适用于冰山委托和时间加权委托
szLimit String 单笔数量
仅适用于冰山委托和时间加权委托
pxLimit String 挂单限制价
仅适用于冰山委托和时间加权委托
timeInterval String 下单间隔
仅适用于时间加权委托

2021-09-03

2021-08-31

参数名 类型 描述
> stgyEq String 策略权益
> isoUpl String 逐仓未实现盈亏
适用于单币种保证金模式和跨币种保证金模式

2021-08-20

参数名 类型 是否必须 描述
txId String 否 区块转账哈希记录

2021-07-30

参数名 类型 是否必须 描述
tgtCcy String 否 委托数量的类型
base_ccy: 交易货币 ；quote_ccy：计价货币
仅适用于币币订单
参数名 类型 描述
tgtCcy String 委托数量的类型
base_ccy: 交易货币 ；quote_ccy：计价货币
仅适用于币币订单
参数名 类型 描述
tgtCcy String 委托数量的类型
base_ccy: 交易货币 ；quote_ccy：计价货币
仅适用于币币订单
错误提示 HTTP 状态码 错误码
该{0}对应的产品业务线不支持使用tgtCcy参数。 200 59110
错误提示 HTTP 状态码 错误码
计划委托不支持使用tgtCcy参数 200 51281

2021-07-20

2021-07-08

2021-06-15

参数名 类型 描述
ctAddr String 合约地址后6位
参数名 类型 描述
chain String 币种链信息
如USDT下有USDT-ERC20，USDT-TRC20多个链

提币 新增请求参数chain。

参数名 类型 是否必须 描述
chain String 可选 币种链信息
如USDT下有USDT-ERC20，USDT-TRC20多个链
如果没有不填此参数，则默认为主链

2021-06-11

错误提示 HTTP 状态码 错误码
交割后30分钟内不能转出 200 55000
参数名 类型 是否必须 描述
instId String 是 产品ID，如 BTC-USDT
支持多产品ID查询（不超过5个），半角逗号分隔

2021-06-08

调整前：

参数名 类型 描述
transferId int 划转ID

调整后：

参数名 类型 描述
transId String 划转ID

调整前：

code 类型 httpcode msg
50011 int 429 用户请求频率过快，超过该接口允许的限额

调整后：

code 类型 httpcode msg
50011 String 429 用户请求频率过快，超过该接口允许的限额
参数名 类型 是否必须 描述
instType String 否 产品类型
MARGIN：币币杠杆
SWAP：永续合约
FUTURES：交割合约
OPTION：期权
instType和instId同时传入的时候会校验instId与instType是否一致，结果返回instId的持仓信息
instId String 否 交易产品ID，如：BTC-USD-190927-5000-C
如果该instId拥有过的仓位，将返回持仓信息，不管持仓量是否为0；否则不返回
posId String 否 持仓ID
支持多个posId查询（不超过20个），半角逗号分隔
参数名 类型 描述
> fillNotionalUsd String 委托单已成交的美元价值
> notionalUsd String 委托单预估美元价值
参数名 类型 描述
> notionalUsd String 委托单预估美元价值

2021-05-25

参数名 类型 描述
discountInfo Array 币种折算率详情
> discountRate String 折算率
> maxAmt String 梯度区间上限（美元），“” 表示正无穷
> minAmt String 梯度区间下限（美元），最小值是0
参数名 类型 描述
ordType String 订单类型
market：市价单
limit：限价单
post_only：只做maker单
fok：全部成交或立即取消
ioc：立即成交并取消剩余
optimal_limit_ioc：市价委托立即成交并取消剩余（仅适用交割、永续）

2021-05-18

2021-05-12

2021-04-27

2021-04-21

参数名 类型 描述
> deltaBS String 美金本位持仓仓位delta，仅适用于期权
> deltaPA String 币本位持仓仓位delta，仅适用于交割、永续、期权
> gammaBS String 美金本位持仓仓位gamma，仅适用于期权
> gammaPA String 币本位持仓仓位gamma，仅适用于期权
> thetaBS String 美金本位持仓仓位theta，仅适用于期权
> thetaPA String 币本位持仓仓位theta，仅适用于期权
> vegaBS String 美金本位持仓仓位vega，仅适用于期权
> vegaPA String 币本位持仓仓位vega，仅适用于期权

2021-04-16

2021-03-31

2021-03-24

2021-03-02

2021-02-26

2021-02-05