Insight Pre-Trade

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install insight-pretrade
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 insight-pretrade。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Insight Pre-Trade 可帮助代理在签署兑换、借款、借出、清算或还款之前，评估其计划依赖的价格是否完整可信。它会查询 Insight 的交易前安全端点，并返回 PASS、WARN 或 BLOCK 判定，以及价格和风险指标。该判定使用 EIP-712 签名，以便第三方验证签发方及已签名字段的完整性。
对于构建交易工作流的 Openclaw Skills 用户，这项功能可在交易模拟之外增加一项决策输入检查：它会评估跨服务提供商的价格信号和潜在操纵风险。它不能保证价格正确，不是实时防护措施，也不构成交易授权；快照每 15 分钟收集一次，因此在采取行动前，请检查每项评估的新鲜度和有效时间窗口。

应用场景

在代理签署兑换、借款、借出、清算或还款之前检查价格。
当代理依赖单一聚合器或不熟悉的价格来源时，添加执行前关卡。
在提交交易前评估潜在的稳定币锚定风险或预言机操纵风险。
使用判定和建议的仓位上限，为代理自身的执行策略提供参考。
检查后通过免费的 HTTP 端点或离线工具验证签名评估凭证。

工作原理

代理发起交易前检查请求，提供资产、EVM chain ID、操作和以美元计的交易金额；也可以指定目标提供商和协议上下文。
代理调用 REST 端点或使用 MCP 接口。发现服务和凭证验证免费；付费的交易前检查使用 x402。
对于 REST，未付款的请求会收到 HTTP 402，其中包含在 Base 上使用 USDC 付款的要求。支持 x402 的钱包或客户端会处理 EIP-3009 transferWithAuthorization 付款，并使用 PAYMENT-SIGNATURE 标头重试请求。
Insight 会返回签名判定，其中包含共识价格、提供商最大偏差、操纵风险评分、跨提供商一致性和建议的最大仓位规模等字段。
代理应用自身的策略：PASS 表示可以继续，WARN 表示需要谨慎或减少规模，BLOCK 表示不要执行。做出决策前，请检查新鲜度和有效期。
接收方可以通过 Insight 的免费 HTTP 验证端点、验证网站或独立的 verify-insight-receipt npm 包验证签名凭证。签名验证并不能证明底层价格正确，也不能证明代理遵循了判定。

配置指南

将 insight-pretrade skill 添加到 OpenClaw 兼容代理运行时使用的 skills 目录。skill 清单将 curl 列为必需二进制文件；无需 API 密钥或注册账号。
在代理运行时配置支持 x402 的钱包或客户端，例如内置的 agentic 钱包、@x402/fetch 或 mppx。让该客户端处理 HTTP 402 付款协商，而不是手动构建付款签名。
使用必需参数发起请求。此示例演示端点发现；如果没有付款凭据，付费端点会返回 HTTP 402 和付款要求。
curl -i --get 'https://www.oracleinsight.xyz/api/v1/safety/pre-trade' \ --data-urlencode 'asset=ETH' \ --data-urlencode 'chainId=8453' \ --data-urlencode 'action=swap' \ --data-urlencode 'tradeAmountUsd=1000' 使用已配置的 x402 客户端完成付款并重试请求。在 Base 上的付款金额为 20,000 个 USDC 原子单位（eip155:8453）；只有检查成功后才会结算。
在应用执行策略之前，阅读判定及其新鲜度和有效时间窗口。对于 MCP，请连接到 https://www.oracleinsight.xyz/api/mcp；initialize、tools/list 和 ping 免费；未发送 API 密钥时，通过 tools/call 调用 pre_trade_safety_check 需使用 x402 付费。

数据架构

该 skill 会向 Insight 发送请求参数并返回签名评估。SKILL.md 未定义本地存储或检查生成的文件。
数据 字段或值 用途
必需请求输入 asset、chainId、action、tradeAmountUsd 标识资产、EVM 网络、预期交易和交易规模。
可选请求上下文 targetProviders、protocolId、schemaVersion 限定预言机提供商、标识协议上下文或选择响应模式。模式版本 3 增加了可通过签名字节验证的法定人数和独立性门槛。
判定 verdict：PASS、WARN 或 BLOCK 为代理自身的决策策略传达评估结果。
价格和风险指标 consensusPrice、maxDeviationPct、manipulationRiskScore、crossProviderAgreement 汇总跨提供商定价和风险信号。
仓位指引 recommendedMaxPositionUsd 建议仓位上限，供代理策略考虑。
凭证 EIP-712 签名字段 支持验证签发方及已签名字段的完整性；不能证明价格正确或策略合规。
付款 Base 上的 USDC，网络 eip155:8453 付费检查使用 x402 付款；指定金额为 20,000 个原子单位。

高级特性

x402 付款流程：
使用 Base 上的 USDC 按次支付交易前检查费用，无需注册或 API 密钥；兼容客户端可以处理 HTTP 402 响应和授权流程。
MCP 接口：
通过可流式传输的 HTTP JSON-RPC 访问
pre_trade_safety_check
工具；初始化、工具发现和 ping 操作免费。
可验证凭证：
通过无需密钥的 HTTP 端点、Insight 验证网站或独立的
verify-insight-receipt
npm 包验证签名评估字段。
提供商和协议上下文：
可在检查时选择限定预言机提供商并加入协议标识符。
模式版本 3：
增加了可通过签名字节验证的法定人数和独立性门槛。
明确的决策指引：
根据代理自身策略解读 PASS、WARN 和 BLOCK；BLOCK 表示检查已完整执行且会收费，任何判定都不保证经济安全或盈利。

name: insight-pretrade description: Before your agent signs a trade, check whether the price it relies on is trustworthy — a signed, re-verifiable verdict in one call. $0.02 USDC via x402. version: 1.0.0