# Binance 交易功能文档

## 📋 功能文档

### 核心交易功能

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

### 交易参数说明

- **[`positionSide_explanation.md`](./positionSide_explanation.md)** - 仓位方向详解

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

- **[`timeInForce_explanation.md`](./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

### 环境配置

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

## 🚀 快速使用

### 基础下单示例

```typescript
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',
})
```

### 仓位管理

```typescript
// 查看当前仓位
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 官方文档](https://binance-docs.github.io/)
- [Binance Node.js SDK](https://github.com/binance/binance-connector-node)
- [交易规则说明](https://www.binance.com/en/trade-rule)