尊敬的欧易API用户:
为了更提升用户体验,欧易在四季度对V5 API服务进行了不断的优化迭代,汇总如下。
未来欧易将持续优化V5 API的功能,为您提供更优秀的产品和更优质的服务。
(更详细的升级日志请参见我们的API在线文档 https://www.okx.com/docs-v5/log_zh/ )
优化汇总:
-
交易模块
Id
|
接口
|
迭代简述
|
日期
|
1
|
策略委托下单
|
支持冰山委托和时间加权委托
|
2021-10-15
|
新增请求参数tpTriggerPxType,slTriggerPxType
|
2021-12-04
|
||
2
|
撤销高级策略委托订单
|
新增接口
|
2021-10-15
|
3
|
获取历史策略委托单列表
|
支持冰山委托和时间加权委托
|
2021-10-15
|
新增字段tpTriggerPxType,slTriggerPxType
|
2021-12-04
|
||
4
|
获取未完成策略委托单列表
|
支持冰山委托和时间加权委托
|
2021-10-15
|
新增字段tpTriggerPxType,slTriggerPxType
|
2021-12-04
|
||
5
|
获取订单信息
|
category字段新增枚举值 ddh
|
2021-11-01
|
新增字段tpTriggerPxType,slTriggerPxType
|
2021-12-04
|
||
6
|
获取历史订单记录(近七天)
|
category字段新增枚举值 ddh
|
2021-11-01
|
新增字段tpTriggerPxType,slTriggerPxType
|
2021-12-04
|
||
7
|
获取历史订单记录(近三个月)
|
category字段新增枚举值 ddh
|
2021-11-01
|
新增字段tpTriggerPxType,slTriggerPxType
|
2021-12-04
|
||
8
|
下单
|
调整请求参数字段reduceOnly
|
2021-11-26
|
9
|
批量下单
|
调整请求参数字段reduceOnly
|
2021-11-26
|
10
|
获取未成交订单列表
|
新增字段tpTriggerPxType,slTriggerPxType
|
2021-12-04
|
-
资金模块
Id
|
接口
|
迭代简述
|
日期
|
1
|
资金划转状态查询
|
新增接口
|
2021-10-12
|
2
|
获取币种列表
|
新增返回字段mainNet
|
2021-10-18
|
3
|
获取账户资产估值
|
新增接口
|
2021-10-23
|
4
|
资金划转
|
新增请求参数loanTrans
|
2021-12-06
|
5
|
设置余币宝借贷利率
|
新增接口
|
2021-12-14
|
6
|
获取余币宝出借明细
|
||
7
|
获取市场借贷信息(公共)
|
||
8
|
获取市场借贷历史(公共)
|
||
9
|
获取余币宝余额
|
新增返回参数rate,loanAmt,pendingAmt,redemptAmt
|
2021-12-14
|
10
|
余币宝申购/赎回
|
新增参数rate
|
2021-12-14
|
-
账户模块
Id
|
接口
|
迭代简述
|
日期
|
1
|
获取最大可用数量
|
支持多个instId查询,半角逗号分隔。instId个数不超过5个。
|
2021-10-12
|
新增参数px
|
2021-12-24
|
||
2
|
获取交易产品最大可借
|
支持多个instId查询,半角逗号分隔。instId个数不超过5个。
|
2021-10-12
|
3
|
查看账户最大可转余额
|
支持多币种查询(不超过20个),币种之间半角逗号分隔。
|
2021-10-18
|
新增返回参数maxWdEx
|
2021-12-06
|
||
4
|
查看持仓信息
|
新增字段markPx
|
2021-10-19
|
新增返回参数baseBal,quoteBal
|
2021-12-24
|
||
5
|
查看账户持仓风险
|
新增返回参数baseBal,quoteBal
|
2021-12-24
|
6
|
查看账户特定风险状态
|
新增接口
|
2021-11-01
|
7
|
账单流水查询(近七天)
|
|
2021-11-01
|
返回参数新增字段execType
|
2021-11-01
|
||
subType新增枚举值。14:尊享借币扣息
|
2021-11-25
|
||
8
|
账单流水查询(近三月)
|
|
2021-11-01
|
返回参数新增字段execType
|
2021-11-01
|
||
subType新增枚举值。14:尊享借币扣息
|
2021-11-25
|
||
9
|
查看账户配置
|
acctLv新增枚举值,4:组合账户
|
2021-11-01
|
新增返回参数ctIsoMode,mgnIsoMode
|
2021-12-24
|
||
10
|
获取最大可买卖/开仓数量
|
新增请求参数leverage
|
2021-11-02
|
11
|
调整保证金
|
新增返回参数leverage
|
2021-11-20
|
新增请求参数loanTrans
|
2021-12-06
|
||
新增参数ccy,auto
|
2021-12-24
|
||
12
|
尊享借币还币
|
新增接口
|
2021-11-25
|
13
|
获取尊享借币还币历史
|
||
14
|
获取借币利率与限额
|
||
15
|
获取计息记录
|
新增参数type
|
2021-11-25
|
16
|
组合保证金的虚拟持仓保证金计算
|
新增接口
|
2021-12-24
|
17
|
逐仓交易设置
|
新增接口
|
2021-12-24
|
-
子账户模块
Id
|
接口
|
迭代简述
|
日期
|
1
|
子账户间资金划转
|
新增请求参数loanTrans
|
2021-12-06
|
-
行情数据模块
Id
|
接口
|
迭代简述
|
日期
|
1
|
获取交易产品K线数据
|
bar新增枚举值,支持获取UTC时区K线
|
2021-11-01
|
2
|
获取交易产品历史K线数据
|
||
3
|
获取指数K线数据
|
||
4
|
获取标记价格K线数据
|
-
公共数据模块
Id
|
接口
|
迭代简述
|
日期
|
1
|
获取尊享借币杠杆利率和借币限额
|
新增接口
|
2021-11-25
|
2
|
获取市场借币杠杆利率和借币限额
|
调整字段irDiscount
|
2021-12-14
|
-
Broker API模块
新增 ND-Broker功能模块
-
WebSocket模块
Id
|
接口
|
迭代简述
|
日期
|
1
|
高级策略委托订单频道
|
新增频道
|
2021-10-15
|
2
|
订单频道
|
category字段新增枚举值ddh
|
2021-11-01
|
新增字段tpTriggerPxType,slTriggerPxType
|
2021-12-04
|
||
3
|
策略委托订单频道
|
新增字段tpTriggerPxType,slTriggerPxType
|
2021-12-04
|
4
|
持仓频道
|
新增字段markPx
|
2021-10-19
|
新增返回参数baseBal,quoteBal
|
2021-12-24
|
||
5
|
账户余额和持仓频道
|
新增返回参数baseBal,quoteBal
|
2021-12-24
|
6
|
指数k线频道
|
新增UTC时区k线频道
|
2021-11-01
|
7
|
标记价格K线频道
|
||
8
|
K线频道
|
-
交互式浏览器
新增交互式浏览器
-
错误码
Id
|
迭代简述
|
日期
|
1
|
新增错误码 50030 用户没有使用此API接口的权限
|
2021-10-18
|
2
|
新增错误码 51298 交割、永续合约的买卖模式下,不支持计划委托
|
|
3
|
新增错误码 58214 {chainName}维护中,暂停提币
|
|
4
|
新增错误码 59004 只支持同一业务线下交易产品ID
|
|
5
|
新增错误码 50037 当前账户风险状态,仅支持降低账户风险方向的IOC订单
|
2021-11-01
|
6
|
新增错误码 51038 当前风险模块下已经存在降低账户风险方向的IOC类型订单
|
|
7
|
新增错误码 51039 PM账户下交割和永续的全仓不能调整杠杆倍数
|
|
8
|
新增错误码 51040 期权逐仓的买方不能调整保证金
|
|
9
|
新增错误码 51010 当前账户模式不支持此API接口
|
|
10
|
新增错误码 51295 PM账户不支持ordType为{0}的策略委托单
|
|
11
|
新增错误码 51041 PM账户仅支持买卖模式
|
|
12
|
新增错误码 51512 修改订单失败,PM账户下,批量改单不允许一批量请求中包含相同的订单
|
|
13
|
新增错误码 51019 期权全仓不能有净多头持仓
|
|
14
|
新增错误码 59303 可用保证金不足,请尝试增加保证金或减少借币数量
|
2021-11-25
|
15
|
新增错误码 59304 借币币种权益不足,请至少留有一天的利息
|
|
16
|
新增错误码 59305 您当前没有进行尊享借币,无法设置尊享借币优先
|
|
17
|
新增错误码 59306 借币数量超过总额度,不可继续借币
|
|
18
|
新增错误码 59307 当前用户不满足尊享借币条件
|
|
19
|
新增错误码 59308 市场化借币额度不足,VIP还币失败
|
|
20
|
新增错误码 59309 还币数量超出已借数量,还币失败
|
|
21
|
新增错误码 59310 当前账户不支持尊享借币
|
|
22
|
新增错误码 59311 存在尊享借币,无法设置
|
|
23
|
新增错误码 59312 {币种}不支持尊享借币
|
优化明细:
-
交易模块
-
迭代 1
-
日期:2021-10-15
-
REST接口:
-
策略委托下单
-
获取历史策略委托单列表
-
获取未完成策略委托单列表
-
撤销高级策略委托订单
-
REST URLs:
-
POST /api/v5/trade/order-algo
-
GET /api/v5/trade/orders-algo-history
-
GET /api/v5/trade/orders-algo-pending
-
POST /api/v5/trade/cancel-advance-algos
-
详细描述:
-
策略委托下单,获取历史策略委托单列表,获取未完成策略委托单列表 支持冰山委托和时间加权委托
-
新增接口撤销高级策略委托订单
-
体验提升点:策略委托支持更多的策略委托类型
-
迭代 2
-
日期:2021-11-01
-
REST接口:
-
获取订单信息
-
获取历史订单记录(近七天)
-
获取历史订单记录(近三个月)
-
REST URLs:
-
GET /api/v5/trade/order
-
GET /api/v5/trade/orders-history
-
GET /api/v5/trade/orders-history-archive
-
详细描述:
-
获取订单信息,获取历史订单记录(近七天),获取历史订单记录(近三个月) category字段新增枚举值ddh:对冲减仓类型订单
-
体验提升点:让查询更加灵活
-
迭代 3
-
日期:2021-11-26
-
REST接口:
-
下单
-
批量下单
-
REST URLs:
-
POST /api/v5/trade/order
-
POST /api/v5/trade/batch-orders
-
详细描述:调整请求参数字段reduceOnly
-
体验提升点:补全了交割和永续的只减仓功能
-
迭代 4
-
日期:2021-12-04
-
REST接口:
-
获取订单信息
-
获取未成交订单列表
-
获取历史订单记录(近七天)
-
获取历史订单记录(近三个月)
-
策略委托下单
-
获取未完成策略委托单列表
-
获取历史策略委托单列表
-
REST URLs:
-
GET /api/v5/trade/order
-
GET /api/v5/trade/orders-pending
-
GET /api/v5/trade/orders-history
-
GET /api/v5/trade/orders-history-archive
-
POST /api/v5/trade/order-algo
-
GET /api/v5/trade/orders-algo-pending
-
GET /api/v5/trade/orders-algo-history
-
详细描述:新增参数tpTriggerPxType,slTriggerPxType
-
体验提升点:止盈止损订单支持多触发价格类型
-
资金模块
-
迭代 1
-
日期:2021-10-12
-
REST接口:资金划转状态查询
-
REST URLs:GET /api/v5/asset/transfer-state
-
详细描述:新增接口
-
体验提升点:方便用户查看资金划转状态
-
迭代 2
-
日期:2021-10-18
-
REST接口:获取币种列表
-
REST URLs:GET /api/v5/asset/currencies
-
详细描述:新增返回字段mainNet
-
体验提升点:用户可以通过接口获取币种主链信息
-
迭代 3
-
日期:2021-10-18
-
REST接口:获取账户资产估值
-
REST URLs:GET /api/v5/asset/asset-valuation
-
详细描述:新增接口
-
体验提升点:用户可以通过接口获取账户资产估值
-
迭代 4
-
日期:2021-12-06
-
REST接口:资金划转
-
REST URLs:POST /api/v5/asset/transfer
-
详细描述:新增请求参数loanTrans
-
体验提升点:API支持借币转出
-
迭代 5
-
日期:2021-12-14
-
REST接口:
-
设置余币宝借贷利率
-
获取余币宝出借明细
-
获取市场借贷信息(公共)
-
获取市场借贷历史(公共)
-
获取余币宝余额
-
余币宝申购/赎回
-
REST URLs:
-
POST /api/v5/asset/set-lending-rate
-
GET /api/v5/asset/lending-history
-
GET /api/v5/asset/lending-rate-summary
-
GET /api/v5/asset/lending-rate-history
-
GET /api/v5/asset/saving-balance
-
POST /api/v5/asset/purchase_redempt
-
详细描述:
-
新增接口设置余币宝借贷利率, 获取余币宝出借明细,取市场借贷信息(公共),获取市场借贷历史(公共)
-
获取余币宝余额新增返回参数rate,loanAmt,pendingAmt,redemptAmt
-
余币宝申购/赎回新增参数rate
-
体验提升点:API支持利率市场化调整
-
账户模块
-
迭代 1
-
日期:2021-10-12
-
REST接口:
-
获取最大可用数量
-
获取交易产品最大可借
-
REST URLs:
-
GET /api/v5/account/max-avail-size
-
GET /api/v5/account/max-loan
-
详细描述:支持多个instId查询,半角逗号分隔。instId个数不超过5个。
-
体验提升点:提高查询效率
-
迭代 2
-
日期:2021-10-18
-
REST接口:查看账户最大可转余额
-
REST URLs:GET /api/v5/account/max-withdrawal
-
详细描述:支持多币种查询(不超过20个),币种之间半角逗号分隔。
-
体验提升点:提高查询效率
-
迭代 3
-
日期:2021-10-19
-
REST接口:查看持仓信息
-
REST URLs:GET /api/v5/account/positions
-
详细描述:新增返回字段markPx
-
体验提升点:返回结果提供标记价格信息
-
迭代 4
-
日期:2021-11-01
-
REST接口:查看账户特定风险状态
-
REST URLs:GET /api/v5/account/risk-state
-
详细描述:新增接口
-
体验提升点:用户可以使用API查看账户特定风险状态
-
迭代 5
-
日期:2021-11-01
-
REST接口:查看账户配置
-
REST URLs:GET /api/v5/account/config
-
详细描述:acctLv字段新增枚举值。 4:组合账户
-
体验提升点:API支持组合账户
-
迭代 6
-
日期:2021-11-01
-
REST接口:
-
账单流水查询(近七天)
-
账单流水查询(近三月)
-
REST URLs:
-
GET /api/v5/account/bills
-
GET /api/v5/account/bills-archive
-
详细描述:
-
返回参数新增字段 execType:订单流动性方向
-
type字段新增枚举值 ,13:ddh;subType字段新增枚举值,131:对冲买入 和132:对冲卖出
-
体验提升点:让查询更加灵活
-
迭代 7
-
日期:2021-11-02
-
REST接口:获取最大可买卖/开仓数量
-
REST URLs:GET /api/v5/account/max-size
-
详细描述:新增请求参数leverage
-
体验提升点:用户获取指定杠杆倍数下交易产品最大可买卖/开仓数量
-
迭代 8
-
日期:2021-11-20
-
REST接口:调整保证金
-
REST URLs:POST /api/v5/account/position/margin-balance
-
详细描述:新增返回参数leverage
-
体验提升点:用户获取调整保证金后的仓位实际杠杆倍数
-
迭代 9
-
日期:2021-11-25
-
REST接口:
-
尊享借币还币
-
获取尊享借币还币历史
-
获取借币利率与限额
-
获取计息记录
-
账单流水查询(近七天)
-
账单流水查询(近三月)
-
REST URLs:
-
POST /api/v5/account/borrow-repay
-
GET /api/v5/account/borrow-repay-history
-
GET /api/v5/account/interest-limits
-
GET /api/v5/account/interest-accrued
-
GET /api/v5/account/bills
-
GET /api/v5/account/bills-archive
-
详细描述:
-
新增接口尊享借币还币, 获取尊享借币还币历史, 获取借币利率与限额
-
获取计息记录新增参数type。1:尊享借币,2:市场借币
-
账单流水查询(近七天), 账单流水查询(近三月)subType字段新增枚举值,14:尊享借币扣息
-
体验提升点:API支持尊享借币
-
迭代 10
-
日期:2021-12-06
-
REST接口:查看账户最大可转余额
-
REST URLs:GET /api/v5/account/max-withdrawal
-
详细描述:新增返回参数maxWdEx
-
体验提升点:用户获取跨币种保证金模式支持借币转出场景下最大可划转数量
-
迭代 11
-
日期:2021-12-24
-
REST接口:组合保证金的虚拟持仓保证金计算
-
REST URLs:POST /api/v5/account/simulated_margin
-
详细描述:新增接口
-
体验提升点:用户可以通过该接口计算模拟头寸或当前头寸的投资组合保证金信息
-
迭代 12
-
日期:2021-12-24
-
REST接口:逐仓交易设置
-
REST URLs:POST /api/v5/account/set-isolated-mode
-
详细描述:新增接口
-
体验提升点:用户可以通过该接口设置币币杠杆和交割、永续的逐仓仓位保证金的划转模式
-
迭代 13
-
日期:2021-12-24
-
REST接口:
-
查看账户配置
-
查看持仓信息
-
查看账户持仓风险
-
调整保证金
-
REST URLs:
-
GET /api/v5/account/config
-
GET /api/v5/account/positions
-
GET /api/v5/account/account-position-risk
-
POST /api/v5/account/position/margin-balance
-
详细描述:
-
查看账户配置新增返回参数ctIsoMode,mgnIsoMode
-
查看持仓信息,查看账户持仓风险新增返回参数baseBal,quoteBal
-
调整保证金新增参数ccy,auto
-
体验提升点:API支持逐仓保证金自主划转
-
迭代 14
-
日期:2021-12-24
-
REST接口:获取最大可用数量
-
REST URLs:GET /api/v5/account/max-avail-size
-
详细描述:新增参数px
-
体验提升点:让查询更加灵活
-
子账户模块
-
迭代 1
-
日期:2021-12-06
-
REST接口:子账户间资金划转
-
REST URLs:POST /api/v5/asset/subaccount/transfer
-
详细描述:新增请求参数loanTrans
-
体验提升点:API支持借币转出
-
行情数据模块
-
迭代 1
-
日期:2021-11-01
-
REST接口:
-
获取交易产品K线数据
-
获取交易产品历史K线数据
-
获取指数K线数据
-
获取标记价格K线数据
-
REST URLs:
-
GET /api/v5/market/candles
-
GET /api/v5/market/history-candles
-
GET /api/v5/market/index-candles
-
GET /api/v5/market/mark-price-candles
-
详细描述:bar字段新增枚举值,支持获取UTC时区k线
-
体验提升点:让查询更加灵活
-
公共数据模块
-
迭代 1
-
日期:2021-11-25
-
REST接口:获取尊享借币杠杆利率和借币限额
-
REST URLs:GET /api/v5/public/vip-interest-rate-loan-quota
-
详细描述:新增接口
-
体验提升点:API支持尊享借币
-
迭代 2
-
日期:2021-12-14
-
REST接口:获取市场借币杠杆利率和借币限额
-
REST URLs:GET /api/v5/public/vip-interest-rate-loan-quota
-
详细描述:废弃返回参数字段irDiscount
-
体验提升点:API支持利率市场化调整
-
Broker API模块
-
WebSocket模块
-
迭代 1
-
日期:2021-10-15
-
频道名:高级策略委托订单频道
-
订阅名:algo-advance
-
详细描述:新增频道
-
体验提升点:支持更多的策略订单的推送
-
迭代 2
-
日期:2021-10-19
-
频道名:持仓频道
-
订阅名:positions
-
详细描述:新增返回字段markPx
-
体验提升点:推送结果提供标记价格信息
-
迭代 3
-
日期:2021-11-01
-
频道名:订单频道
-
订阅名:orders
-
详细描述:category字段新增枚举值ddh
-
体验提升点:推送结果提供对冲减仓类型订单信息
-
迭代 4
-
日期:2021-11-01
-
频道名:指数K线频道,标记价格K线频道,K线频道
-
订阅名:index-candle,mark-price-candle,candle
-
详细描述:新增UTC时区K线频道
-
体验提升点:支持更多的K线维度推送
-
迭代 5
-
日期:2021-12-04
-
频道名:订单频道, 策略委托订单频道
-
订阅名:orders,orders-algo
-
详细描述:新增字段tpTriggerPxType,slTriggerPxType
-
体验提升点:止盈止损订单支持多触发价格类型
-
迭代 6
-
日期:2021-12-24
-
频道名:持仓频道,账户余额和持仓频道
-
订阅名:positions,balance_and_position
-
详细描述:新增返回参数baseBal,quoteBal
-
体验提升点:API支持逐仓保证金自主划转
-
交互式浏览器
新增交互式浏览器,链接(https://www.okx.com/demo-trading-explorer/v5/zh)
你可以通过交互式浏览器来快速体验、在线调试API接口。
-
错误码
-
迭代 1
-
日期:2021-10-18
-
详细描述:
-
新增错误码 50030 用户没有使用此API接口的权限
-
新增错误码 51298 交割、永续合约的买卖模式下,不支持计划委托
-
新增错误码 58214 {chainName}维护中,暂停提币
-
新增错误码 59004 只支持同一业务线下交易产品ID
-
体验提升点:使错误场景对用户更加清晰。
-
迭代 2
-
日期:2021-11-01
-
详细描述:
-
新增错误码 50037 当前账户风险状态,仅支持降低账户风险方向的IOC订单
-
新增错误码 51038 当前风险模块下已经存在降低账户风险方向的IOC类型订单
-
新增错误码 51039 PM账户下交割和永续的全仓不能调整杠杆倍数
-
新增错误码 51040 期权逐仓的买方不能调整保证金
-
新增错误码 51010 当前账户模式不支持此API接口
-
新增错误码 51295 PM账户不支持ordType为{0}的策略委托单
-
新增错误码 51041 PM账户仅支持买卖模式
-
新增错误码 51512 修改订单失败,PM账户下,批量改单不允许一批量请求中包含相同的订单
-
新增错误码 51019 期权全仓不能有净多头持仓
-
体验提升点:使错误场景对用户更加清晰。
-
迭代 3
-
日期:2021-11-25
-
详细描述:
-
新增错误码 59303 可用保证金不足,请尝试增加保证金或减少借币数量
-
新增错误码 59304 借币币种权益不足,请至少留有一天的利息
-
新增错误码 59305 您当前没有进行尊享借币,无法设置尊享借币优先
-
新增错误码 59306 借币数量超过总额度,不可继续借币
-
新增错误码 59307 当前用户不满足尊享借币条件
-
新增错误码 59308 市场化借币额度不足,VIP还币失败
-
新增错误码 59309 还币数量超出已借数量,还币失败
-
新增错误码 59310 当前账户不支持尊享借币
-
新增错误码 59311 存在尊享借币,无法设置
-
新增错误码 59312 {币种}不支持尊享借币
-
体验提升点:使错误场景对用户更加清晰。
欧易团队
2022年4月14日(HKT)