本项目今后将不再维护

我将其保留在此，是因为其中包含大量有趣的数据（数组），可供其他项目复用。

更新（2018年4月6日）：请参阅后续文章：https://medium.com/@joeldg/cryptocurrency-bot-framework-followup-3bc289322fb1

更新（2018年3月15日）：我还在，已经辞去旧工作，开始了新工作，因此一直很忙碌。本周末将恢复对Bowhead的开发。

更新（2018年2月8日）：命令可能已失效。已将项目升级至Laravel 5.6，并对Coinigy数据获取部分进行了修改。

更新（2018年1月30日）：命令可能已失效。我仍在处理Bitfinex相关问题的善后工作。简而言之，Bitfinex现已不再允许美国用户开户，而早期版本的Bowhead在数据获取方面与Bitfinex绑定较为紧密。目前的工作重点是增加对Coinigy和CCXT的支持，以便Bowhead能够兼容超过90家交易所。由于我目前有一份全职工作，还有一个一岁的儿子，时间有限，只能尽力推进开发，因此对于项目仍处于修复状态深表歉意。

当前Bowhead路线图：

1. （目前完成约20%）完成Web主页面（初始界面、图表、信号及指标）
2. 完成策略构建页面（包括回测功能、策略统计信息，并为未来的机器学习相关文章预留模块）
3. 完成策略类的开发。
   • 添加社交策略页面，支持用户上传自己的策略供社区使用，也可下载他人策略进行本地运行与回测。
4. 将现有所有Bowhead策略导入新的策略构建器中。
   • 在Web主页面中添加策略构建器的相关入口。
5. 完成Web界面中的套利页面（套利矩阵）。
   • 在套利页面中添加策略构建器的相关入口。
6. 完成设置页面，包括自动更新选项、模拟交易/实盘交易切换、提醒通知等功能。
7. 创建文档专区并添加相关链接。
8. 创建统计数据与报告页面（展示交易记录、盈亏情况、各交易所手续费明细、套利分析结果以及策略对比等）。 --然后--
9. 逐一检查并修复各个命令。
10. 重新审阅并改写Bowhead系列的三篇文章。
11. 构建基于云的Bowhead数据服务，使Bowhead无需API密钥即可从所有交易所获取历史及实时行情数据。仅当用户希望进行交易时才提供相应交易所的API密钥。
    • 更新Bowhead以接入该数据服务。
12. 制作关于Bowhead、策略等方面的YouTube视频系列。
13. 充分休息一下。

之后，我们有望启动Bowhead相关的机器学习系列内容。

更新（2018年1月26日）：大幅优化了Web配置，并验证其可与Postgres数据库及Timescale的超表（http://timescale.com）协同工作。

更新（2018年1月8日）：官方Docker容器预览版发布，包含部分Web配置。该容器采用Alpine Linux + Nginx + PHP 7.1，搭配MariaDB和Redis。……目前仍处于开发阶段，但未来它将能够连接到Coinigy或用户的CCXT账户，并根据Web界面中选择的交易对将行情数据抓取并存储到数据库中。

docker pull joeldg/bowhead

docker run -d -p 8080:8080 joeldg/bowhead

打开 http://localhost:8080/setup

请注意，由于需要执行Composer更新，容器启动会稍显缓慢。待容器启动后，可通过 http://{IP}:8080/setup 访问初始化页面。

更多信息请访问：https://github.com/joeldg/bh_docker
无论正面还是负面反馈，都欢迎通过下方Gitter链接与我们交流。

bowhead

一个基于REST API和控制台的加密货币交易机器人模板及框架 由Joel De Gan编写，2017年

Bowhead（一种鲸鱼）是Laravel框架中用于构建加密货币和外汇自动化交易系统的代码模板代号。

通过使用RESTful API，Bowhead可以作为中间层，让你喜爱的编程语言与多家经纪商和做市商进行对接，只需添加你的API密钥即可。

Bowhead利用了PHP Trader扩展中实现的所有TALib函数，并在此基础上创建了一些由TALib指标组合而成的自定义指标。

项目重点。

本项目的首要目标是提供一个易于使用的模板/框架，使你能够快速搭建一个功能完善的交易系统，应用于各种策略，在通常不需要“实名认证”的BTC资金交易平台进行交易。这样你就可以直接使用平台上的资金进行交易，而无需通过银行转账，从而避免一些潜在的税务问题（具体取决于你所在的国家）。

配套文章

该项目有一篇配套文章，详细介绍了如何设置并运行你的第一个交易策略，分别在Whaleclub和1Broker上执行。你需要在这两个平台上都开设账户。此外，还推荐以下交易所：

• Binance
• Coinbase/GDAX
• Kraken
• CEX

同时，也正在加入对Coinigy（免费试用1个月）的支持。

配套文章发表在Medium上，分为三部分：

第1部分：让我们编写一个加密货币机器人（第1部分）。

第2部分：让我们编写一个加密货币机器人（第2部分）

第3部分：让我们编写一个加密货币机器人（第3部分）

强烈建议你仔细阅读并按照步骤操作，以便顺利启动和运行。

基本设置

你需要：

• PHP 7.1
• Redis
• MySQL
• PHP Pecl Trader扩展，

对于Python，则需要dotenv包：

pip install python-env

注意事项

该项目最初是在Laravel-Lumen（轻量级）框架下开发的。然而，为了将其转变为完全开源的模板/框架，我认为保留Laravel的完整功能非常重要，尤其是Jobs和其他使用队列的功能模块，可能会非常有用。

Bowhead是在Mac上编写和测试的，目前我已将其部署在AWS的Ubuntu Linux服务器上运行，每天都在加密货币市场、外汇交易对以及二元期权市场上进行真实的资金交易。

在Windows上运行时，可能会遇到的一个限制是实时传递Python与PHP之间数据所使用的命名管道。不过，可以通过Redis或将输出重定向到解析器等方式来解决这个问题。

我欢迎任何关于如何在Windows上运行该程序的建议。

关于编辑器的说明。

我还想补充一点，当你使用Laravel进行开发时，几乎必须使用像PHPStorm这样的编辑器。虽然也可以使用Atom之类的工具，但这就好比用记事本去开发.NET项目一样——技术上或许可行，但过程会非常痛苦，体验也不会好。因此，我强烈推荐PHPStorm。他们提供免费试用版，并且每次更新都会延长试用期。即便最终决定购买，它的价格也非常合理。

其他库

我还添加了几款我喜欢使用的实用库。

• Console类：用于在控制台中实现彩色输出、进度条和文本表格等功能，效果如下所示。

 ╔═══════════════════════════════════════════════╗
 ║ BTC    │                                      ║
 ║ LTC    │                                      ║
 ╚════════╧══════════════════════════════════════╝

如果你愿意打赏，请发送BTC至：

14d9xxG1h5DkaDihiDBwzp5nj82dTcWfHc

已完成：

1. 编写自己的Coinbase、Whaleclub和1Broker封装类。
2. 创建TALib指标封装类。
3. 创建TALib蜡烛图封装类。
4. 将控制台相关功能整合到一个Console类中。
5. 实现Oanda的数据流接入。
6. 实现Bitfinex的数据流接入。
7. 完成并测试了Dockerfile一键部署脚本。
8. 信号模块。
9. 策略模块。
10. REST映射模块。

进行中：

1. REST API开发。
2. 编写自己的Oanda、Bitfinex和Poloniex API封装类。

待办事项：

1. 统一各交易所的调用接口，使方法名称在所有交易所中保持一致。
2. 构建报告、日志记录和回测工具。

Bowhead 加密货币交易机器人框架快速上手指南

⚠️ 重要提示：本项目作者已声明不再维护。代码库中保留了许多可复用的有趣数据（如指标数组），适合用于其他项目的参考或二次开发。部分命令可能因版本更新（如升级至 Laravel 5.6）而失效，使用前请做好调试准备。

Bowhead 是一个基于 Laravel 构建的 REST API 和控制台驱动的加密货币及外汇自动交易机器人样板框架。它集成了 TA-Lib 技术指标库，支持通过 CCXT 连接全球 90+ 交易所。

1. 环境准备

系统要求

• 操作系统：推荐 Linux (Ubuntu) 或 macOS。
  • 注意：Windows 运行可能存在兼容性问题（特别是 PHP 与 Python 间的命名管道通信），建议通过 Docker 或 WSL 运行。
• 核心依赖：
  • PHP 7.1+
  • Redis
  • MySQL 或 PostgreSQL (推荐配合 TimescaleDB 使用)
  • PHP Pecl Trader 扩展 (TA-Lib 的 PHP 绑定)

前置依赖安装

若选择手动安装（非 Docker 方式），需确保以下组件就位：

# 安装 PHP Trader 扩展 (以 Ubuntu 为例，需先安装 ta-lib C 库)
sudo apt-get install libta-lib-dev
pecl install trader

# Python 环境依赖 (如需运行相关脚本)
pip install python-env

💡 国内加速建议：

• Composer: 使用阿里云镜像 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• PyPI: 使用清华源 pip install -i https://pypi.tuna.tsinghua.edu.cn/simple python-env
• Docker: 配置 Docker Hub 国内加速器（如阿里云、腾讯云容器镜像服务）。

2. 安装步骤

推荐使用 Docker 方式进行部署，这是最简便且经过验证的方法，可避免复杂的环境配置问题。

步骤一：拉取镜像

docker pull joeldg/bowhead

步骤二：运行容器

启动容器并将端口映射到本地 8080：

docker run -d -p 8080:8080 joeldg/bowhead

步骤三：初始化配置

容器启动后需要执行 composer update，首次启动可能需要等待几分钟。待服务就绪后，在浏览器访问设置页面：

http://localhost:8080/setup

(若在服务器运行，请将 localhost 替换为服务器 IP)

在网页界面中完成数据库连接、交易所 API Key (支持 Coinigy 或 CCXT) 的配置。

3. 基本使用

Bowhead 的核心在于策略构建与信号执行。配置完成后，主要通过以下方式交互：

方式 A：Web 界面操作

访问 http://localhost:8080 (配置完成后)，您可以：

1. 查看行情：监控选定的交易对实时数据。
2. 管理策略：上传或下载社区策略，进行回测。
3. 套利矩阵：查看不同交易所间的价差机会。

方式 B：控制台命令 (CLI)

注意：由于项目停止维护且经历过框架升级，以下命令可能需要根据实际代码结构调整。

在项目根目录下，通常可以通过 Artisan 命令运行策略或查看状态：

# 示例：运行特定的交易策略 (具体命令名需参考源码 app/Console/Commands)
php artisan bowhead:run_strategy --name=your_strategy_name

# 示例：查看实时信号
php artisan bowhead:signals

开发自定义策略

Bowhead 旨在作为样板框架，开发者可复用其 Indicators 和 Candles 封装类：

1. 利用内置的 TA-Lib 包装器计算技术指标。
2. 继承基础的 Strategy 类编写逻辑。
3. 利用 Console 类输出格式化的终端表格：

 ╔═══════════════════════════════════════════════╗
 ║ BTC    │  Buy Signal Detected                ║
 ║ LTC    │  Hold                               ║
 ╚════════╧══════════════════════════════════════╝

---

更多详细教程可参考原作者在 Medium 发布的系列文章（英文）：Part 1, Part 2, Part 3。