SuperAPI AI 工具集

binance-onchain-copy-trader

智能体与模型

查看项目

更新于 10-15 14:14

技能介绍

Binance On-Chain Copy Trader 是一个用于在 Binance Agentic Wallet 上组装链上跟单策略的脚手架。它本身不提供策略,提供的是能力索引、事件契约、组装结构以及三个策略钩子,策略需要用户自行构建和打磨。

用途 该技能用于搭建一条跟单交易管道:从地址监控或信号订阅获取实时事件,经过风控与执行能力(代币审计、行情查询、报价、市价单、限价单等)处理后,由用户编写的策略钩子决定是否入场、仓位大小和退出计划。它只负责编排,底层能力均来自其他技能。

主要能力 脚手架提供三个策略钩子:should_enter、size_position、exit_plan,位于 scripts/copytrader.py 顶部以 ══ 分隔的代码块中。它支持两种触发源:地址订阅(用户指定钱包,推送其每笔链上交易,最多 100 个地址)和信号订阅(平台或自定义策略决定,推送判定结果,需按 signalId 去重)。事件经 norm_address() / norm_signal() 归一化后合并到单一队列。

依赖技能 需确认以下技能在当前环境可用:binance-agentic-wallet(钱包、市价单、限价单、配额、链信息)、binance-wallet-tracker(地址监控、实时推送、分组管理,必须包含连接生命周期和信号字段可空性章节)、binance-leaderboard(交易者排名、地址评分、持仓查询)、binance-trading-signal(聪明钱信号、自定义策略、回测)、query-token-audit(代币安全审计)、query-token-info(可选,实时代币价格与行情)。缺少任一技能会禁用对应阶段。

使用方式 建议流程:1)环境检查,确认钱包 CONNECTED、目标链支持市价单和限价单、报价代币和 gas 余额充足;2)选择触发源(地址订阅、信号订阅或两者);3)选择来源,地址源通过 leaderboard query/analyze 筛选并写入 addrs.txt(每行一个,支持 # 注释,最多 100 个),信号源通过 signal explore/strategy create/follow 或 --smy 配置;4)写入配置,首次运行会在 $COPYTRADER_HOME(默认 ~/.local/copytrader)生成空模板,必填字段未填则拒绝启动,mode 保持 dry-run;5)以未修改的捆绑钩子进行 dry-run:cd <skill-dir>/scripts && python3 copytrader.py;6)检查管道,通过 tail -f $COPYTRADER_HOME/copytrader.log 查看启动日志、events.jsonl 决策分布、conn_seq 重连频率、outcomes.jsonl 和 state.json;7)编写策略,编辑三个钩子函数,用 events.jsonl 与 outcomes.jsonl 按 key 关联决定阈值;8)迭代,改钩子→重跑→再评分;9)切换实盘,将 mode 设为 live 并确认风险金额:echo <budget_usd> > $COPYTRADER_HOME/I_UNDERSTAND_THE_RISK。

适用场景 适用于希望在 Binance Agentic Wallet 上构建链上跟单策略的用户,包括基于地址监控的跟单、基于聪明钱信号或自定义策略信号的跟单,以及需要代币审计、行情查询和自动下单执行的场景。

限制 该技能不提供策略,捆绑的三个钩子仅为最小参考实现,用于证明管道可运行,并非推荐策略,也无正期望证据。所有风控、仓位管理和参数值均为建议示例,不构成安全保证或投资建议。脚手架只保证运行用户配置的检查,不保证这些检查足以保护资金。链上交易不可逆,自动化策略可能因未预料的市场条件、平台行为变化或脚手架缺陷而亏损。dry-run 不记录仓位,预算和并发护栏不会触发,dry-run 通过数会高于实盘实际开仓数,不应据此确定实盘仓位。信号订阅中同一 signalId 会重复推送,需去重;信号源入场价格 currentPrice 常为 null,alertPrice 为触发时历史价格而非当前可交易价格。地址订阅受 100 地址上限约束,信号订阅跨链分布不均。