Polymarket BTC 5m Arbitrage

Polymarket BTC 5分钟市场扫描器

⚠️ 资金与交易警告

• 这是只读扫描器，不是自动交易机器人。
• 它只调用 Polymarket 的公开市场数据接口；不会下单、撤单、做市、转账或扣费。
• 它不读取或要求私钥、API key、钱包凭据、第三方计费凭据或其他秘密。
• “候选价差”不是无风险收益承诺，仍可能受到手续费、滑点、延迟、部分成交、市场规则和结算争议影响。
• 运行前请确认你遵守所在地区及 Polymarket 的法律、合规和服务条款要求。

能力与权限声明

metadata.openclaw.permissions 是给安装者和审计器看的能力声明；真正的网络/文件系统隔离仍应由运行时沙箱或主机策略执行。

使用方法

单次扫描：

python3 {baseDir}/scripts/polymarket_btc_5m_bot.py --once

输出 JSON，便于下游审计或人工复核：

python3 {baseDir}/scripts/polymarket_btc_5m_bot.py --once --json

持续轮询必须显式指定间隔；即便如此仍然只读：

python3 {baseDir}/scripts/polymarket_btc_5m_bot.py --interval 30

判断口径

脚本分别读取 Up/Down 两个互补 token 的最佳卖价，并仅报告：

Up ask + Down ask + fee_buffer < 1

这只是候选筛选条件，不执行交易，也不保证能以显示价格成交。脚本不会把同一个 token 的 bid/ask 误称为互补套利。

明确不支持的功能

本版本不支持自动交易、限价单、市价单、自动做市、第三方计费或任何付款流程。若要另行开发真实交易执行器，应使用独立 skill，加入显式的 dry-run 默认值、单次订单确认、额度上限、密钥托管、审计日志和单独的安全评审；不要把私钥重新加回本 skill。

参考

• references/api-reference.md：只读接口范围
• references/trading-strategy.md：候选价差与风险说明