Crypto Paper Wallet

Binance USDⓈ-M 永续合约模拟钱包 REST 服务。

特性

• 全仓保证金（Cross Margin）
• 双向持仓（Hedge Mode）
• 多币种同时持仓（BTC / ETH / SOL）
• Mark Price 驱动浮盈与清算
• L2 订单簿滑点模型
• 完整订单类型：市价/限价/止损/止盈
• SQLite 本地持久化
• 对接 market-data（:8765）实时拉取 tick

快速开始

# 终端 1：行情服务
cd ~/market-data && ./scripts/run_server.sh

# 终端 2：模拟钱包
cd ~/crypto-paper-wallet
pip install -e .
./scripts/run_server.sh

打开 http://127.0.0.1:8000/docs 查看 API。

默认环境变量（run_server.sh 已配置）：

MARKET_DATA_URL=http://localhost:8765
MARKET_DATA_ENABLED=true

文档

• 设计文档
• API 文档
• 市场数据契约
• 回测集成指南

测试

pip install -e ".[dev]"
python -m pytest tests/ -v

# 深度集成测试（需两个服务均启动）
python scripts/deep_integration_test.py
# 报告: results/deep_test_report.md

项目结构

core/       钱包引擎
market/     行情接入层（ExternalMarketDataClient → market-data）
store/      SQLite 持久化
api/        FastAPI REST 服务
client/     Python SDK
docs/       文档
scripts/    启动脚本 + 深度测试
tests/      单元/集成测试