# API 参考文档

## 📋 支持的交易所 API

### 🌊 Pacifica DEX

- **[`PACIFICA_API_REFERENCE.md`](./PACIFICA_API_REFERENCE.md)** - 完整 API 参考
  - **Base URL**: `https://api.pacifica.fi`
  - **WebSocket**: `wss://ws.pacifica.fi/ws`
  - **认证**: Ed25519 签名 (Solana 标准)
  - **端点数量**: 30+ REST 端点
  - **WebSocket订阅**: 8 种实时数据类型

### 🎯 Aster DEX

- **[`aster-finance-futures-api-v3_CN.md`](./aster-finance-futures-api-v3_CN.md)** - Aster API 完整文档
  - **Base URL**: `https://fapi.asterdex.com`
  - **WebSocket**: `wss://fstream.asterdex.com`
  - **认证**: EIP-191 签名方案
  - **功能**: 永续期货交易

### 🟡 Binance

- **官方文档**: https://binance-docs.github.io/
- **SDK集成**: 使用官方 Node.js SDK
- **支持**: 现货和期货交易

## 🔧 API 集成状态

| 交易所   | REST API | WebSocket | 认证 | 订单类型          | 状态        |
| -------- | -------- | --------- | ---- | ----------------- | ----------- |
| Pacifica | ✅       | ✅        | ✅   | Market/Limit/Stop | 🟢 生产就绪 |
| Aster    | ✅       | ✅        | ✅   | Market/Limit      | 🟢 生产就绪 |
| Binance  | ✅       | ✅        | ✅   | 全支持            | 🟢 生产就绪 |

## 📊 API 功能对比

### 基础功能

- **账户信息**: 全部支持
- **余额查询**: 全部支持
- **仓位管理**: 全部支持
- **订单管理**: 全部支持

### 高级功能

- **子账户**: Pacifica ✅, Aster ❌, Binance ✅
- **杠杆交易**: 全部支持
- **止损单**: Pacifica ✅, Aster ⚠️, Binance ✅
- **批量操作**: Pacifica ✅, Aster ❌, Binance ✅

### 实时数据

- **价格推送**: 全部支持
- **订单簿**: 全部支持
- **成交记录**: 全部支持
- **账户更新**: 全部支持
- **K线数据**: 全部支持

## 🔐 认证方式对比

### Pacifica (Solana 生态)

```javascript
// Ed25519 签名
const signature = nacl.sign.detached(new TextEncoder().encode(message), privateKeyBytes)
```

### Aster (Ethereum 生态)

```javascript
// EIP-191 签名
const signature = await signer.signMessage(message)
```

### Binance (传统CEX)

```javascript
// HMAC-SHA256
const signature = crypto.createHmac('sha256', secretKey).update(message).digest('hex')
```

## 🚀 快速开始

### 1. 环境配置

```bash
# Pacifica
PACIFICA_ACCOUNT=your_account_id
PACIFICA_ACCOUNT_PRIVATE_KEY=your_private_key

# Aster
ASTER_ORDER_USER=your_user_address
ASTER_API_KEY=your_api_key
ASTER_API_SECRET=your_api_secret

# Binance
BINANCE_API_KEY=your_api_key
BINANCE_SECRET_KEY=your_secret_key
```

### 2. 测试连接

```bash
# 测试各个交易所连接
yarn test:pacifica
yarn test:aster:adapter
yarn test:binance
```

### 3. 集成开发

```typescript
import { AdapterFactory } from './src/exchanges/AdapterFactory'

// 创建适配器
const adapter = await AdapterFactory.createFromEnv('pacifica')

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

// 下单
const order = await adapter.placeOrder({
  symbol: 'BTCUSDT',
  side: 'BUY',
  type: 'LIMIT',
  quantity: '0.1',
  price: '50000',
})
```

## 📈 性能指标

### API 响应时间 (平均)

- **Pacifica**: ~200ms
- **Aster**: ~150ms
- **Binance**: ~100ms

### WebSocket 连接

- **建立时间**: 1-3秒
- **心跳间隔**: 30秒
- **自动重连**: 支持指数退避

### 速率限制

- **Pacifica**: 1000次/分钟 (公开), 500次/分钟 (私有)
- **Aster**: 100次/分钟
- **Binance**: 按权重计算, 详见官方文档

---

💡 **提示**: 建议在生产环境使用前，先在测试网络充分验证所有功能。
