OANDA v20 Python 示例项目教程

OANDA v20 Python 示例项目教程

1. 项目的目录结构及介绍

OANDA v20 Python 示例项目的目录结构如下：

v20-python-samples/
├── requirements.txt
├── src/
│   ├── configure.py
│   ├── market_order_full_example.py
│   └── account/
│       └── details.py
├── .gitignore
├── LICENSE.txt
├── Makefile
├── README.md
└── setup.py

目录结构介绍

• requirements.txt: 项目依赖的Python包列表。
• src/: 包含所有示例代码的源文件夹。
  • configure.py: 用于创建或更新v20配置文件的脚本。
  • market_order_full_example.py: 一个不使用v20配置文件的有限市场订单示例。
  • account/: 包含与账户相关的示例代码。
    • details.py: 获取当前活跃账户详细信息的示例。
• .gitignore: Git忽略文件列表。
• LICENSE.txt: 项目许可证。
• Makefile: 用于设置虚拟环境的Makefile。
• README.md: 项目说明文档。
• setup.py: 用于设置项目的脚本。

2. 项目的启动文件介绍

项目的启动文件主要是src目录下的各个Python脚本。以下是一些关键的启动文件及其功能：

• src/configure.py: 用于创建或更新v20配置文件的脚本。
• src/market_order_full_example.py: 一个不使用v20配置文件的有限市场订单示例。
• src/account/details.py: 获取当前活跃账户详细信息的示例。

启动文件介绍

• v20-configure: 用于创建或更新v20配置文件的命令行工具。
• v20-market-order-full-example: 一个不使用v20配置文件的有限市场订单示例。
• v20-account-details: 获取当前活跃账户详细信息的命令行工具。

3. 项目的配置文件介绍

项目的配置文件是一个YAML文件，用于存储与OANDA v20系统连接所需的配置信息。配置文件的格式如下：

hostname: api-fxpractice.oanda.com
streaming_hostname: stream-fxpractice.oanda.com
port: 443
ssl: true
token: e6ab562b039325f12a026c6fdb7b71bb-b3d8721445817159410f01514acd19hbc
username: user
accounts:
  - 101-001-100000-001
  - 101-001-100000-002
active_account: 101-001-100000-001

配置文件介绍

• hostname: OANDA API的主机名。
• streaming_hostname: OANDA流API的主机名。
• port: 连接端口。
• ssl: 是否使用SSL加密。
• token: API访问令牌。
• username: 用户名。
• accounts: 账户列表。
• active_account: 当前活跃账户。

配置文件可以通过src/configure.py脚本生成，该脚本会以交互方式引导用户生成配置文件。