binance-api/API_SUMMARY.md

API 集成总结

Pacifica DEX API 核心特性

🔗 基本信息

• Base URL: https://api.pacifica.fi
• WebSocket: wss://ws.pacifica.fi/ws
• 认证: Ed25519 签名 (Solana 标准)
• SDK: Python SDK 可用

📊 主要功能分类

1. 市场数据 (6个端点)

GET /api/v1/info           # 市场信息
GET /api/v1/prices         # 价格数据
GET /api/v1/book          # 订单簿
GET /api/v1/trades        # 历史交易
GET /api/v1/kline         # K线数据
GET /api/v1/funding       # 资金费率

2. 账户管理 (8个端点)

POST /api/v1/account/info      # 账户信息
POST /api/v1/account/leverage  # 杠杆设置
GET  /api/v1/account/positions # 仓位查询
GET  /api/v1/account/balance   # 余额查询
GET  /api/v1/account/trades    # 交易历史
GET  /api/v1/account/funding   # 资金历史
POST /api/v1/account/withdraw  # 提现申请
POST /api/v1/account/margin_mode # 保证金模式

3. 订单交易 (7个端点)

POST /api/v1/order/market   # 市价单
POST /api/v1/order/limit    # 限价单
POST /api/v1/order/stop     # 止损单
POST /api/v1/order/cancel   # 取消订单
POST /api/v1/order/batch    # 批量下单
GET  /api/v1/order/open     # 当前委托
GET  /api/v1/order/history  # 订单历史

4. 子账户 (2个端点)

POST /api/v1/account/subaccount/create   # 创建子账户
POST /api/v1/account/subaccount/transfer # 资金转移

📡 WebSocket 订阅 (8种类型)

订阅类型	主题格式	说明
价格	prices@all	所有交易对价格
订单簿	orderbook@BTCUSDT	指定交易对深度
交易	trades@BTCUSDT	最新成交
K线	candle@BTCUSDT@1m	K线数据
余额	balance@{account}	账户余额变化
保证金	margin@{account}	保证金状态
仓位	positions@{account}	仓位变化
订单	orders@{account}	订单状态更新

⚡ 性能限制

• REST API: 公开端点 1000次/分钟，私有端点 500次/分钟
• WebSocket: 每IP 5个连接，每连接 100个订阅
• 订单频率: 每秒 10 次下单请求

🔐 认证示例

// 签名计算
const message = `${method}${path}${timestamp}${body}`
const signature = nacl.sign.detached(new TextEncoder().encode(message), privateKeyBytes)

// 请求头
headers = {
  'Content-Type': 'application/json',
  'Pacifica-Signature': base64.encode(signature),
  'Pacifica-Timestamp': timestamp,
}

已实现的适配器功能

✅ 当前支持

• 账户信息查询
• 余额和仓位管理
• 市价单和限价单
• WebSocket 实时数据订阅
• 子账户管理
• 签名认证机制

📝 使用示例

import { PacificaAdapter } from './src/exchanges/pacifica/PacificaAdapter'

const adapter = new PacificaAdapter(client)

// 获取余额
const balances = await adapter.balances()

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

// 订阅实时数据
adapter.ws().on('depth', data => {
  console.log('订单簿更新:', data)
})

---

📚 完整文档: docs/PACIFICA_API_REFERENCE.md 🧪 测试命令: yarn test:pacifica 🔗 官方文档: https://docs.pacifica.fi/api-documentation/api