熊猫寨熊猫寨PANDAZHAI
PANDAZHAI / DOCUMENTATION

价差高频套利
从接入,到有序运行。

一个节点,连接多个交易平台。
按顺序完成部署、账户接入与策略配置,在同一工作台管理行情、订单和持仓。

01

一个节点,连接多个交易平台

选择你实际使用的平台,其余组合由共同标的自动生成。

01 / CONNECT

选择平台

接入页目前展示 7 家平台,至少启用 2 家。只配置你要使用的账户。

02 / COMPARE

筛选共同标的

按已开启的平台筛选共同市场,一个节点管理一个标的,各平台组合独立设置目标。

03 / EXECUTE

统一调度与对账

每轮选择符合条件的机会,一组订单执行并完成核验后,再调度其他组合。

开始前准备

一台 Linux x86_64 服务器、可用的交易账户与 API 密钥、身份验证器。当前工具点击启动后提交真实订单;暂停新增交易不等于平仓。

02

安装节点,绑定管理中心

默认外部端口 9100。安装、常规更新使用同一条命令。

  1. 准备服务器与网络

    登录 Ubuntu 服务器的终端,在云安全组和系统防火墙中允许管理中心访问 TCP 9100。内部策略端口 18000 无需对外开放。

  2. 运行安装命令

    安装 / 更新 · Linux x86_64
    curl -fsSL https://raw.githubusercontent.com/lihanyu81/PandaZhai-Arbitrage-Tool/main/install.sh | sudo bash -s -- four-arbitrage --port 9100

    安装完成后绑定终端显示的节点 2FA。保留配置、账本的常规升级不需要先清空。

  3. 添加到管理中心

    返回套利节点,点击“添加节点”,填写节点名称、服务器 IP、端口 9100 和当前节点验证码。工具类型自动识别。

节点验证码

来自安装时绑定的节点身份验证器,用于添加节点。不是管理中心登录验证码。

管理中心验证码

来自管理中心账户的身份验证器,登录管理中心、保存交易账户配置时使用。

安装时没看到二维码,如何重新查看?
重新显示节点 2FA
sudo -u panda-four /opt/pandazhai/four/panda-node node --tool four-arbitrage --tool-executable /opt/pandazhai/four/panda-four --data-dir /var/lib/pandazhai/four --init-only --show-qr

请在自己的终端查看,不要公开二维码或手动密钥。

03

接入你的交易平台

邀请码与政策如下;展开卡片查看该平台的账户配置要点。

Entropy

前往 ↗
邀请码
pandazhai
政策
T4权限母账号,返佣100%
账户配置要点

填写账户地址和 Agent 私钥。确认 Agent 已获得对应账户的交易授权。

Lighter

前往 ↗
邀请码
CHOU
政策
Lighter Premium手续费返佣10%
账户配置要点

填写 Account Index、API Key Index 和 API Private Key。账户编号不是钱包地址,API Key Index 也不是账户编号。

Robinhood Lighter

前往 ↗
邀请码
PANDAZHAI
政策
无
账户配置要点

使用 Robinhood Lighter 对应网络的账户和 API 配置,不要混用 Lighter 主网密钥。

邀请码
联系臭臭panda
政策
返佣10%
账户配置要点

填写 Public Key、Secret Key,按账户情况填写可选的子账户 ID。

邀请码
PANDAZHAI
政策
返佣40%
账户配置要点

填写 Orderly Account ID、Orderly Key 和 Orderly Secret;读取行情也需要 Account ID。

邀请码
PANAZHAI
政策
返佣10%
账户配置要点

填写账户地址、子账户 Index、API Key 和 API Signing Key。密钥适用的子账户必须与资金所在的子账户一致。

保存 → 校验 → 检查账户

在“平台接入”勾选平台并填入账户信息,保存后点击“校验账户与 API 接入”。确认读取的余额、仓位属于你准备交易的账户,再配置策略。当前节点不做邀请白名单校验。

同一钱包下的子账户相互独立。尤其是 Arcus:API Key、签名私钥和子账户 Index 必须相互对应;读取到公开账户数据并不代表拥有交易权限。

04

选择共同标的,设置交易目标

以盘口买一、卖一计算信号,采用滑动均值策略。

  1. 刷新共同市场

    保存已启用的平台后,刷新共同市场,选择所有已启用平台共同支持的标的。根据页面提示设置每步数量,满足共同最小数量和数量步长。

  2. 按组合设置目标 bps

    为不同平台组合分别设置目标。没有单独填写的组合使用统一目标。1 bps = 0.01%;信号计算不扣手续费。

  3. 设置滑动窗口和预热样本

    窗口决定参与均值计算的样本范围,预热决定至少积累多少样本才可判断入场。先等待行情链路正常、样本预热完成。

  4. 设置每个平台的 STEP 上限

    STEP 按该平台实际净仓位除以统一每步数量计算。正数为多仓,负数为空仓;达到正负上限后,只允许减少该方向仓位。

READ THE SIGNAL

怎么看“下单信号”?

每个方向使用当前价差与反方向历史平均价差计算信号,统一换算为 bps。组合醒目值展示两个方向中较高的信号。

示例 · 买 B / 卖 A2.36 bps

目标 2.30 bps

信号达标,继续检查执行条件

达到目标不代表必然提交订单。调度还会检查行情链路、账户风险、STEP 限制、正在执行的订单,并在提交前复核信号。第一档数量不足不再直接拦截,实际成交仍受滑点价格限制。

检查后再启动

确认标的、每步数量、各平台步数和组合目标,再点击启动交易。策略会使用已配置的真实账户。点击矩阵方格,可在右侧观察相应方向的走势图。

05

看懂持仓,处理需要恢复的记录

订单回报与真实账户仓位一起核验,不只看订单状态。

平台实际净仓位

展示各平台的实际仓位与风险指标。Lighter 等平台显示强平距离;Arcus 显示账户保证金缓冲,不能把两者当作同一个指标。

可在平台风险设置中调整对应的百分比下限。

账户权益变化

总览收益 = 当前账户权益合计 − 基准权益合计。重设基准后从新基准计算,充提和同账户其他交易也会影响结果。

累计成交量根据历史订单中的实际成交估算。

短暂数据等待,需要手动恢复吗?

账户或风险数据暂缺时,节点暂停新增交易并自动重试;恢复后可继续调度。手动暂停、仓位不一致或未确认订单需要处理,不能通过重复启动跳过。

一条腿失败,已经手动补单,如何关联?

先暂停新增交易,确认原请求不会继续成交。在“持仓与恢复”的需要处理记录旁,点击“关联手动补单”,按时间、方向、数量和均价选择实际成交,再预览并确认。

无需从 Arcus 前端寻找订单号。当前支持 Arcus 失败开仓腿的完整补单;系统会核验成交、挂单和所有平台实际仓位,关联后保持暂停,核对完成后由你恢复。

暂停、停止服务和清空,分别会发生什么?

暂停新增交易后仍监控已有持仓风险;STEP 反向减仓需要恢复调度。停止服务器服务会停止节点运行,删除程序或账本也不会替你平掉交易所仓位。

06

更新与维护

优先保留配置、2FA 与账本;清空不用于普通更新。

常规更新

先暂停新增交易,等待订单执行和对账完成,再运行上方安装 / 更新命令。更新后检查版本、实际仓位与未确认订单,再手动恢复。

查看服务状态
sudo systemctl status panda-four.service --no-pager
查看最近日志
sudo journalctl -u panda-four.service -n 100 --no-pager
清空节点并重新安装

不可恢复:先处理交易所仓位和挂单,并保留所需备份。以下命令删除程序、配置、账本和节点 2FA,不会自动平仓。

清空 · 确认不再需要节点数据后执行
sudo systemctl disable --now panda-four.service
sudo rm -f -- /etc/systemd/system/panda-four.service
sudo rm -rf -- /etc/systemd/system/panda-four.service.d
sudo rm -rf -- /opt/pandazhai/four /var/lib/pandazhai/four
sudo systemctl daemon-reload

迁移备份仍保留在 /var/backups/pandazhai-four。重新安装后绑定新显示的节点资料,并在管理中心检查节点绑定。

一键清除全部旧版一对一节点

适用于官方安装脚本部署的 Entropy、PopDEX、Robinhood Lighter、Vanta、Arcus、Decibel、QFEX 七类一对一节点。先在交易所处理好相关仓位和挂单,并自行备份需要保留的数据。

不可恢复:执行后会停止七类旧服务并删除各自的程序、配置、数据库、注册资料与 2FA。停止服务或删除程序不会自动平仓。自定义安装路径或手动启动的其他程序不在本指令清除范围内。

保留:当前价差高频套利多平台节点(panda-four)、管理中心以及 /var/backups 下的独立备份目录。旧节点程序目录内的文件会一并删除。管理中心中的旧节点列表记录需自行移除。

仅清除旧一对一节点
sudo bash <<'PANDA_CLEAR_LEGACY'
set -euo pipefail
legacy_nodes=(entropy popdex rblighter vanta arcus decibel qfex)

# 先停止全部旧节点;任一服务停止失败则中止,不删除数据。
for node in "${legacy_nodes[@]}"; do
  unit="panda-${node}.service"
  state=$(systemctl show "$unit" --property=LoadState --value)
  if [[ "$state" != "not-found" ]]; then
    systemctl disable --now "$unit"
    if systemctl is-active --quiet "$unit"; then
      echo "旧服务仍在运行,已中止:$unit" >&2
      exit 1
    fi
  fi
done

# 固定名单清除;不匹配或删除 four、管理中心及备份目录。
for node in "${legacy_nodes[@]}"; do
  rm -f -- "/etc/systemd/system/panda-${node}.service"
  rm -rf -- "/etc/systemd/system/panda-${node}.service.d" "/opt/pandazhai/${node}" "/var/lib/pandazhai/${node}"
done
systemctl daemon-reload
echo '七类旧一对一节点已清除;多平台节点与备份目录保留。'
PANDA_CLEAR_LEGACY
07

遇到问题,先看这里

用具体状态定位问题,避免重复下单或清空重装。

工具界面转发失败:All connection attempts failed

检查节点服务、服务器网络与 9100 端口访问,再查看服务日志。管理中心能显示节点,不代表内部工具进程已经正常启动;不要通过清空交易记录处理连接故障。

Arcus 校验失败,但 API Key 看起来正确

核对密钥注册状态、有效期、签名配对和子账户范围。若接口返回“this account has no activity yet”,代表该子账户尚无可读取的活动数据;确认资金所在子账户,不要只改编号去配另一账户的密钥。

为什么一直等待完整盘口?

订阅需要先获得完整盘口才能计算。盘口不变时没有新消息,并不等于连接失效;节点还会检查连接、心跳和订阅状态。持续等待时查看对应平台的连接提示与日志。

信号超过目标,为什么没有成交?

先看组合下方的具体提示和执行事件,再看全局是否暂停、是否存在其他执行、账户风险数据和 STEP 是否允许该方向。订单提交后,还需等交易所成交及自动对账确认。