Skip to content

AlphaAILabs/perp-plugin-strategy-014

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

[014] Variational + Lighter 双平台对冲策略

English | 中文


概述

[014] Variational + Lighter 是 AlphaLabs 的高级双平台对冲交易策略插件,在 Variational 和 Lighter 两个永续合约平台之间实现智能对冲,捕捉价差机会的同时保持持仓平衡。

核心特性

  • 双平台对冲机制: Variational DEX + Lighter DEX 同步交易
  • Maker 优先策略: 降低手续费成本
  • 智能配平系统: 实时监控并自动修正两平台持仓差异
  • 拆单处理: 自动分割大订单以符合平台限制
  • 实时风控: 基于波动率和保证金比率的动态风险管理

策略机制

开仓策略

  1. Variational Maker 限价单优先

    • 在 Variational 上挂 Maker 限价单(获取更好价格)
    • 监控订单成交状态
  2. Lighter Taker 立即对冲

    • Variational 订单成交后立即在 Lighter 用 Taker 市价单对冲
    • 最小化风险敞口时间
  3. 自动配平

    • 所有订单监控完成后统一检查持仓平衡
    • 发现不平衡立即执行配平操作

平仓策略

  1. Lighter Maker 限价单优先

    • 在 Lighter 上挂 Maker 限价单(降低手续费)
    • 分轮执行,每轮平一部分持仓
  2. Variational Taker 立即对冲

    • Lighter 订单成交后立即在 Variational 用 Taker 市价单对冲
    • 支持拆单处理,确保大订单顺利执行
  3. 配平兜底

    • 每轮平仓完成后检查持仓
    • 处理对冲失败或部分成交的情况

风险控制系统

保证金监控

  • IM (Initial Margin): 初始保证金比率
  • MM (Maintenance Margin): 维持保证金比率
  • 实时监控两个平台的保证金使用情况
  • 保证金不足时拒绝开仓

持仓平衡检查

  • 每轮策略执行时检查 Variational 和 Lighter 持仓是否一致
  • 允许误差:0.0001
  • 发现不平衡立即配平(最多重试 5 次)

快速开始

前置条件

  1. Chrome 浏览器: 版本 109+
  2. AlphaLabs 账户: 在 alphalabs.app 注册
  3. Variational 账户:
    • 已创建账户并获取 API Token
    • 账户有足够的 USDC 余额
  4. Lighter 账户:
    • StarkNet 钱包私钥
    • Account Index 和 API Key Index
    • 配置 Signer Service URL
  5. AlphaLabs Signer Manager: 已安装并运行(用于 Lighter 签名)

安装步骤

  1. 下载并解压插件包
  2. Chrome 访问 chrome://extensions/
  3. 启用"开发者模式"
  4. 点击"加载已解压的扩展程序",选择插件目录
  5. 点击插件图标打开控制面板

配置 API 密钥

Variational API 配置

  1. 进入 API Keys 页面
  2. 输入 Variational Token
  3. 保存配置

Lighter API 配置

  1. 输入 Lighter Private Key(StarkNet 钱包私钥)
  2. 输入 Account Index(账户索引)
  3. 输入 API Key Index
  4. 配置 Signer Service URL(默认已填写)
  5. 保存配置

策略参数配置

进入 Strategy Settings 页面,配置以下参数:

基础参数

  • TOKEN1: 第一个交易合约(如 BTC)
  • TOKEN2: 第二个交易合约(如 ETH)
  • 订单大小: 最小/最大订单量

PNL 控制

  • MIN_PNL_VARIATIONAL_PERCENT: Variational PNL 下限(如 -5%)
  • MAX_PNL_VARIATIONAL_PERCENT: Variational PNL 上限(如 10%)
  • REQUIRED_PROFIT_RATE: 目标收益率(如 0%)

波动率阈值

  • VOLATILITY_THRESHOLD_TOKEN1: BTC 波动率阈值(如 0.1%)
  • VOLATILITY_THRESHOLD_TOKEN2: ETH 波动率阈值(如 0.05%)

执行参数

  • 策略循环间隔: 30-60 秒
  • 订单监控超时: 60 秒
  • Taker 滑点: 0.01%

使用指南

启动策略

  1. 确保 Variational 和 Lighter 账户都有足够余额
  2. 检查 API 配置正确
  3. 调整策略参数(首次使用建议用默认值)
  4. 点击"启动策略"按钮
  5. 监控 Logs 页面查看执行情况

监控运行

查看资产

  • Assets 页面显示两个平台的余额
  • 实时更新 IM/MM 比率
  • 监控可用余额

查看持仓

  • Positions 页面显示当前持仓
  • 分别显示 Variational 和 Lighter 持仓
  • 包含数量、价值、开仓均价、当前价格、清算价格

查看日志

  • Logs 页面显示详细执行日志
  • Info: 正常操作(策略循环、账户更新)
  • Success: 成功交易、平仓完成
  • Warning: 配平需求、部分成交
  • Error: 失败操作、API 错误

停止策略

  1. 点击"停止策略"按钮
  2. 策略会:
    • 撤销所有未成交订单(Variational + Lighter)
    • 清空持仓数据
    • 停止心跳验证
  3. 等待状态变为"已停止"

一键平仓

⚠️ 仅在紧急情况使用

  1. 点击"一键平仓"按钮
  2. 系统会:
    • 同时平掉 Variational 和 Lighter 所有持仓
    • 使用 Taker 市价单确保快速成交
    • 对每个合约分别执行拆单平仓
  3. 平仓完成后检查剩余持仓

注意:一键平仓在策略运行中不可用,需先停止策略。


核心参数说明

PNL 区间理解

  • MIN_PNL 和 MAX_PNL 定义的是"安全区间"
  • 在区间内:持仓保持,不平仓
  • 超出区间:触发平仓检查(还需满足总收益条件)

示例:

MIN_PNL = -5%, MAX_PNL = 10%

场景1: Variational PNL = -3% (在区间内)
→ 不触发平仓,继续持有

场景2: Variational PNL = -7% (< -5%, 超出下限)
→ 触发止损检查,如果总收益 ≥ 目标×20%,则平仓

场景3: Variational PNL = 12% (> 10%, 超出上限)
→ 触发止盈检查,如果总收益 ≥ 目标×50%,则平仓

波动率阈值作用

  • 防止频繁交易: 价格波动小时不考虑平仓
  • 节省手续费: 只在价格明显变化时才执行平仓
  • 提高策略稳定性: 避免被小幅波动干扰

强制平仓超时

  • 测试环境: 10-30 分钟(快速验证策略)
  • 生产环境: 建议 30-60 分钟

注意事项

系统要求

  • 持续运行: 策略运行期间不要关闭浏览器或休眠电脑
  • 稳定网络: 使用稳定的网络连接
  • 住宅 IP: 推荐使用住宅 IP(避免频繁切换 IP 导致 API 限制)
  • Chrome 保持活跃: 确保 Chrome 不被系统休眠

风险管理建议

  1. 从小仓位开始: 首次使用建议从最小订单量开始测试
  2. 监控 IM/MM: 保证金比率过高时会拒绝开仓
  3. 关注日志: 定期查看 Logs 了解策略执行情况
  4. 设置合理 PNL 区间: 根据市场波动调整止损/止盈参数
  5. 充足余额: 两个平台都保持充足余额避免强平

常见问题

策略卡在"启动中"

  • 检查 API 密钥是否正确
  • 查看 Logs 是否有错误信息
  • 确认两个平台账户都有余额

Positions 数据不更新

  • 等待 2-6 秒(区块链确认时间)
  • 检查网络连接
  • 刷新页面重新查看

持仓不平衡

  • 策略会自动配平,每轮循环结束时检查
  • 配平失败会重试最多 5 次
  • 查看 Logs 了解配平执行情况

订单一直未成交

  • Maker 订单最多监控 60 秒
  • 超时后自动取消,下一轮重新挂单
  • 可以调整订单大小或滑点参数

技术架构

核心组件

  • Strategy Engine: 主策略循环(30-60 秒间隔)
  • Variational Client: RFQ 报价系统,WebSocket 持仓更新
  • Lighter Signer Client: StarkNet 订单签名和执行
  • Lighter API Client: 账户查询和订单簿数据
  • Heartbeat Worker: 保持扩展运行并验证账户状态
  • Version Monitor: 每 5 分钟检查版本更新

安全特性

数据保护

  • 私钥存储在 Chrome 加密 storage
  • API Token 加密存储
  • 不向第三方传输用户数据

错误处理

  • 最多 5 次账户信息获取重试
  • 对冲失败不中断监控流程
  • 配平失败自动重试

验证机制

  • 心跳验证(使用 Variational 地址验证账户状态)
  • 版本监控(版本不匹配自动停止策略)
  • API 密钥有效性检查
  • 合约配置验证

支持

邮箱: contact@alphalabs.app 文档: https://docs.alphalabs.app/products/variational-lighter


许可证

本软件根据 AlphaLabs 专有许可协议授权,仅限授权用户使用。

未经授权不得复制、修改、分发或逆向工程本软件。

版权所有 © 2025 AlphaLabs. 保留所有权利。

About

lighter-variational taker + maker 混合模式,极高的积分获取效率

Resources

License

Unknown and 2 other licenses found

Licenses found

Unknown
LICENSE.md
Unknown
LICENSE-CN.md
Unknown
LICENSE-EN.md

Stars

Watchers

Forks

Packages

 
 
 

Contributors