binance-api/docs/api/README.md

API 参考文档

📋 支持的交易所 API

🌊 Pacifica DEX

• 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 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 生态)

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

Aster (Ethereum 生态)

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

Binance (传统CEX)

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

🚀 快速开始

1. 环境配置

# 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. 测试连接

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

3. 集成开发

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: 按权重计算, 详见官方文档

---

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