核心用法
aionmarket-trading 是 AION Market 提供的核心交易技能，使AI代理能够在 Polymarket 预测市场上执行完整生命周期操作。用户需提供 Agent API Key 和 Wallet Private Key 两项关键凭证，技能自动完成以下流程：
1. 代理注册与认领：通过 register_agent() 创建代理，获取一次性API密钥并通过 claimUrl 完成授权
2. 钱包绑定：利用 py-clob-client 从私钥派生 Polymarket CLOB 凭证（API Key/Secret/Passphrase），无需手动复制
3. 市场搜索与解析：get_markets() 返回事件嵌套子市场结构，交易字段（conditionId、clobTokenIds、outcomePrices）位于子市场层级
4. 预交易自动检查：强制调用 get_market_context()，自动验证余额、Gas、授权额度，技术可行时自动完成授权
5. 订单构建与执行：使用 EIP712 签名订单，支持限价/市价单，YES/NO 双边交易
6. 持仓管理与赎回：实时监控持仓、取消订单、自动赎回盈利
显著优点
- 自托管架构：私钥始终由用户掌握，SDK仅存储加密后的CLOB凭证
- 自动化程度高：从凭证派生到授权检查，关键步骤无需人工介入
- 风险前置控制：内置
riskLimit、maxTradesPerDay、maxTradeAmount等限制，每笔交易前强制检查市场上下文警告 - 数据层级清晰：明确区分事件(event)与子市场(sub-market)的数据结构，避免误用numeric ID作为conditionId
- 错误透明化：强制捕获
ApiError，要求对模糊响应通过Polymarket原生接口二次验证
潜在缺点与局限性
- 技术门槛较高：需同时管理AION Market和Polymarket双重视角，理解CLOB凭证派生机制、EIP712签名、负风险市场(negRisk)等特殊概念
- 私钥依赖风险：一旦私钥泄露，攻击者可直接通过Polymarket原生接口操作资金，AION Market的加密存储仅保护派生凭证
- 链上Gas成本：自动授权、交易执行均需Polygon链上支付，小额频繁交易可能受Gas侵蚀
- API响应不确定性：文档明确指出SDK可能返回空或通用错误，需额外查询验证，增加实现复杂度
- 市场数据解析负担：子市场嵌套结构需手动解析JSON字符串（outcomePrices、clobTokenIds），易出错
适合人群
- 量化策略开发者：需要程序化访问Polymarket、构建自动化交易机器人的开发者
- AI代理构建者：为LLM代理赋予真实世界预测市场交易能力的应用场景
- 自托管优先用户：不愿将私钥托管给中心化交易所，接受技术复杂度换取资金控制权的进阶用户
- 风险可控的小额交易者：文档建议默认2 USDC起投，适合策略验证阶段
常规风险
| 风险类别 | 具体表现 | 缓解措施 |
|---------|---------|---------|
| **私钥泄露** | 硬编码私钥、.env文件误提交Git | 强制.env入.gitignore，使用环境变量注入 |
| **凭证失效** | CLOB凭证过期或API密钥泄露 | 90天轮换周期，异常自动暂停交易 |
| **授权额度滥用** | 恶意spender获得无限USDC授权 | 技能自动检查授权对象，但用户需审计spender白名单 |
| **市场操纵** | 低流动性市场大额冲击成本 | 强制检查orderMinSize、市场深度 |
| **链上失败** | Gas不足、nonce冲突导致交易pending | 自动Gas检查，异常时显式报错而非静默重试 |
| **策略失控** | 自动化循环超出风险限额 | 日交易次数/金额上限硬约束 |
> 关键安全提示：该技能要求代理具备私钥访问权限，虽采用"自托管"架构，但代码执行环境的安全性（如容器隔离、内存加密）直接决定资金风险。建议在隔离环境中运行，并对trade()、cancel_all_orders()等高危操作增加人工确认层。