跳到主内容

如何使用 Jupyter Notebook (Python) 在 WOO X Pro 进行量化交易

Karol
更新

Jupyter Notebook 是一款深受数据科学家和量化交易员喜爱的开源 Web 应用程序。它允许您创建和共享包含实时代码、方程、可视化图表和说明文本的文档。

随着 WOO X Pro OpenAPI 的正式上线，专业交易员现在可以使用 Python 和 Jupyter Notebook 轻松连接至我们的核心撮合引擎，进行市场数据抓取、策略回测以及自动化交易执行。

本教程将指导您如何配置环境，并编写您的第一个 WOO X Pro API 脚本。

第一步：获取 WOO X Pro API 密钥

在通过代码与平台交互之前，您需要生成专属的 API Key 和 API Secret。

  1. 登录您的 WOO X Pro 账户。
  2. 前往 API 管理 页面。您可以直接点击查阅详细的申请指南：WOO X Pro API 密钥申请与配置说明
  3. 点击 创建 API。出于安全考虑，建议您在此步骤中绑定受信任的 IP 地址。
  4. 妥善保存您的 API Key 和 API Secret。
    ⚠️ 安全警告： API Secret 仅在创建时显示一次。请勿将其泄露给任何人，也不要将其硬编码并上传至公开的 GitHub 仓库中。

第二步：安装 Python 与 Jupyter Notebook

如果您尚未安装相关环境，我们推荐您安装 Anaconda，它内置了 Python、Jupyter Notebook 以及大多数常用的数据科学库。

如果您已经安装了 Python，可以直接打开命令行/终端，使用 pip 进行安装：

Bash

pip install jupyter
pip install requests

(注：requests 库用于向 WOO X Pro 服务器发送 HTTP 请求)

安装完成后，在终端输入以下命令启动 Jupyter Notebook：

Bash

jupyter notebook

您的默认浏览器将自动打开 Jupyter 的本地仪表盘。点击右上角的 New -> Python 3，创建一个新的笔记本。

第三步：在 Jupyter 中编写 WOO X Pro 测试脚本

在新建的 Notebook 单元格（Cell）中，您可以直接编写 Python 代码来调用 WOO X Pro 的 OpenAPI。

示例 1：获取公共市场数据（无需鉴权）

这是最基础的测试，用于获取当前 BTC/USDT 交易对的最新市场价格。将以下代码粘贴到单元格中并运行（点击 Run 或按 Shift+Enter）：

Python

import requests

# WOO X Pro 基础 API URL (请参考官方 API 文档获取最新基址)
BASE_URL = "https://api.wooxpro.com"  # 示例地址，具体请参考 API 文档

def get_market_price(symbol):
    endpoint = f"/v1/public/market_trades"
    params = {"symbol": symbol, "limit": 1}
    
    try:
        response = requests.get(BASE_URL + endpoint, params=params)
        data = response.json()
        if data.get("success"):
            latest_trade = data["rows"][0]
            print(f"【WOO X Pro】{symbol} 最新成交价: {latest_trade['executed_price']} USDT")
        else:
            print("数据获取失败:", data)
    except Exception as e:
        print("网络请求错误:", e)

# 执行函数
get_market_price("SPOT_BTC_USDT")

示例 2：使用 API Key 查询账户信息（需要鉴权）

要执行查询余额或下单等私有操作，您需要在 HTTP 请求头（Headers）中加入数字签名。具体的加密签名算法（HMAC SHA256）请严格参考 WOO X Pro 开发者文档。

在 Jupyter 中测试私有接口时，建议从只读（Read-Only）权限的 API Key 开始测试，确保代码逻辑无误后，再开启交易（Trade）权限。

第四步：安全与最佳实践

作为机构级交易平台，WOO X Pro 强烈建议您在自动化交易中遵循以下安全规范：

  1. 环境变量管理： 永远不要在 .ipynb 笔记本文件中明文写出您的 API Secret。请使用 Python 的 os.environ 或 .env 文件来加载您的密钥。
  2. 只读测试： 在开发和回测策略阶段，请使用未开启“允许交易”和“允许提现”权限的 API Key。
  3. IP 白名单： 务必为您的生产环境 API Key 绑定静态 IP 地址。如果未绑定 IP 白名单，密钥的有效期和权限可能会受到系统风控的限制。

如果您在连接 API 时遇到技术问题，请随时联系我们的技术支持团队，或查阅完整的 WOO X Pro 开发者文档 以获取详细的接口路由、频率限制（Rate Limits）和错误码说明。

由 Zendesk 提供技术支持