更新日志
2026-07-13
U 本位合约体验金
- 新增 查询 API 体验金列表
GET /api/v2/futures/voucher/list，支持按token和voucherStatus查询。 - 新增 领取 API 体验金
POST /api/v2/futures/voucher/receive，使用relationId指定待领取的体验金；只读 API Key 不支持领取。 - 新增 API 体验金错误码
-1400至-1417。
账户流水
GET /api/v1/account/balanceFlow、GET /api/v1/futures/balanceFlow、GET /api/v2/account/balance-flow的响应新增voucherType和deductionAmount，用于标识卡券类型和当前流水的卡券抵扣金额。
2026-07-07
钱包接口
- 提币
POST /api/v1/account/withdraw— 新增可选入参addressType。为空时默认BLOCK_CHAIN；支持BLOCK_CHAIN、PHONE_NUMBER、EMAIL、UID枚举名称。PHONE_NUMBER、EMAIL、UID用于平台内部划转，文档已补充application/x-www-form-urlencoded请求示例。
账户接口
- 账户流水
GET /api/v2/account/balance-flow—flowType入参使用枚举名称，文档补充常用枚举值说明。
2026-04-24
文档调整（V1）
- 账户信息
GET /api/v1/account—balances元素在参考文档中仅描述coin字段（不再列出asset/assetId/assetName）。 - 万能划转
POST /api/v1/subAccount/transfer— 入参文档仅列coin。 - 合约账户余额
GET /api/v1/futures/balance— 每条余额在文档中仅列coin（不再以asset展示）。 - 充值地址
GET /api/v1/account/deposit/address— 响应以chainType展示（与入参链类型一致），不再以coinType作为文档字段。
新增 REST API v2（独立页面 + 侧栏导航）
- 账户
GET /api/v2/account/balance-flow—accountType/flowType使用枚举名；出参字段精简。见 账户与交易（v2）。 - U 本位合约
/api/v2/futures/...— 普通单与计划委托等相关路径拆分、side+positionSide、普通单以LIMIT/MARKET区分限价与市价、JSON 批量下单与验签、杠杆在data中为整型等。见 账户与交易（v2）。
全局
- 所有需签名的 REST 响应头增加限频信息：
X-Api-Limit-Status、X-Api-Limit、X-Api-Limit-Reset-Timestamp。 - 对 v2 且
Content-Type: application/json的POST，签名字符串为queryString与原始 JSON 请求体直接拼接（中间无&），且 JSON 须与 body 完全一致。见 基础信息。
2026-03-30
行情与资金费率
GET /quote/v1/markPrice：symbol改为可选；不传时返回全量标记价格列表（JSON 数组）。GET /api/v1/futures/fundingRate：响应新增字段interest、fundingRateCap、fundingRateFloor。
合约下单与查询
- 限价单
timeInForce新增可选取值POST_ONLY。
2026-03-11
修改接口
- 资金费率接口：
GET /api/v1/futures/fundingRate、GET /api/v1/futures/historyFundingRate新增返回字段period（资金费率结算周期，如 "8H"） - 获取交易所信息：
GET /api/v1/exchangeInfo的contracts列表中新增返回字段categories（合约所属分类，英文名称；无分类时返回空数组，多分类时返回多个） - 闪电平仓：
POST /api/v1/futures/flashClose新增入参category（USDC合约=USDC，默认=USDT合约） - 一键反手：
POST /api/v1/futures/reversePosition新增入参category（USDC合约=USDC，默认=USDT合约）
2026-02-04
新增股票合约相关字段
接口:
- api/v1/auth/exchangeInfo 调整内容:
- 新增返回字段
closingStartTime、closingEndTime、isRwa、rwaType
2026-02-02
修改接口
- 子账户划转接口：新增
transferId字段（LONG型，非必须），相同transferId可以防止重复划转。 - 错误消息调整：接口返回权限不足时，错误消息中会包含具体所需权限信息，便于排查问题。
2026-01-19
修改接口
- 请求响应Header新增
traceId字段，可以提供给客服协助排查问题。
2025-01-01
新增接口
账户相关接口
- 申请下载文件
- 查询下载记录详情
期货订单相关接口
- 查询历史持仓列表
- 修改订单
- 逐仓自动追加保证金开关
- 闪电平仓
- 一键反手
通用接口
- 获取系统所有风险限额配置列表
修改接口
- 获取交易所信息：返回币对正确的状态
- 查询合约账户余额：新增
coupon字段（体验金、现金券等总和） - 设置仓位止盈止损：支持追踪止损
2022-10-16
文档创建