Predge は、エージェントが支払った仕事が納品されたかどうかを判断します。誰でも検証できる署名付きの記録とともに。
Predge は AI エージェント決済のための信頼・紛争レイヤーです。決済レールはお金を動かしますが、その先の疑問、支払った仕事は納品されたのか?には答えません。Predge は、公開された ed25519 鍵で署名しオフラインで検証できる判断と、仕事が届かなかった場合の返金推奨で、これに答えます。v2 コントラクトは Arc と Base で稼働中です(アドレスはチェーン、状況は Trust を参照)。返金は加盟店が実行する推奨であり、署名付き判定がプロダクトです。決済レールは運営していません。現在稼働中: Base、Solana、Arc、Monad、Algorand 上の x402 決済。設計はレールに依存しません。最初の分野は予測市場です。同じ署名付き記録で Polymarket の決済リスクを追跡しており、2026年1月1日から10月2日までの UMA 紛争 3,005 件を分析しました。
判定
現行: 9 つの EVM チェーン上の v2.1 コントラクト
v2.1 は 2026年10月23日に Arc(5042)と Base(8453)にデプロイされ、2026年10月26日に Arbitrum、Avalanche、BNB Chain、Celo、Optimism、Sonic、Unichain にデプロイされました(チェーン一覧とリンクはチェーン)。全チェーンで同じ 6 つのアドレスで、すべて Sourcify で検証済み(完全一致)です。自社の自己レビューの指摘 H-01〜H-03 と M-01〜M-05 を修正しています。
| コントラクト | アドレス(v2.1 の全 9 チェーン) | リンク |
|---|---|---|
| PredgeAgentValidatorV2 | 0xE4CFdE5dbD9afD518b9c59136939607505bF643D | Sourcify · Arc · Base |
| AgentJobV2 | 0x5C673c6aBF3c60C3F6Ce3f1509f5d99C08F8B13F | Sourcify · Arc · Base |
| PredgeValidatorBondV2 | 0x97E960Fe3D7759af8f51A95319859E60Df554329 | Sourcify · Arc · Base |
| PredgeSettlementV2 | 0x6fac55c5187A9cdb519F77163C7e3fD9E87F6f24 | Sourcify · Arc · Base |
| MockRefundProtocolV2 (demo refund protocol) | 0x50041FdAb10f8f56E24FA9CA806f082CcAeb05E9 | Sourcify · Arc · Base |
| PredgeRefundArbiterV2 | 0xf404F908cb1ba47C01AB8526B725aAA940557eA9 | Sourcify · 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 は、その席でできることを制限するよう設計されました。
- 当事者が証拠を提出する。支払者または加盟店が、自分の鍵で
sha256(evidence)をオンチェーンに登録します。 - Predge が証拠を引用して判断する。お金が動く前に、判断には証拠ハッシュと方向(返金または解放)が記録されます。
rule()は、すでにオンチェーンに登録された証拠のみを受け付けます。 - 1 日の異議申立期間。v1 コントラクトは、
challengeを呼び出せる 86,400 秒の期間を定義しています。現在のコントラクトは資金を保持していません。 - 想定された確認であり、機能するセーフガードではありません。
challengeは、Predge が引用したハッシュと当事者が登録したハッシュを比較するよう設計されていました。2026年10月20日のレビューで、判断が成功した後は異議申立が決して成功しないことが判明しました(指摘 H-03)。そのため、これに頼らないでください。v2 コントラクトはこれに対処することを目的としています。
Arc メインネット上のレガシー v1(chainId 5042)
| コントラクト | アドレス |
|---|---|
| PredgeRefundArbiter | 0xA9c39e9aEd452Ee638a10aC10f6A6288C4Ca6E89 |
| MockRefundProtocol(デモ用ターゲット) | 0xf6659f725B3F790287a75f7A83C373E2a3D908aa |
| PredgeValidatorBond v2.1 | 0xfeE8b89eb8aa2499F7025Cd9aaEB13a4b046d0d1 |
| AgentJob (ERC-8183) | 0x8B9589B8F5857dDe080Ac68e8B370c3bA5E74495 |
| PredgeAgentValidator (ERC-8004) | 0xbe601d486D821450F9248ab91891736B1a09699F |
オンチェーンでの読み取り値: このアービター(0xA9c3…6E89)は challengeWindow = 86400 秒、minBond = 0.05 USDC(Arc のネイティブなガストークン)です。ボンドの disputeWindow = 86400 秒。0.05 USDC の下限は、この以前の Arc アービターにのみ適用されます。
メインネットでの一連の実行
以前の Arc アービターでのデモ実行: 支払者が証拠を登録し、アービターがまさにその記録を引用して判断し、デモの返金プロトコルに対して返金が実行されました: fileEvidence · rule。2 つ目の判断は未登録の証拠を引用しており、それに対して異議申立(challenge)が行われました。これは 10月20日のレビュー以前の経緯であり、保証ではありません。現在のコントラクトは資金を保持していません。
この実行(2026年9月18日)は、以前のアービターのバージョン 0xA1533757…5Ad967 を使用しました。上記の稼働中のアービターには、証拠は引用する前にオンチェーンに登録されていなければならない、というルールが 1 つ追加されています。ソースと証跡: predgeAI/predge-arc。
チェーン: 9 チェーンで v2.1、16 メインネットでレガシー v1
現行: 下で v2.1 と記された 9 チェーンに v2.1 があり、アドレスは上の v2.1 の表にあります。レガシー v1(既知の問題あり、資金なし): 下の全チェーンに、1 つのコントラクトセット、コントラクトごとに 1 つのアドレスがあります。ソースは Sourcify で検証済み(完全一致)です。
| チェーン | chainId | コントラクト | リンク |
|---|---|---|---|
| Ethereum | 1 | legacy v1 | v1 arbiter · v1 source |
| Base | 8453 | v2.1 + legacy v1 | v2.1 bond · v2.1 source · v1 arbiter · v1 source |
| BNB Chain | 56 | v2.1 + legacy v1 | v2.1 bond · v2.1 source · v1 arbiter · v1 source |
| Arbitrum One | 42161 | v2.1 + legacy v1 | v2.1 bond · v2.1 source · v1 arbiter · v1 source |
| Optimism | 10 | v2.1 + legacy v1 | v2.1 bond · v2.1 source · v1 arbiter · v1 source |
| Polygon | 137 | legacy v1 | v1 arbiter · v1 source |
| Avalanche C-Chain | 43114 | v2.1 + legacy v1 | v2.1 bond · v2.1 source · v1 arbiter · v1 source |
| Celo | 42220 | v2.1 + legacy v1 | v2.1 bond · v2.1 source · v1 arbiter · v1 source |
| Gnosis | 100 | legacy v1 | v1 arbiter · v1 source |
| Linea | 59144 | legacy v1 | v1 arbiter · v1 source |
| Unichain | 130 | v2.1 + legacy v1 | v2.1 bond · v2.1 source · v1 arbiter · v1 source |
| Sonic | 146 | v2.1 + legacy v1 | v2.1 bond · v2.1 source · v1 arbiter · v1 source |
| Arc | 5042 | v2.1 + legacy v1 | v2.1 bond · v2.1 source · v1 arbiter · v1 source |
| Monad | 143 | legacy v1 | v1 arbiter · v1 source |
| Mantle | 5000 | legacy v1 | v1 arbiter · v1 source |
| Robinhood Chain | 4663 | legacy v1 | v1 arbiter · v1 source |
| コントラクト | レガシー v1 のアドレス(全 16 チェーン) |
|---|---|
| PredgeRefundArbiter | 0xb2972B4944Eec83946EB7B23D572AbE04F46E22c |
| PredgeValidatorBond v2.1 | 0x800B5596a8540e752dE8f8a8AF99E927d139A643 |
| PredgeAgentValidator (ERC-8004) | 0x925767fdce6C819F027f55CC50464e3bCdfD2671 |
| AgentJob (ERC-8183) | 0xcBaB4a9FA4d756b4C5e2a18F055d2E0132CE7D1D |
| PredgeSettlement | 0x47BE8a7d461De505723a0Ac1d74982e53f8E412b |
| 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 チェーンが必要ですか? ご連絡ください。1 日でデプロイします。
Zcash: シールドされた 2-of-3 エスクロー(メインネット)
Zcash · メインネット。Predge は Zcash 上でシールドされた 2-of-3 の FROST エスクローを運用しています。買い手、売り手、中立のアービター(Predge)がそれぞれ鍵のシェアを 1 つ持ち、そのうち 2 者で支払いを実行できます。アービターが共同署名するのは、Ed25519 署名付きの判定が指名した支払いだけで、単独では資金を動かせません。資金は Zcash のシールドされた Ironwood プールにあり、チェーン上では支払いは通常のシールド取引に見えます。
状況: 3 つの経路(解放、紛争時の返金、紛争時の支払い)と、アービターが誤った支払いを拒否することは、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 reportx402(Base、Solana、Algorand、Arc、Monad の USDC、鍵不要)で支払うか、x-predge-key にパイロットキーを付けて送ります。30 日間のパイロット中は無料で、キーの 1 日あたりの上限に計上されます。誤った料金区分に送った呼び出しは 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 は推測できません。
月次の紛争対応レポート
リスクまたはコンプライアンスのチーム向け: x-predge-key にキーを付けて GET /v1/verdicts/report?month=2026-10(任意で merchant_id、最大 1000 の limit、cursor)。無料で、キーの上限に対して 1 回の呼び出しとして計上されます。キーはリクエストした判定だけを参照でき、キーなしの場合の応答は 401 です。
curl "https://api.predge.io/v1/verdicts/report?month=2026-10" -H "x-predge-key: $PREDGE_KEY"レポートには、件数(合計、納品、未納品、判定不能)、返金推奨(件数と USD 合計)、主な理由コード、納品証拠のタイムスタンプから判定までの時間の中央値と p95、結果付きの判定 ID と verify_url(ページネーション)、再現可能なサンプル、methodology の注記が含まれます。判定と同様に署名されており(attestation と x-predge-body-signature)、検証の手順でオフライン検証できます。これは、リクエスト元が提供した証拠に基づく署名付き記録を集計したものであり、納品の監査ではありません。
refund ブロックは誰が誰にいくら支払うべきかを示し、加盟店がオフチェーンのクレジットや返金、または支払者への送金によって実行します。署名付き判定がプロダクトであり、判定レスポンスでは onchain は null です。v2 コントラクトは Arc と Base で稼働中です(アドレスはチェーン)。料金
無料パイロットを始める: キーは数秒でページに表示されます。ご質問は Telegram まで。
決済リスク
1 回の呼び出しで、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 で 1 回の呼び出しにつき $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(2 回紛争となり、結果が 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/eventswebhook の配信には署名が付きます: x-predge-signature: sha256=HMAC-SHA256(secret, "<x-predge-timestamp>.<raw body>")。タイムスタンプが 5 分以上ずれているものは拒否してください。2xx 以外の応答は約 1 時間再試行されます。同じキーで月 5,000 回の /estimate 呼び出しをカバーします。
ホエールデータ 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-mcpnpm の @predge/whale-data-mcp(ソース)。有料ツールは実際の USDC を使用し、お金が動く前に MAX_PRICE_USD(デフォルト $0.05)で上限が厳格に制限されます。無料ツール(探索、決済リスク、記録の検証)にはキーは不要です。残高の少ない専用の買い手ウォレットを使ってください。ウォレットではなくサインインによるサブスクリプションをご希望の場合は、ホスト型 MCP サーバーをご利用ください。
ホスト型 MCP サーバー
Claude、ChatGPT、Cursor、Codex などの MCP クライアントの中で Predge を使えます。Polymarket のホエールの取引、ウォレットのプロフィール、インサイダーのシグナル、署名付きの決済リスクチェック、そしてあなたのウォレットが保有するマーケットへの Desk アラートが含まれます。URL は 1 つで、Predge アカウントでサインインするだけです。ウォレットも、Predge への呼び出しごとの支払いも不要です。これは個人向けのサブスクリプションの経路です。呼び出しごとに支払うエージェントはnpm サーバーと x402を使い、判定は API にあります。
https://app.predge.io/mcpStreamable 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_ で始まり、1 度だけ表示され、アカウントあたり最大 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 時間のアクセストークン、スコープ 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 |
プランと上限
| 無料 | Pro | Desk | |
|---|---|---|---|
| 価格 | $0 | 月額 $20 または年額 $195 | 月額 $300、14 日間の無料トライアル |
| ツール | search_markets, live_whale_trades, top_whales | すべての読み取りツール | Pro のツールに加えて Desk のアラートとウォレット |
| UTC の 1 日あたりの呼び出し数 | 25 | 2,000 | 2,000 |
| 1 分あたりの呼び出し数 | 10 | 60 | 120 |
| データ | 取引は 90 秒遅れ、1 回の呼び出しで最大 10 行 | ライブ | ライブ |
上限を超えた場合、またはプランに含まれないツールの場合、呼び出しは理由を示す MCP のツールエラーを返し、app.predge.io/app/settings へのリンクを案内します。そこでアップグレードして、もう一度呼び出してください。Desk: トライアルを始める。
ツール
| ツール | プラン | 内容 |
|---|---|---|
| search_markets | Free | Find markets by words, id, slug or link |
| live_whale_trades | Free | Latest large trades (Free: 90 s delay, 10 rows) |
| top_whales | Free | Highest-scoring wallets (Free: 10 rows) |
| get_market | Pro+ | Market detail with whale flow and order flow |
| get_wallet | Pro+ | Wallet score, P&L and recent trades |
| insider_signals | Pro+ | Fresh-wallet and all-in signals |
| settlement_risk | Pro+ | Signed UMA settlement-risk check |
| perps_markets | Pro+ | Polymarket Perps prices, funding and open interest |
| perps_whales | Pro+ | Perps whale board with the Predge score |
| perps_wallet | Pro+ | A Perps account: positions, leverage, liquidation estimate |
| lonestar_weather_forecast | Pro+ | LoneStarOracle WeatherOracle P(high > X), paid x402 $0.02 to LoneStarOracle |
| lonestar_macro | Pro+ | LoneStarOracle US macro, paid x402 $0.05 to LoneStarOracle |
| lonestar_rates | Pro+ | LoneStarOracle rates and recession odds, paid x402 $0.05 to LoneStarOracle |
| lonestar_labor | Pro+ | LoneStarOracle US labor, paid x402 $0.05 to LoneStarOracle |
| lonestar_energy | Pro+ | LoneStarOracle EIA energy inventories, paid x402 $0.05 to LoneStarOracle |
| proxies_sx_proxy | Pro+ | Proxies.sx residential/mobile proxy for anti-bot or geo-blocked sources, paid x402 $4/GB (min $0.40) to Proxies.sx |
| my_watchlist | Pro+ | Your watchlist wallets |
| my_desk_alerts | Desk+ | Recent dispute and settlement events |
| desk_wallets | Desk+ | Wallets your Desk watches |
| desk_add_wallet | Desk+ | Add a wallet to your Desk |
desk_add_wallet を除き読み取り専用で、これは自分の Desk のウォレットリストを編集するだけです。他のプロバイダー宛てに「paid x402 to」と記されたツールは、Predge を通じて課金されません。ツールはそのプロバイダーの x402 支払い要件を返し、あなた自身の x402 クライアントがプロバイダーに直接支払います。Predge は鍵を保管せず、注文も出しません。決済時の退出(2¢ 以下または 98¢ 以上での売り)は、リクエストしない限り取引リストから除外されます。
支払い
立場に応じて 3 つの方法があり、キーとクレジットを管理するダッシュボードもあります(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)を、1 日あたりの上限の範囲で無料で利用できます。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/me3. Desk、トレーダー向け
Polymarket のウォレットに対する決済アラートで、無料トライアル後は月額 $300 です。詳細と登録: predge.io/desk。API: 上を参照。
4. キーとクレジットの管理
app.predge.io/developers にサインインして、API キーを 1 か所で管理できます。キーの作成(有効なものは最大 5 個、1 度だけ表示され、ハッシュとしてのみ保存)、名前の変更、失効(次のリクエストから有効)、ローテーション(新しいキーをすぐに発行し、古いキーはあなたが選んだ猶予期間、デフォルトでは 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署名を検証する
署名付きの記録にはすべて、canonical(署名された正確なバイト列)、signature、kid を持つ attestation が付いています。レスポンス内の鍵ではなく、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 にあります。
GPUレンタル:検証済みの日ごとに支払い
面識のない買い手にGPU時間を貸すための決済です。買い手は毎日、USDCでArc上のエスクローコントラクトに前払いします。プローブがその日を確認し、Predgeが判定に署名します。提供された日はホストに支払われ、失敗した日は買い手に返金されます。ホストと買い手向けの概要:predge.io/gpu。
コントラクト:Arcメインネット上のAgentJobV2
| コントラクト | アドレス(Arc、chainId 5042) |
|---|---|
| AgentJobV2(ERC-8183形式のジョブエスクロー) | 0x5C673c6aBF3c60C3F6Ce3f1509f5d99C08F8B13F |
レンタル1日につき1ジョブです。USDCはArcのネイティブガストークンなので、エスクローはcreateJobで送った金額です。USDCはPredgeではなくコントラクトにあります。
- 作成。買い手(client)が
createJob(provider, evaluator, specHash, expiredAt)を呼び出し、その日の価格を送ります。この金額がエスクローです。evaluatorはclientともproviderとも別でなければなりません。GPU取引ではevaluatorはPredgeです。 - 提出。
expiredAtより前に、ホスト(provider)がsubmit(jobId, deliverable, output)を呼び出します。deliverableはその日のエビデンスファイルのsha256です。outputは任意で、送った場合はそのsha256がdeliverableと一致するかをコントラクトがオンチェーンで確認します。 - 判定。提出後
evaluationWindow以内に、Predgeがcomplete(jobId, reason, data)を呼んでproviderに支払うか、reject(jobId, reason, data)を呼んでclientに返金します。reasonは署名済み判定へのbytes32のコミットメントです。 - 期限切れ。提出がないままジョブが期限切れになった場合、またはPredgeが評価期間内に判定しない場合は、誰でも
claimRefund(jobId)を呼び出せ、エスクローはclientに戻ります。 - 引き出し。支払いや返金は受取人に計上され、受取人が
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を含む、GPUが1基以上、GPUあたりメモリ80000 MiB以上、24回のハートビートの95%以上で稼働、fp16 matmulで200 TFLOPS以上。
プローブ
プローブは、買い手の通常のワークロードと同じく、レンタルしたインスタンスの中で動きます。ホストのマシンやネットワークへのアクセスは不要です。1日を通じて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メインネットでの3日間
2026年11月12日。レンタルしたA100、1日あたり0.20 USDCをエスクロー、合計14トランザクション。2日目にホストがA40に差し替え、その日は返金されました。
| 日 | プローブが確認した内容 | 結果 | 判定トランザクション |
|---|---|---|---|
| 1日目 | NVIDIA A100-SXM4-80GB、チェック合格 | ホストに支払い | 0xa292…37ba |
| 2日目 | 契約したA100ではなくNVIDIA A40(48 GB) | 買い手に返金 | 0x7fe8…4b16 |
| 3日目 | 再びNVIDIA A100-SXM4-80GB、チェック合格 | ホストに支払い | 0x3118…ea46 |
現時点での制約
- コントラクトはOlympixの自動ツールで確認済みです。独立した手動監査はまだのため、最初の取引は小額で上限付きです。
- マシンを管理するホストが、プローブに偽の測定値を渡そうとする可能性があります。本番環境ではプローブのイメージを固定し、インスタンスの外部から測定値を照合します。
始める
お持ちのGPUと1日あたりの価格をお知らせください:predge.io/gpu、またはTelegramでご連絡ください:t.me/latcom。
連絡先
30 分の通話を予約: calendly.com/hello-predge/30min。または hello@predge.io にメールするか、Telegram でご連絡ください: t.me/latcom。