跳到主要内容

变更日志 (Changelog)

记录 ZTDX API 的所有重要变更、新功能和改进。

[2025-12-26] 🎉 重大更新​

✨ 新增功能​

触发订单系统​

  • 新增触发订单API，支持止盈、止损和追踪止损
  • 新增仓位TP/SL快捷设置接口
  • 新增触发订单配置查询
  • 新增触发订单执行历史查询
  • 详见: 触发订单文档

ADL (自动减仓) 机制​

  • 新增ADL配置查询API
  • 新增ADL排名查询API
  • 新增用户ADL历史查询
  • 新增市场ADL事件查询
  • 新增用户ADL统计数据
  • 详见: ADL文档

推荐系统增强​

  • 新增链上推荐数据查询（6个新接口）
    • 链上用户返佣查询
    • 链上推荐信息查询
    • 链上已领取金额查询
    • Operator状态查询
  • 新增链上领取签名接口
  • 5级返佣系统：Bronze (10%) → Diamond (30%)
  • 详见: 推荐系统文档

提现管理增强​

  • 新增查询单个提现详情 GET /api/v1/withdraw/:id
  • 新增取消提现 DELETE /api/v1/withdraw/:id/cancel
  • 新增确认提现 POST /api/v1/withdraw/:id/confirm
  • 详见: 充值提现文档

清算和保险基金​

  • 新增清算历史查询
  • 新增市场清算事件查询
  • 新增清算配置查询
  • 新增保险基金余额查询
  • 详见: 清算机制文档

WebSocket 增强​

  • 新增 WebSocketAuth EIP-712 签名支持
  • 新增私有数据流订阅（订单、仓位、余额、触发订单）
  • 新增心跳机制
  • 详见: WebSocket文档

🔧 改进​

智能保证金计算​

  • 优化平仓订单保证金计算
  • 平仓订单现在只需支付手续费，无需额外保证金
  • 资金利用率提升90%+
  • 详见: 订单管理文档

仓位管理增强​

  • 新增保证金添加接口
  • 新增保证金移除接口
  • 新增清算状态检查
  • 优化清算价格计算
  • 详见: 仓位管理文档

账户余额优化​

  • 明确区分可用余额和冻结余额
  • 添加余额变化WebSocket推送
  • 优化保证金冻结/释放机制
  • 详见: 账户余额文档

📚 文档更新​

认证机制完全重写​

  • 从 Personal Sign 升级到 EIP-712
  • 添加7种签名类型完整定义
  • 提供 JavaScript/Python 代码示例
  • 添加 Domain 配置说明
  • 详见: 身份验证文档

API 文档覆盖率​

  • 从 45% 提升到 100% 🎯
  • 新增 33 个之前缺失的API端点文档
  • 新增 30+ 个可运行代码示例
  • 新增完整的错误代码说明

新增文档​

  • ✅ 触发订单 (trade/trigger_orders.md)
  • ✅ ADL机制 (trade/adl.md)
  • ✅ 清算机制 (trade/liquidation.md)
  • ✅ 交易历史 (trade/trades.md)
  • ✅ WebSocket (ws.md)
  • ✅ K线内部接口 (internal/klines.md)
  • ✅ 错误代码 (errors.md)
  • ✅ 引言概述 (intro.md)

[未来计划] 📅​

计划中的功能​

Q1 2026​

  • 多资产抵押品支持 (USDC, ETH)
  • 跨保证金模式
  • 子账户系统
  • API Key 管理

Q2 2026​

  • 策略交易（网格、DCA等）
  • Copy Trading
  • 社交交易功能
  • 移动端 App

长期规划​

  • 链上订单簿（完全去中心化）
  • Layer 2 扩展
  • 更多交易对
  • 衍生品多样化（期权、结构化产品）

历史版本​

v1.0.0 (2024-12-01) - 初始版本​

核心功能​

  • 永续合约交易
  • 杠杆交易 (1-50x)
  • 限价单和市价单
  • 基础仓位管理
  • 充值提现
  • 推荐系统基础版

市场数据​

  • 实时行情
  • K线数据
  • 订单簿
  • 最新成交

账户功能​

  • 余额查询
  • 订单历史
  • 交易历史
  • 用户资料

弃用公告​

即将弃用 (2026-06-01)​

暂无

已弃用​

暂无

破坏性变更​

2025-12-26​

认证机制变更 ⚠️​

变更: Personal Sign → EIP-712 结构化签名

影响: 所有需要签名的接口

迁移指南:

旧版 (Personal Sign):

// ❌ 已弃用
const message = `${timestamp}POST/api/v1/orders`;
const signature = await signer.signMessage(message);

新版 (EIP-712):

// ✅ 推荐
const typed_data = {
  domain: { name: "ZTDX", version: "1", chainId: 421614, verifyingContract },
  types: { CreateOrder: [...] },
  message: { wallet, symbol, side, ... }
};
const signature = await signer.signTypedData(
  typed_data.domain,
  { CreateOrder: typed_data.types.CreateOrder },
  typed_data.message
);

截止日期: 立即生效

安全公告​

2025-12-26​

时间戳验证加强​

  • 所有签名请求的时间戳有效期缩短为 5 分钟
  • 超时请求将返回 TIMESTAMP_EXPIRED 错误
  • 建议始终使用最新时间戳

Nonce 机制改进​

  • Login 请求现在需要先获取 nonce
  • Nonce 递增机制防止重放攻击
  • 每次成功登录后 nonce 自动+1

性能优化​

2025-12-26​

撮合引擎优化​

  • 订单匹配延迟降低 50%
  • 峰值吞吐量提升至 10,000 TPS
  • 内存使用优化 30%

API响应时间​

  • 平均响应时间: 10ms → 5ms
  • P99 响应时间: 100ms → 50ms

WebSocket优化​

  • 推送延迟降低 60%
  • 支持的并发连接数提升 5倍
  • 消息压缩率提升 40%

已知问题​

当前版本 (2025-12-26)​

限制​

  • 单个账户最多持有 10 个活跃仓位
  • 单个交易对最多 50 个挂单
  • WebSocket 单连接最多订阅 50 个数据流

正在修复​

暂无

升级指南​

从 v1.0.0 升级到 v1.1.0​

1. 更新认证逻辑​

必须：实现 EIP-712 签名

// 安装依赖
npm install ethers@6

// 更新登录逻辑
import { BrowserProvider } from 'ethers';

async function login(address) {
  // 1. 获取 nonce 和 typed_data
  const { nonce, typed_data } = await fetch(`/api/v1/auth/nonce/${address}`)
    .then(r => r.json());
  
  // 2. EIP-712 签名
  const provider = new BrowserProvider(window.ethereum);
  const signer = await provider.getSigner();
  const signature = await signer.signTypedData(
    typed_data.domain,
    { Login: typed_data.types.Login },
    typed_data.message
  );
  
  // 3. 登录
  const { token } = await fetch('/api/v1/auth/login', {
    method: 'POST',
    body: JSON.stringify({
      address: address.toLowerCase(),
      signature,
      timestamp: parseInt(typed_data.message.timestamp)
    })
  }).then(r => r.json());
  
  return token;
}

2. 更新订单创建逻辑​

可选但推荐：利用智能保证金优化

// 平仓时无需担心保证金
async function closePosition(positionId, amount) {
  // 系统会自动识别为平仓订单
  // 只需手续费，无需额外保证金
  const order = await createOrder({
    symbol: position.symbol,
    side: position.side === 'long' ? 'sell' : 'buy',
    order_type: 'market',
    amount: amount,
    leverage: position.leverage
  });
}

3. 集成新功能​

可选：添加止盈止损

// 开仓后设置TP/SL
const position = await getPositions();

await setPositionTPSL(position.id, {
  take_profit_price: "70000",
  stop_loss_price: "60000"
});

反馈与支持​

报告问题​

如果您发现 bug 或有功能建议，请通过以下渠道联系我们：

获取帮助​

最后更新: 2025-12-26
版本: v1.1.0
状态: 稳定