本页内容
  1. 裁决
    1. 当前:9 条 EVM 链上的 v2.1 合约
    2. 旧版 v1(已知问题,不持有资金)
    3. Arc 主网上的旧版 v1(chainId 5042)
    4. 主网上的完整运行
    5. 链:9 条链上的 v2.1,16 条主网上的旧版 v1
    6. Zcash:屏蔽的 2-of-3 托管(主网)
    7. 请求裁决(API)
    8. 月度争议处理报告
    9. 定价
  2. 结算风险
    1. 你会得到什么
    2. 争议追踪器(免费)
    3. 结算预估(付费)
    4. Desk:针对你的钱包所持市场的提醒
  3. 巨鲸数据 API 和 MCP
    1. 从代码中调用
    2. MCP 服务器
  4. 托管 MCP 服务器
    1. 连接
    2. OAuth
    3. 套餐和限额
    4. 工具
  5. 付款
    1. 1. 无密钥 x402,按调用付费
    2. 2. 试点密钥:前 30 天免费,之后按调用付费
    3. 3. Desk,面向交易者
    4. 4. 管理密钥和额度
  6. 验证签名
    1. 签名的内容
  7. GPU 租赁:按验证通过的天数付款
    1. 合约:Arc 主网上的 AgentJobV2
    2. SLA 与 specHash
    3. 探针
    4. 裁决
    5. 实证:在 Arc 主网上的三天
    6. 目前的限制
    7. 开始
  8. 联系方式

Predge 裁定智能体已付款的任务是否已交付,并附上任何人都能核验的签名记录。

Predge 是 AI 智能体支付的信任与争议层。支付通道负责转移资金;Predge 回答它们留下的问题:已付款的任务交付了吗?我们给出用 Predge 公开的 ed25519 密钥签名、可离线验证的裁定,并在工作从未送达时给出退款建议。v2 合约已在 Arc 和 Base 上线(地址见链;状态见 Trust);退款只是建议,由商户执行,签名裁决才是产品本身。我们不运营支付通道。目前已上线:Base、Solana、Arc、Monad 和 Algorand 上的 x402 支付;设计与通道无关。预测市场是第一个垂直领域:同样的签名记录用于跟踪 Polymarket 的结算风险,我们分析了 2026 年 1 月 1 日至 10 月 2 日的 3,005 起 UMA 争议。

示例
一个智能体为一份从未送达的报告付了款。付款方把证据哈希登记到链上,Predge 引用该哈希裁定退款,退款随即到账。仲裁合约的设计就是这样运作的;如今 API 的裁决是附带退款建议的签名记录。
01 · 智能体的任务交付了吗?

裁决

签名裁决 API 就是产品。裁决由 Predge 公开的 ed25519 密钥签名,可离线验证(见下方“请求裁决”)。链上合约是可选的,并不保证追索权。v2.1 合约已在 Arc、Base、Arbitrum、Avalanche、BNB Chain、Celo、Optimism、Sonic 和 Unichain 上线(见下文)。外部审计前扫描(Olympix)已完成:修复了 10 项发现,7 项按设计接受;修复已包含在 v2.1 中。完整审计仍在计划中。16 条链上的 v1 合约属于旧版:存在我们自己审查发现的已知问题(见 Trust),不持有资金。

当前:9 条 EVM 链上的 v2.1 合约

v2.1 于 2026 年 10 月 23 日部署在 Arc(5042)和 Base(8453)上,并于 2026 年 10 月 26 日部署在 Arbitrum、Avalanche、BNB Chain、Celo、Optimism、Sonic 和 Unichain 上(链列表和链接见链)。每条链上的六个地址相同,均已在 Sourcify 上验证(完全匹配)。它们修复了我们自查中发现的 H-01 至 H-03 和 M-01 至 M-05。

合约地址(全部 9 条 v2.1 链)链接
PredgeAgentValidatorV20xE4CFdE5dbD9afD518b9c59136939607505bF643DSourcify · Arc · Base
AgentJobV20x5C673c6aBF3c60C3F6Ce3f1509f5d99C08F8B13FSourcify · Arc · Base
PredgeValidatorBondV20x97E960Fe3D7759af8f51A95319859E60Df554329Sourcify · Arc · Base
PredgeSettlementV20x6fac55c5187A9cdb519F77163C7e3fD9E87F6f24Sourcify · Arc · Base
MockRefundProtocolV2 (demo refund protocol)0x50041FdAb10f8f56E24FA9CA806f082CcAeb05E9Sourcify · Arc · Base
PredgeRefundArbiterV20xf404F908cb1ba47C01AB8526B725aAA940557eA9Sourcify · Arc · Base

所有者:0x9084f5000E07C7133D6dA5eE4f271AB6D1821144,一个临时的单一 EOA。计划转移到 Safe 2-of-3 多签(Ownable2Step),目标日期为 2026 年 10 月 23 日。操作员(热运维密钥,所有者可轮换):0x8ffFB76c4329DDC8ee4a859DDF55AB48ba25e292。保证金是每条链原生代币约 $5 的最低额(例如 Arc 上 5 USDC,Base 上 0.002 ETH),不是任务价值的百分比。它们不是担保。外部审计前扫描(Olympix)已完成:修复了 10 项发现,7 项按设计接受;修复已包含在 v2.1 中。完整审计仍在计划中。凭证:predgeAI/predge-deploy。

旧版 v1(已知问题,不持有资金)

本节其余部分描述 v1 合约原本的设计运作方式。这是历史,不是保证。

Predge 位于退款协议的仲裁席位上(形态类似 Circle 的 Refund Protocol 和 x402r 退款扩展)。合约 PredgeRefundArbiter 的设计目的是限制这个席位能做的事。

  1. 双方提交证据。付款方或商户用各自的密钥把 sha256(evidence) 登记到链上。
  2. Predge 引用证据作出裁定。裁定在任何资金转移之前,记录证据哈希和方向(退款或放款)。rule() 只接受已登记到链上的证据。
  3. 1 天质疑窗口。v1 合约定义了一个 86,400 秒的窗口,期间可以调用 challenge。当前的合约不持有资金。
  4. 预期的检查,而非有效的保障。challenge 的设计是比较 Predge 引用的哈希与当事方登记的哈希。我们 2026 年 10 月 20 日的审查发现,裁定成功后质疑永远无法成功(发现 H-03),因此请不要依赖它。v2 合约旨在解决这个问题。
直白地说:v1 是存在已知问题的参考部署。没有任何链上机制能证明裁定是正确的,v2 修复了我们已知的发现,但尚未经过外部扫描。详情和日期见 Trust。

Arc 主网上的旧版 v1(chainId 5042)

合约地址
PredgeRefundArbiter0xA9c39e9aEd452Ee638a10aC10f6A6288C4Ca6E89
MockRefundProtocol(演示目标)0xf6659f725B3F790287a75f7A83C373E2a3D908aa
PredgeValidatorBond v2.10xfeE8b89eb8aa2499F7025Cd9aaEB13a4b046d0d1
AgentJob (ERC-8183)0x8B9589B8F5857dDe080Ac68e8B370c3bA5E74495
PredgeAgentValidator (ERC-8004)0xbe601d486D821450F9248ab91891736B1a09699F

链上读取:该仲裁合约(0xA9c3…6E89)的 challengeWindow = 86400 秒,minBond = 0.05 USDC(Arc 的原生 gas 代币);保证金 disputeWindow = 86400 秒。0.05 USDC 的下限仅适用于这个较早的 Arc 仲裁合约。

主网上的完整运行

在较早的 Arc 仲裁合约上的一次演示运行:付款方登记证据,仲裁合约引用该记录作出裁定,并针对演示退款协议执行了退款:fileEvidence · rule。第二次裁定引用了未登记的证据,并针对它发起了一次质疑(challenge)。这是我们 10 月 20 日审查之前的历史,不是保证;当前的合约不持有资金。

该次运行(2026 年 9 月 18 日)使用的是上一版仲裁合约 0xA1533757…5Ad967。上方在用的仲裁合约增加了一条规则:证据必须先登记到链上才能被引用。源代码和凭证:predgeAI/predge-arc。

链:9 条链上的 v2.1,16 条主网上的旧版 v1

当前:下方标有 v2.1 的 9 条链上部署了 v2.1,地址见上方的 v2.1 表。旧版 v1(已知问题,不持有资金):一套合约,每个合约一个地址,下方每条链上都有。源代码已在 Sourcify 上验证(完全匹配)。

链chainId合约链接
Ethereum1legacy v1v1 arbiter · v1 source
Base8453v2.1 + legacy v1v2.1 bond · v2.1 source · v1 arbiter · v1 source
BNB Chain56v2.1 + legacy v1v2.1 bond · v2.1 source · v1 arbiter · v1 source
Arbitrum One42161v2.1 + legacy v1v2.1 bond · v2.1 source · v1 arbiter · v1 source
Optimism10v2.1 + legacy v1v2.1 bond · v2.1 source · v1 arbiter · v1 source
Polygon137legacy v1v1 arbiter · v1 source
Avalanche C-Chain43114v2.1 + legacy v1v2.1 bond · v2.1 source · v1 arbiter · v1 source
Celo42220v2.1 + legacy v1v2.1 bond · v2.1 source · v1 arbiter · v1 source
Gnosis100legacy v1v1 arbiter · v1 source
Linea59144legacy v1v1 arbiter · v1 source
Unichain130v2.1 + legacy v1v2.1 bond · v2.1 source · v1 arbiter · v1 source
Sonic146v2.1 + legacy v1v2.1 bond · v2.1 source · v1 arbiter · v1 source
Arc5042v2.1 + legacy v1v2.1 bond · v2.1 source · v1 arbiter · v1 source
Monad143legacy v1v1 arbiter · v1 source
Mantle5000legacy v1v1 arbiter · v1 source
Robinhood Chain4663legacy v1v1 arbiter · v1 source
合约旧版 v1 地址(全部 16 条链)
PredgeRefundArbiter0xb2972B4944Eec83946EB7B23D572AbE04F46E22c
PredgeValidatorBond v2.10x800B5596a8540e752dE8f8a8AF99E927d139A643
PredgeAgentValidator (ERC-8004)0x925767fdce6C819F027f55CC50464e3bCdfD2671
AgentJob (ERC-8183)0xcBaB4a9FA4d756b4C5e2a18F055d2E0132CE7D1D
PredgeSettlement0x47BE8a7d461De505723a0Ac1d74982e53f8E412b
MockRefundProtocol (demo target)0xcaC30945CDF0F963f38972d939e111B87b80Cf79

链上读取,16 条链上均相同:仲裁合约的 challengeWindow = 86400 秒,minBond = 1015 wei,即该链原生代币的 0.001(Ethereum 和 ETH L2 上为 0.001 ETH,其他链上为 0.001 BNB、POL、AVAX、CELO、xDAI、S、MNT 或 MON;Arc 的原生代币是 USDC,所以是 0.001 USDC)。保证金以原生代币缴纳。

于 2026 年 10 月 18 日从 0x5d016C1B4d7A42eB7c982da1Ae7fFdB958CFCAe9 部署。各链凭证:predgeAI/predge-deploy。上方的 Arc 表是较早的 Arc 部署和完整的主网运行;两者都继续在线。需要其他 EVM 链?告诉我们:一天内即可部署。

Zcash:屏蔽的 2-of-3 托管(主网)

Zcash · 主网。Predge 在 Zcash 上运行屏蔽的 2-of-3 FROST 托管。买方、卖方和中立仲裁方(Predge)各持有一份密钥分片,其中任意两方即可付款。仲裁方只会共同签署其 Ed25519 签名裁决所指定的那笔确切付款;它无法单独转移资金。资金存放在 Zcash 的屏蔽 Ironwood 池中,在链上,一笔付款看起来就像普通的屏蔽交易。

状态:三条路径(放款、争议退款、争议付款),以及仲裁方拒绝错误付款,于 2026 年 10 月 31 日在 Zcash 公共测试网上完成了端到端运行。2026 年 11 月 13 日,争议退款路径用真实的 ZEC 在 Zcash 主网上运行:向托管存入 0.02 ZEC,仲裁方拒绝向其裁决未指定的卖方付款,然后买方和仲裁方共同签署了退款(主网付款交易 50407885adf3b688f30d3a2e8d020297f1adb775dc9b5e2be9e6d50c61fcd5f2)。测试网退款交易示例:2bc943804f1b30eb256a3f33b79a60677621c01e4cb41320ba7a32ee70c1f711。

代码:predgeAI/zcash-escrow。Predge 还向 OpenPGP-Wallet/frost-zec 贡献篡改测试用例:共同签名方必须拒绝向错误地址付款的 PCZT。

请求裁决(API)

你的智能体为一次服务调用付了款。把承诺的内容、实际收到的内容和已付款项发给 Predge,即可拿到一份签名裁决:delivered、not_delivered 或 inconclusive。检查是确定性的(没有模型,Predge 也没有人工介入):HTTP 状态、content type、非空正文、有效 JSON、你的 JSON Schema、必填字段、预期的 sha256 和延迟上限。Predge 并不观察交付过程,因此裁决的真实程度取决于你发送的证据。

POST https://api.predge.io/v1/verdicts          $0.05, paid call under $1
POST https://api.predge.io/v1/verdicts/large    $0.50, paid call of $1 or more
GET  https://api.predge.io/v1/verdicts/:id      free, the stored signed verdict
GET  https://api.predge.io/v1/verdicts/report   free with a key, signed monthly report

通过 x402 支付(Base、Solana、Algorand、Arc 或 Monad 上的 USDC,无需密钥),或在 x-predge-key 中发送试点密钥:30 天试点期内免费,计入该密钥的每日配额。发送到错误价格档位的调用会收到 400 wrong_tier,且不收费。

curl https://api.predge.io/v1/verdicts \
  -H "content-type: application/json" \
  -H "x-predge-key: $PREDGE_KEY" \
  -d '{
    "job": {
      "endpoint": "https://api.example.com/v1/report",
      "expected_content_type": "application/json",
      "json_schema": {"type": "object", "required": ["rows"]},
      "required_fields": ["rows"],
      "max_latency_ms": 5000
    },
    "delivery": {
      "status": 502,
      "headers": {"content-type": "text/html"},
      "body": "<html>bad gateway</html>",
      "latency_ms": 420
    },
    "payment": {
      "amount_usd": 0.25, "network": "eip155:8453", "tx_hash": "0x...",
      "payer": "0xBuyer...", "payee": "0xMerchant..."
    },
    "buyer_id": "agent-42", "merchant_id": "example-api",
    "agent": {"id": "eip155:8453:0x8004...:123", "version": "2.1.0",
              "operator": "Acme Payments, Inc.", "authorization_ref": "mandate/weekly-cap"}
  }'

了解你的智能体(可选)。添加 agent(买方智能体)和 provider_agent(商户的智能体),每个都带有 id(ERC-8004 智能体 id 或任何稳定的字符串)、version、operator(负责的公司或钱包)以及可选的 authorization_ref(授权或策略 id)。这些由你自行声明,Predge 不做验证,但它们会被签入裁决、存储并返回(未提供时为 null),因此声明之后无法被更改。不带这些字段的请求照常工作。

响应(已精简):

{
  "id": "vrd_Zm9vYmFyYmF6cXV4MTIzNDU2",
  "verdict": "not_delivered",
  "reason_codes": ["status_not_2xx", "content_type_mismatch", "schema_violation"],
  "checks": [{"id": "status_2xx", "status": "fail", "detail": "HTTP 502, not a 2xx success"}, ...],
  "refund_recommended": true,
  "refund_amount_usd": "0.250000",
  "refund": {
    "recommended": true, "amount_usd": "0.250000",
    "from": "0xMerchant...", "to": "0xBuyer...",
    "status": "recommendation_only", "onchain": null,
    "instructions": "The merchant (payee) should return this amount to the buyer (payer) ..."
  },
  "verify_url": "https://api.predge.io/v1/verdicts/vrd_...",
  "attestation": {"kind": "verdict", "algorithm": "ed25519", "canonical": "...", "signature": "..."}
}

在 TypeScript 中,使用试点密钥:

const res = await fetch("https://api.predge.io/v1/verdicts", {
  method: "POST",
  headers: { "content-type": "application/json", "x-predge-key": process.env.PREDGE_KEY! },
  body: JSON.stringify({ job, delivery, payment }),
});
const verdict = await res.json();
if (verdict.refund_recommended) notifyMerchant(verdict.refund, verdict.verify_url);

裁决使用与所有 Predge 记录相同的 ed25519 密钥签名(attestation 字段,以及覆盖整个正文的 x-predge-body-signature 头);请按验证中的说明离线核验。持有 id 的人都可以通过 GET /v1/verdicts/:id 免费重新读取;id 无法被猜到。

月度争议处理报告

面向风控或合规团队:GET /v1/verdicts/report?month=2026-10,密钥放在 x-predge-key 中(可选 merchant_id、最大 1000 的 limit、cursor)。免费,并计为该密钥配额的一次调用。一个密钥只能看到它自己请求过的裁决;没有密钥则返回 401。

curl "https://api.predge.io/v1/verdicts/report?month=2026-10" -H "x-predge-key: $PREDGE_KEY"

报告包含各项计数(总数、已交付、未交付、无定论)、退款建议(数量和 USD 总额)、主要原因代码、从交付证据时间戳到裁决的中位时间和 p95 时间、带结果和 verify_url 的裁决 id(分页)、一份可复现的样本,以及一条 methodology 说明。它与裁决一样经过签名(attestation 和 x-predge-body-signature),因此可按验证离线核验。它统计的是基于请求方所提供证据的签名记录,并不是对交付的审计。

退款是建议,不是自动退款。在此版本中 Predge 不转移资金:refund 块说明谁应该向谁支付多少,由商户通过链下抵扣、退款或向付款方转账来执行。签名裁决才是产品;裁决响应中的 onchain 为 null。v2 合约已在 Arc 和 Base 上线(地址见链)。

定价

免费30 天试点
$0.05每份裁决,适用于低于 $1 的调用
$0.50每份裁决,适用于 $1 及以上的调用

开始免费试点:你的密钥几秒内就会显示在页面上。有问题?Telegram。

02 · 预测市场

结算风险

一次调用就能告诉你,某个 Polymarket 市场的结果是已结算、有争议,还是在等待 UMA 投票,数据实时读取自 UMA 的 Optimistic Oracle 和 Polygon 上 Polymarket 的 UMA CTF 适配器。免费、无需密钥、带签名。

curl https://api.predge.io/v1/settlement-risk/:market

:market = condition id、数字市场 id 或 slug。

Protocol V2 市场:由 UMA 解决的市场通过 Polymarket 的 OracleAggregator 读取(protocol: "v2");由 Chainlink 或 EOA 上报的市场,以及原子性的 neg-risk V2 市场,在支持之前返回 422 unsupported_protocol_v2。422 或 404 绝不意味着“没有风险”。

你会得到什么

  • risk_level:ok(无提案或争议)、watch、caution(有争议、已送交 UMA 投票或已暂停)、resolved(链上结果已最终确定)。
  • uma_state、dispute_count、每起争议及其 tx、sent_to_uma_vote、公告板更新、onchain_resolution。
  • segment_dispute_rate:2026 年这类市场发生争议的频率,附 95% 区间。
  • attestation:对记录的 ed25519 签名,密钥 id 为 3b6551a6439b9bda。见验证。

争议追踪器(免费)

过去 30 天内在 UMA 上出现争议的每个 Polymarket 市场,附其状态(disputed、uma_vote、resolved)和指向其签名记录的链接。页面:data.predge.io/disputes。可嵌入的徽章:<iframe src="https://data.predge.io/badge?market=ID" width="320" height="96">。

curl https://api.predge.io/v1/settlement-risk/active

结算预估(付费)

GET https://api.predge.io/v1/settlement-risk/:market/estimate

完整的签名记录加上 settlement_estimate。通过 x402 每次调用 $0.02,以 Base、Solana、Algorand、Arc 或 Monad 上的 USDC 支付;购买它的那笔付款会记在签名记录内。400/404/422/502 不收费;在预估支持之前,Protocol V2 市场在这里同样返回 422 unsupported_protocol_v2。试点合作伙伴可以获得一个密钥(x-predge-key 头),无需付款即可解锁。

签名的付款收据遵循 predgeAI/x402-receipts 中的开放规范。

Desk:针对你的钱包所持市场的提醒

面向交易者。最多添加 10 个钱包;它们持有的每个 Polymarket 市场都会被监控,每个结算事件都会发送到你的 webhook 和 Telegram:proposal、dispute、uma_vote(被争议两次,结果交由 UMA 投票)、bulletin_update(澄清和其他通知)以及 resolution。每个事件都附带签名的结算风险记录,即每起争议的证据。开始 14 天 Desk 试用,之后每月 $300。

curl -H "x-predge-key: $DESK_KEY" https://api.predge.io/v1/desk/config
curl -X PUT -H "x-predge-key: $DESK_KEY" -H "content-type: application/json" \
  -d '{"wallets":["0x…"],"webhook_url":"https://you.example/hook","telegram_chat_ids":["123456789"]}' \
  https://api.predge.io/v1/desk/config
curl -X POST -H "x-predge-key: $DESK_KEY" https://api.predge.io/v1/desk/test
curl -H "x-predge-key: $DESK_KEY" https://api.predge.io/v1/desk/events

Webhook 投递带有签名:x-predge-signature: sha256=HMAC-SHA256(secret, "<x-predge-timestamp>.<raw body>")。拒绝时间戳偏差超过 5 分钟的请求。非 2xx 的响应会重试约一小时。同一个密钥每月涵盖 5,000 次 /estimate 调用。

03 · 面向智能体

巨鲸数据 API 和 MCP

Polymarket 巨鲸交易、按结果验证的优势排序的钱包业绩记录、聪明钱信号和签名证明。通过 x402 以 USDC 按调用付费:无需账户,无需 API 密钥。

路由价格
GET /v1/whales/latest$0.005
GET /v1/wallets/leaderboard$0.01
GET /v1/wallets/:address$0.01
GET /v1/signals/consensus$0.03
GET /v1/attest/:conditionId$0.02,带签名

完整的路由列表和价格:api.predge.io · openapi.json · /.well-known/x402。付费数据延迟 15 分钟。

从代码中调用

npx x402-proxy https://api.predge.io/v1/whales/latest?limit=10

任何 x402 客户端都可以(例如 @x402/fetch):请求路由,读取 402,付款,重试。

MCP 服务器

claude mcp add predge-whale-data \
  -e BUYER_PRIVATE_KEY=0xYOUR_FUNDED_BASE_KEY \
  -e X402_NETWORK=base \
  -- npx -y @predge/whale-data-mcp

npm 上的 @predge/whale-data-mcp(源代码)。付费工具会花费真实的 USDC,并在任何资金转移之前受 MAX_PRICE_USD(默认 $0.05)的硬性上限约束。免费工具(发现、结算风险、记录验证)无需密钥。请使用余额很少的专用买方钱包。如果想要用登录而不是钱包的订阅方式,请使用托管 MCP 服务器。

面向个人 · 托管 MCP

托管 MCP 服务器

在 Claude、ChatGPT、Cursor、Codex 和其他 MCP 客户端中使用 Predge:Polymarket 巨鲸交易、钱包档案、内幕信号和签名的结算风险检查,以及针对你的钱包所持市场的 Desk 提醒。一个 URL,用你的 Predge 账户登录,无需钱包,也无需向 Predge 按调用付款。这是面向个人的订阅途径;按调用付费的智能体使用 npm 服务器和 x402,裁决则在 API 中。

https://app.predge.io/mcp

Streamable HTTP,无状态,JSON 响应。没有凭据时返回 401,并附带 WWW-Authenticate: Bearer resource_metadata="https://app.predge.io/.well-known/oauth-protected-resource/mcp"。

连接

Claude(claude.ai、Desktop、移动端):Customize > Connectors > Add custom connector,粘贴上面的 URL,选择“Sign in now”,登录 Predge 并点击 Allow。ChatGPT:Plugins > + > Add custom MCP server,粘贴 URL,选择 OAuth。在 Team 和 Enterprise 套餐中,由所有者为整个组织添加一次连接器。

支持自定义请求头的客户端使用个人访问令牌。在 app.predge.io/app/agents 创建一个(以 pgm_ 开头,只显示一次,每个账户最多 10 个),并以 Authorization: Bearer pgm_… 发送。该页面还提供各客户端可直接复制粘贴的设置。

# Claude Code
claude mcp add --transport http predge https://app.predge.io/mcp --header "Authorization: Bearer $PREDGE_MCP_TOKEN"

# Gemini CLI
gemini mcp add --transport http --header "Authorization: Bearer $PREDGE_MCP_TOKEN" predge https://app.predge.io/mcp
// Cursor: ~/.cursor/mcp.json
{ "mcpServers": { "predge": { "url": "https://app.predge.io/mcp", "headers": { "Authorization": "Bearer pgm_…" } } } }
# Codex CLI: ~/.codex/config.toml (or OAuth: codex mcp login predge)
[mcp_servers.predge]
url = "https://app.predge.io/mcp"
bearer_token_env_var = "PREDGE_MCP_TOKEN"

OAuth

遵循 MCP 授权规范的 OAuth 2.1,适用于带有 Connect 按钮的客户端。动态客户端注册(RFC 7591)位于 /oauth/register,仅限公共客户端,因此无需输入 client id 或 secret。使用 PKCE S256 的授权码(必需)、带轮换的 refresh token、有效期 1 小时的 access token,scope 为 mcp。每个连接都会作为已连接应用显示在 app.predge.io/app/agents 中,并可在那里断开。

文档URL
受保护资源(RFC 9728)app.predge.io/.well-known/oauth-protected-resource/mcp
授权服务器(RFC 8414)app.predge.io/.well-known/oauth-authorization-server

套餐和限额

免费ProDesk
价格$0$20/月 或 $195/年$300/月,14 天免费试用
工具search_markets, live_whale_trades, top_whales所有读取工具Pro 工具外加 Desk 提醒和钱包
每个 UTC 日的调用次数252,0002,000
每分钟调用次数1060120
数据交易延迟 90 秒,每次调用最多 10 行实时实时

超出限额,或使用你的套餐不包含的工具时,调用会返回一个说明原因的 MCP 工具错误,并链接到 app.predge.io/app/settings。在那里升级后再次调用即可。Desk:开始试用。

工具

工具套餐功能
search_marketsFreeFind markets by words, id, slug or link
live_whale_tradesFreeLatest large trades (Free: 90 s delay, 10 rows)
top_whalesFreeHighest-scoring wallets (Free: 10 rows)
get_marketPro+Market detail with whale flow and order flow
get_walletPro+Wallet score, P&L and recent trades
insider_signalsPro+Fresh-wallet and all-in signals
settlement_riskPro+Signed UMA settlement-risk check
perps_marketsPro+Polymarket Perps prices, funding and open interest
perps_whalesPro+Perps whale board with the Predge score
perps_walletPro+A Perps account: positions, leverage, liquidation estimate
lonestar_weather_forecastPro+LoneStarOracle WeatherOracle P(high > X), paid x402 $0.02 to LoneStarOracle
lonestar_macroPro+LoneStarOracle US macro, paid x402 $0.05 to LoneStarOracle
lonestar_ratesPro+LoneStarOracle rates and recession odds, paid x402 $0.05 to LoneStarOracle
lonestar_laborPro+LoneStarOracle US labor, paid x402 $0.05 to LoneStarOracle
lonestar_energyPro+LoneStarOracle EIA energy inventories, paid x402 $0.05 to LoneStarOracle
proxies_sx_proxyPro+Proxies.sx residential/mobile proxy for anti-bot or geo-blocked sources, paid x402 $4/GB (min $0.40) to Proxies.sx
my_watchlistPro+Your watchlist wallets
my_desk_alertsDesk+Recent dispute and settlement events
desk_walletsDesk+Wallets your Desk watches
desk_add_walletDesk+Add a wallet to your Desk

只读,desk_add_wallet 除外,它只编辑你自己的 Desk 钱包列表。标有“paid x402 to”其他提供方的工具不会通过 Predge 向你收费:工具会返回该提供方的 x402 付款要求,由你自己的 x402 客户端直接向提供方付款。Predge 从不持有密钥,也从不下单。结算退出(以 2¢ 或更低、或 98¢ 或更高的价格卖出)默认不会出现在交易列表中,除非你要求。

面向智能体 · 付款

付款

根据你的身份有三种方式,另有一个用于管理密钥和额度的控制台(4)。同一个 x402 调用在所有方式中都适用;密钥只会改变哪些是免费的。

1. 无密钥 x402,按调用付费

无需账户,无需密钥。调用付费路由,API 返回 402 及价格和它接受的网络,你的客户端用 USDC 付款并重复请求。402 头(PAYMENT-REQUIRED)是 x402 v2;JSON 正文用通俗的话说明同样的内容。你需要一个在某个受支持网络上有少量 USDC 的钱包。下面是使用 v2 包、适用于 Base 的完整 Node 客户端:

// npm i @x402/fetch @x402/evm viem   (Node 20+, ES module)
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// A wallet that holds USDC on Base. Use a dedicated low-balance key.
const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY);

const client = new x402Client();
registerExactEvmScheme(client, { signer });
const pay = wrapFetchWithPayment(fetch, client);

// $0.03: the client reads the 402, signs the payment, retries.
const res = await pay("https://api.predge.io/v1/signals/consensus");
console.log(res.status, await res.json());

不要使用旧的 x402-fetch v1 包:它从正文读取报价,而 v1 的付款不是 v2 服务器所期望的。想不写代码就试一试:npx x402-proxy https://api.predge.io/v1/whales/latest?limit=10。各路由的价格和网络见 llms.txt。

2. 试点密钥:前 30 天免费,之后按调用付费

在 predge.io/start 获取密钥(仅需邮箱)。以 x-predge-key 发送。30 天内,它为免费的签名路由和付费的结算预估(GET /v1/settlement-risk/:market/estimate)提供每日配额,无需付费。30 天后,预估会再次返回 402,并带有头 X-Predge-Pilot: estimate_grant_expired。此后你用上面的无密钥 x402 客户端按调用付费;为此并不需要密钥。可通过 GET /v1/me 或在 predge.io/account 查看你的套餐、配额和到期时间。

curl -H "x-predge-key: $PREDGE_KEY" https://api.predge.io/v1/me

3. Desk,面向交易者

针对你的 Polymarket 钱包的结算提醒,免费试用后每月 $300。详情和注册:predge.io/desk。API:见上文。

4. 管理密钥和额度

登录 app.predge.io/developers,在一处管理你的 API 密钥:创建密钥(最多 5 个有效密钥,只显示一次,仅以哈希形式存储)、重命名、吊销(下一次请求起生效)和轮换(立即生成新密钥,旧密钥在你选择的宽限期内仍可使用,默认 24 小时)。它还会显示每个密钥的用量(今天、7 天和 30 天,按路由)以及你的配额。已从 predge.io/start 拿到试点密钥?打开新密钥下方的链接,或把密钥粘贴到控制台中,即可将其关联到你的账户。试点密钥和控制台密钥(pdg_live_…)的工作方式相同。

若想从余额而不是按调用付费,请在 Billing 下充值 USDC($20、$50、$200,或 $10 至 $1,000 之间的任意金额)。带有 x-predge-key、调用有定价的数据路由时,会先从你的额度中扣费,响应中也会说明(X-Predge-Credits-Charged、X-Predge-Credits-Balance)。失败的调用不收费。没有额度,或在签名响应指明 x402 付款的路由(/v1/attest、/v1/wallets/:address/attest、/v1/track-record)上,你就按调用通过 x402 付款,与上文完全相同。每次充值都有可打印的收据。

curl -H "x-predge-key: $PREDGE_KEY" https://api.predge.io/v1/whales/latest   # paid from credits, no x402 client needed
04 · 不必轻信任何人

验证签名

每条签名记录都带有一个 attestation,包含 canonical(实际被签名的字节)、signature 和 kid。请对照 Predge 的密钥注册表离线核验,而不是响应里自带的密钥:通过 kid 查找密钥,并拒绝注册表中标记为 revoked 的任何密钥,无论签名是何时作出的。密钥会轮换;请重新读取注册表,而不要固定某个密钥。

当前密钥 id(kid)3b6551a6439b9bda
ed25519 公钥3b6551a6439b9bda0de7e3b8dc89f276b2141fdfde310f762e663ab4ba2e9d1b
密钥注册表api.predge.io/.well-known/predge-keys.json
// Node 20+, no dependencies
import { createPublicKey, verify } from "node:crypto";
const reg = await (await fetch("https://api.predge.io/.well-known/predge-keys.json")).json();
const r = await (await fetch("https://api.predge.io/v1/settlement-risk/5608010")).json();
const a = r.attestation;
// Look the key up by kid in the registry and refuse revoked keys
const entry = reg.keys.find((k) => k.kid === a.kid);
if (!entry || entry.status === "revoked") throw new Error("unknown or revoked key " + a.kid);
const key = createPublicKey({ format: "der", type: "spki",
  key: Buffer.concat([Buffer.from("302a300506032b6570032100", "hex"), Buffer.from(entry.public_key, "hex")]) });
console.log(verify(null, Buffer.from(a.canonical, "utf8"), key, Buffer.from(a.signature, "hex"))); // true

签名的内容

对于结算风险记录(payload_version: "2",自 2026 年 10 月 18 日起),签名还涵盖市场问题和 slug、每条公告板更新的 sha256,以及每次读取所在的 Polygon 区块(block:编号和哈希)。每个 eth_call 都在该区块上运行,因此归档节点可以完全复现这条记录。自 payload_version: "3" 起,市场日期以其在 Polymarket 中的名称签名:gamma_end_date(创建时设定的计划结束时间,常常已过时)、uma_end_date 和 closed_time(市场实际关闭的时间),每个都是 ISO-8601 UTC 或 null,原始 Gamma 字符串在 gamma_dates_raw 中。版本 2 的字段 end_date 已移除;请读取 gamma_end_date 获得同样的值。旧记录仍然有效。

整个 HTTP 正文也会被签名,放在 x-predge-body-signature 头中:对 predge-body-v1、一个换行符,再加上原始正文字节作 ed25519 签名。

const res = await fetch("https://api.predge.io/v1/settlement-risk/5608010");
const body = Buffer.from(await res.arrayBuffer());
const sig = /sig=([0-9a-f]{128})/.exec(res.headers.get("x-predge-body-signature"))[1];
console.log(verify(null, Buffer.concat([Buffer.from("predge-body-v1\n"), body]), key, Buffer.from(sig, "hex"))); // true

规范:data.predge.io/canonicalization.md,第 5a 和 5b 节。Python:python3 verify_record.py record.json --body-signature "<header>"(verify_record.py)。

无需代码:把记录粘贴到 data.predge.io/verify。对于签名的 x402 付款收据,规范、TypeScript 库和测试向量在 predgeAI/x402-receipts。

05 · GPU 租赁

GPU 租赁:按验证通过的天数付款

用于把 GPU 时间租给陌生买家的结算。买家每天用 USDC 预付到 Arc 上的托管合约。探针检查当天,Predge 签署裁决。已交付的那天付给主机方,未交付的那天退给买家。面向主机方和买家的概览:predge.io/gpu。

费用:每个付款日收取 2%,由主机方承担。退款日不收费。合约本身不扣费用:它支付当天的全部托管金额。

合约:Arc 主网上的 AgentJobV2

合约地址(Arc,chainId 5042)
AgentJobV2(ERC-8183 风格的任务托管)0x5C673c6aBF3c60C3F6Ce3f1509f5d99C08F8B13F

每个租用日一个任务。USDC 是 Arc 的原生 gas 代币,所以托管金额就是随 createJob 发送的金额。USDC 存放在合约中,不在 Predge 手里。

  1. 创建。买家(client)调用 createJob(provider, evaluator, specHash, expiredAt) 并发送当天的价格,这笔金额就是托管金额。evaluator 必须不同于 client 和 provider。在 GPU 交易中,evaluator 是 Predge。
  2. 提交。在 expiredAt 之前,主机方(provider)调用 submit(jobId, deliverable, output)。deliverable 是当天证据文件的 sha256。output 可选:如果发送,合约会在链上检查它的 sha256 是否等于 deliverable。
  3. 裁决。在提交后的 evaluationWindow 内,Predge 调用 complete(jobId, reason, data) 付给 provider,或调用 reject(jobId, reason, data) 退给 client。reason 是对已签名裁决的 bytes32 承诺。
  4. 超时。如果任务到期仍未提交,或 Predge 未在评估窗口内裁决,任何人都可以调用 claimRefund(jobId),托管金额退给 client。
  5. 提取。付款或退款记入收款方名下,由收款方通过 withdraw() 或 withdrawTo(to) 提取。

用 getJob(jobId) 读取任务。事件:JobCreated、Submitted、Completed、Rejected、Refunded、Withdrawn。

SLA 与 specHash

主机方和买家在买家付款前约定 SLA。每天都有一份 spec:交易 ID、第几天、时间窗口、价格、SLA、主机方和买家地址以及网络。其规范 JSON 的 sha256 就是任务的 specHash,因此当天的条款在链上固定。1x A100 80GB 交易的 SLA:

"sla": {
  "gpu_model": "A100",
  "gpu_count": 1,
  "min_memory_mib_per_gpu": 80000,
  "heartbeats_per_period": 24,
  "min_uptime_pct": 95,
  "benchmark": "fp16_matmul_tflops_per_gpu",
  "min_benchmark": 200
}

含义:GPU 名称包含 A100,至少 1 块 GPU,每块 GPU 至少 80000 MiB 显存,24 次心跳中至少 95% 在线,fp16 matmul 至少 200 TFLOPS。

探针

探针在租用的实例内运行,和买家的任何工作负载一样。它不需要访问主机方的机器或网络。在一天中,它记录 nvidia-smi 心跳(GPU 名称、数量、显存),并运行一个简短的 fp16 基准测试:用 PyTorch 和 CUDA 在 cuda:0 上做 8192x8192 matmul,约 10 秒。输出是一份证据 JSON(predge-compute-evidence-v1)。它的 sha256 就是主机方在链上提交的 deliverable。

裁决

Predge 将证据与 spec 对照,并为当天签署裁决:delivered 或 not_delivered。它使用与其他 Predge 裁决相同的 predge-attest-v1 封装(对规范 JSON 的 ed25519 签名),并绑定任务 spec 哈希(job_sha256)、预付交易(payment_ref)和证据哈希(delivery.body_sha256)。可以像任何裁决一样离线验证:裁决 和 验证签名。

实证:在 Arc 主网上的三天

2026 年 11 月 12 日。一块租用的 A100,每天 0.20 USDC 托管,共 14 笔交易。第 2 天主机方换上了 A40,当天被退款。

天探针看到的情况结果裁决交易
第 1 天NVIDIA A100-SXM4-80GB,检查通过付给主机方0xa292…37ba
第 2 天NVIDIA A40(48 GB),而不是约定的 A100退给买家0x7fe8…4b16
第 3 天再次是 NVIDIA A100-SXM4-80GB,检查通过付给主机方0x3118…ea46

目前的限制

  • 合约已通过 Olympix 自动化工具检查。目前还没有独立的人工审计,所以首批交易金额小且有上限。
  • 控制机器的主机方可能会试图向探针提供虚假读数。在生产环境中,我们固定探针镜像,并从实例外部交叉核对读数。

开始

告诉我们你的 GPU 和每天的价格:predge.io/gpu,或通过 Telegram 联系我们:t.me/latcom。

06 · 联系我们

联系方式

预约 30 分钟的通话:calendly.com/hello-predge/30min。或发邮件到 hello@predge.io,也可以在 Telegram 上联系我们:t.me/latcom。