核心用法
Agos Marketplace 是一款专为 AGOS 生态设计的自动化工具技能,打通了服务上架(Seller)与订单购买(Buyer)的完整链路。用户可通过两条 Python 脚本实现端到端自动化:
create_listing.py:为供应商自动创建服务上架,支持动态生成或固定service_id,定价以 USDT 为单位;create_order.py:为买家自动匹配首个活跃上架、创建订单,并可选择生成链上支付参数(--prepare-payment)或全程跟踪订单状态至终态(--wait)。
脚本直接调用 AGOS 官方 API(market.agos.fun),默认锁定 BNB Chain(chainId=56)与 USDT 结算代币,避免用户手动拼接 curl 命令。
显著优点
1. 双端自动化:单一技能覆盖供需两侧,开发者无需分别对接两套接口;
2. 支付参数自动生成:将 API 返回的 purchase_id_hex、amount_atomic 等字段直接映射为 PaymentRouter.payForService() 调用参数,降低链上交互门槛;
3. 防御性安全设计:
- 硬编码
supplier-task端点与基础 URL,禁止通过环境变量或参数注入修改,阻断 SSRF 攻击面; - 明确区分"API 自动化"与"链上签名"职责,支付环节仍需外部签名器,避免私钥托管风险。
潜在缺点与局限性
- 链上执行依赖外部签名器:技能本身不处理私钥签名,若用户无现成 signer,需手动或另行集成钱包完成
payForService调用; - 单链锁定:仅支持 BNB Chain,暂无 Ethereum、Polygon 等其他 EVM 链配置;
- 结算代币单一:强制 USDT,不支持自定义代币或原生 BNB 支付;
- API 可用性风险:所有操作依赖 AGOS 官方市场服务,若服务端故障或接口变更,脚本将失效。
适合人群
- 希望将 AI Agent、数据服务或 API 能力快速货币化的开发者;
- 构建自动化采购工作流的企业买家,需批量下单并追踪订单状态;
- 已有 BNB Chain 钱包基础设施、寻求减少人工介入的 Web3 团队。
常规风险
| 风险类型 | 说明 |
|---------|------|
| 智能合约风险 | 支付目标 `PaymentRouter` 合约由 AGOS 部署,需自行审计其代码; |
| 汇率/滑点 | USDT 计价虽稳定,但链上实际扣款为原子单位,需确认 `amount_atomic` 与预期一致; |
| 订单超时 | `--wait` 轮询依赖 AGOS 状态机,若链上确认延迟超过 `--timeout-sec`,返回状态可能非终态; |
| API 密钥泄露 | 脚本若需身份验证(文档未明示),需确保 `supplier-wallet` / `buyer-wallet` 参数不被记录到日志。 |