binance-api/docs/binance

Binance 交易功能文档

📋 功能文档

核心交易功能

• openPosition_usage.md - 开仓功能详细使用说明
  • 支持的订单类型和参数
  • 开仓示例代码
  • 错误处理和最佳实践

交易参数说明

• positionSide_explanation.md - 仓位方向详解

  • LONG/SHORT 仓位概念
  • 双向持仓模式
  • 仓位管理策略

• timeInForce_explanation.md - 订单时效类型

  • GTC (Good Till Cancelled)
  • IOC (Immediate Or Cancel)
  • FOK (Fill Or Kill)
  • 各类型使用场景

🔌 集成状态

支持的交易类型

• ✅ 现货交易: 买卖现货资产
• ✅ 期货交易: 永续合约和交割合约
• ✅ 杠杆交易: 支持多倍杠杆
• ✅ 订单管理: 下单、撤单、查询

适配器实现

• 位置: src/exchanges/binance/
• 主要文件:
  • BinanceAdapter.ts - 统一适配器接口实现
  • FutureConnector.ts - 期货交易连接器
  • 使用官方 Binance Node.js SDK

环境配置

BINANCE_API_KEY=your_api_key
BINANCE_SECRET_KEY=your_secret_key
BINANCE_TESTNET=false  # 是否使用测试网

🚀 快速使用

基础下单示例

import { BinanceAdapter } from '../src/exchanges/binance/BinanceAdapter'

const adapter = new BinanceAdapter({
  apiKey: process.env.BINANCE_API_KEY,
  apiSecret: process.env.BINANCE_SECRET_KEY,
})

// 下市价单
const marketOrder = await adapter.placeOrder({
  symbol: 'BTCUSDT',
  side: 'BUY',
  type: 'MARKET',
  quantity: '0.001',
})

// 下限价单
const limitOrder = await adapter.placeOrder({
  symbol: 'BTCUSDT',
  side: 'BUY',
  type: 'LIMIT',
  quantity: '0.001',
  price: '50000',
  timeInForce: 'GTC',
})

仓位管理

// 查看当前仓位
const positions = await adapter.positions()

// 设置杠杆
await adapter.setLeverage('BTCUSDT', 10)

// 查询余额
const balances = await adapter.balances()

📊 功能特性

订单类型支持

• ✅ 市价单 (MARKET)
• ✅ 限价单 (LIMIT)
• ✅ 止损单 (STOP_MARKET)
• ✅ 止损限价单 (STOP_LIMIT)
• ✅ 追踪止损 (TRAILING_STOP_MARKET)

高级功能

• ✅ 批量下单: 支持批量操作
• ✅ OCO订单: One-Cancels-Other
• ✅ 条件单: 支持各种触发条件
• ✅ 算法交易: 支持 TWAP、VP 等策略

WebSocket 实时数据

• ✅ 价格推送: 24小时价格变化
• ✅ 订单簿: 实时买卖盘
• ✅ 成交数据: 最新成交记录
• ✅ 账户更新: 余额和仓位变化
• ✅ 订单更新: 订单状态实时推送

⚠️ 注意事项

风险管理

• 始终设置合适的止损位
• 控制单笔交易金额
• 监控账户风险指标
• 避免过度杠杆

技术限制

• 遵守 API 频率限制
• 正确处理网络异常
• 实施订单状态监控
• 定期检查账户状态

合规要求

• 遵守当地法律法规
• 完成必要的 KYC 验证
• 注意税务申报要求
• 关注监管政策变化

---

📚 更多资源:

• Binance API 官方文档
• Binance Node.js SDK
• 交易规则说明