optimizer-claw

name	optimizer-claw
description	TLH tax-loss harvesting optimization. Triggers: 'TLH', 'tax-loss', '亏损抵扣', '省税', '优化', 'harvest', 'wash sale', 'Launchpool'. IMPORTANT: You MUST use the exec tool to run: python3 {baseDir}/optimizer.py --dataset /tmp/tax_dataset_<YEAR>.json --jurisdiction <JURISDICTION> — identifies unrealized losses and recommends substitute assets. Do NOT fabricate savings amounts. For monitor mode: python3 {baseDir}/optimizer.py --mode monitor. After exec, present TLH opportunities to user. For full instructions read SKILL.md with read tool.
license	MIT
metadata	{"author":"veritax","version":"1.0.0","homepage":"https://github.com/veritax/veritax","openclaw":{"requires":{"bins":["python"],"env":["BINANCE_API_KEY","BINANCE_SECRET_KEY"]}}}

SKILL: OptimizerClaw — TLH Strategy Engine

角色：VeriTax 税务优化层，识别 TLH（Tax-Loss Harvesting）机会，审计替代标的安全性，执行卖出+回购操作。 模型：Gemini 3.1 Pro (1x) via sessions_spawn — 需要推理能力做策略分析。 适用辖区：日本（3年损失结转）、澳洲（CGT offset）、加拿大（capital loss deduction）、英国（CGT allowance）。 不适用：台湾（无资本利得税）、新加坡（个人免税）、马来西亚（无税）。

---

Binance Skills 调用映射

Binance Skill	用途
binance-web3/query-token-audit	替代标的合约安全审计（过滤 rug pull）
binance-web3/query-token-info	替代标的流动性/持有人分布评估
binance-web3/trading-signal	机构资金动向 → 最佳执行时机
binance-web3/crypto-market-rank	替代标的市场热度过滤
binance/spot	TLH 订单执行（OCO 止损保护）

---

执行流程

Step 1: 亏损仓位扫描

从 ScannerClaw 的 tax_dataset 中识别当前持仓中未实现亏损 > 阈值的仓位。 按亏损金额降序排列，输出候选列表。

Step 2: 替代标的筛选

对每个亏损仓位：

• crypto-market-rank → 同赛道 Token 热度排名
• query-token-info → 流动性/持有人分布评估
• query-token-audit → 合约安全审计（过滤 rug pull）
• 输出安全替代标的推荐列表

Step 3: 执行时机判断

• trading-signal → 机构资金动向分析
• 判断当前是否适合执行（避开大幅波动期）

Step 4: Wash Sale / Superficial Loss 检查

• 日本：无 wash sale rule（可立即回购同资产）
• 澳洲：same asset repurchase 需注意 ATO 实质重于形式原则
• 加拿大：30 天 superficial loss rule → 必须等 30 天或用替代标的
• 英国：30-day rule + share pooling → 需用替代标的

Step 5: 用户确认 + 执行（需用户明确同意）

⛔ 禁止自动执行交易。必须展示行动计划 → 等待用户确认 → 再通过 Binance Spot Skill 下单。

Step 6: Launchpool Hook（可选）

省下的税金 → 推荐质押进 Megadrop/Launchpool。

"🦞 税局没拿走的钱，让币安帮您生钱。"

---

Command Index

# 扫描 TLH 机会（一次性分析）
python {baseDir}/optimizer.py --dataset <tax_dataset.json> --jurisdiction japan

# JSON 输出
python {baseDir}/optimizer.py --dataset <tax_dataset.json> --jurisdiction australia --json

# TLH 执行 — Dry Run（默认，仅模拟，不下单）
python {baseDir}/optimizer.py --mode execute --dataset <tax_dataset.json> --jurisdiction japan --json

# TLH 执行 — 实际下单（通过 Binance Spot API）
python {baseDir}/optimizer.py --mode execute --dataset <tax_dataset.json> --jurisdiction japan --confirm --json

# TLH 执行 — Testnet 下单（安全测试）
python {baseDir}/optimizer.py --mode execute --dataset <tax_dataset.json> --jurisdiction japan --confirm --testnet --json

# 指定执行标的（从 analyze 输出中筛选）
python {baseDir}/optimizer.py --mode execute --dataset <tax_dataset.json> --jurisdiction japan --actions '["ETH","AVAX"]' --confirm --json

# ---- Continuous Mode (v1.1) ----

# TLH 监控模式（cron 每小时触发）
python {baseDir}/optimizer.py --mode monitor --config <monitor_config.json> --jurisdiction japan

参数	必填	默认值	说明
--mode	否	analyze	运行模式：analyze / monitor / execute
--dataset	analyze/execute 时必填	—	ScannerClaw 输出的税务数据集路径
--jurisdiction	是	—	辖区：japan / australia / canada
--config	monitor 时必填	—	monitor_config.json 路径
--threshold	否	100 USD	最小亏损金额阈值
--actions	否	—	execute 模式白名单（JSON array，如 '["ETH"]'）
--confirm	否	—	execute 模式实际下单（无此flag=dry run）
--testnet	否	—	使用 Binance Testnet 下单
--json	否	—	输出原始 JSON

---

Continuous Mode — TLH 监控（v1.1）

监控模式（--mode monitor）

由 cron job veritax-monitor 每小时触发，双层模型架构：

Flash 层（0.33x，每小时运行）：

1. monitor_check() — 读取 monitor_config.json 中的 positions_watch
2. 获取实时现货余额 + 行情价格
3. 计算未实现盈亏，与 loss_threshold_pct 阈值比较
4. 未触发 → stdout 输出 [Monitor] no_trigger → 结束
5. 触发 → stdout 输出 [Monitor] TRIGGERED asset=X loss_pct=Y

Pro 层（1x，仅触发时调用）： 6. tlh_decision() — 验证持续性 → wash sale 检查 → 替代标的审计 → 税务节省估算 7. 返回 action=recommend_sell 或 action=skip（含原因） 8. 若推荐执行 → execute_tlh() 写入 monitor_config + TG 通知

monitor_config.json 结构

{
  "positions_watch": [
    { "asset": "ETH", "cost_basis_usd": 3200, "qty": 1.5,
      "loss_threshold_pct": -10, "sector": "L1" }
  ],
  "executed_tlh": [],
  "wash_sale_cooldowns": {}
}