XChange 开源项目安装与使用指南

目录结构及介绍

当你克隆或下载 XChange 项目到本地后，你会看到以下主要目录：

• xchange-api: 这是 XChange 的核心API模块，定义了所有平台接口的抽象层。
• xchange-btcmarkets: 针对 BTCMarkets 等特定平台实现的具体适配器代码。
• xchange-exchangeA: 包含 ExchangeA 平台的实现细节。
• xchange-exchangeB: 提供对 ExchangeB 平台的支持。
• xchange-exchangeC: 对ExchangeC平台的接口封装。
• xchange-core: 核心功能的实现，如交易处理逻辑等。
• xchange-exchanges: 汇总了所有具体平台的适配器。
• xchange-stream-exchangeA: 特定于ExchangeA流数据的实现。
• xchange-stream-okcoin: OKCoin平台的流数据支持。
• xchange-tools: 工具类和其他辅助功能。

更多具体的子模块可以参考项目的实际结构，这里只列举了部分。

启动文件介绍

由于 XChange 是一个库而不是应用，它没有单一的"启动"入口点。但为了使用该库进行操作或者获取数据，你需要在你的应用程序中引入相应的依赖并初始化 ExchangeFactory 来创建 Exchange 实例。例如：

// 创建 Exchange 实例 (以 Binance 为例)
Exchange binance = ExchangeFactory.getExchange(BinanceExchange.class);

// 初始化 Exchange
binance.remoteInit();

// 获取当前账户余额
AccountService accountService = exchange.getAccountService();
Wallet wallet = accountService.getWallet();

System.out.println("Available Bitcoin balance: " + wallet.getCurrencyBalance(Currency.BTC));

具体哪个类作为"启动"文件取决于你要使用的平台。

配置文件介绍

XChange 使用配置文件来管理各种设置，包括API密钥、秘密以及一些高级选项。典型的配置文件（通常位于 classpath 下）可能看起来像这样：

xchange.api.key=bearer_key_here
xchange.api.secret=secret_key_here
xchange.timeout=30000 # milliseconds
xchange.request.retry.max.attempts=3

这些参数允许你在不修改代码的情况下调整库的行为。要读取这些设置，你可以使用 ExchangeSpecificationBuilder 或者直接访问 Exchange 实例中的 ExchangeSpecification。

注意，在生产环境中应确保API密钥和秘密的安全性，避免硬编码在代码中。使用外部配置文件或环境变量是个好选择。

---

以上就是基于 https://github.com/knowm/XChange.git 仓库的 XChange 开源项目的基本使用指南。希望这份文档能够帮助你更好地理解和利用此工具。