Predge entscheidet, ob der bezahlte Auftrag eines Agenten geliefert wurde, mit einem signierten Eintrag, den jeder prüfen kann.
Predge ist die Vertrauens- und Streitschicht für Zahlungen von KI-Agenten. Die Zahlungswege bewegen das Geld; Predge beantwortet die Frage, die sie offen lassen: Wurde der bezahlte Auftrag geliefert? Mit einer Entscheidung, die mit dem veröffentlichten ed25519-Schlüssel von Predge signiert und offline überprüfbar ist, und mit einer Rückerstattungsempfehlung, wenn die Leistung nie ankam. v2-Verträge sind auf Arc und Base live (Adressen unter Chains; Status: Trust); Rückerstattungen sind Empfehlungen, die der Händler ausführt, und das signierte Urteil ist das Produkt. Wir betreiben keinen Zahlungsweg. Heute live: x402-Zahlungen auf Base, Solana, Arc, Monad und Algorand; das Design ist unabhängig vom Zahlungsweg. Prognosemärkte sind die erste Vertikale: Dieselben signierten Einträge erfassen das Settlement-Risiko auf Polymarket, wo wir 3.005 UMA-Streitfälle vom 1. Jan. bis 2. Okt. 2026 analysiert haben.
Urteile
Aktuell: v2.1-Verträge auf 9 EVM-Chains
v2.1 wurde am 23. Okt. 2026 auf Arc (5042) und Base (8453) bereitgestellt und am 26. Okt. 2026 auf Arbitrum, Avalanche, BNB Chain, Celo, Optimism, Sonic und Unichain (Chain-Liste und Links unter Chains). Auf jeder Chain dieselben sechs Adressen, alle auf Sourcify verifiziert (exact match). Sie beheben unsere eigenen Befunde aus der Selbstprüfung H-01 bis H-03 und M-01 bis M-05.
| Vertrag | Adresse (alle 9 v2.1-Chains) | Links |
|---|---|---|
| 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 |
Owner: 0x9084f5000E07C7133D6dA5eE4f271AB6D1821144, ein vorübergehender einzelner EOA. Eine Übertragung an eine Safe-2-von-3-Multisig (Ownable2Step) ist geplant, Ziel 23. Okt. 2026. Operator (Hot-Ops-Schlüssel, vom Owner rotierbar): 0x8ffFB76c4329DDC8ee4a859DDF55AB48ba25e292. Bonds sind ein Mindestbetrag von etwa $5 im nativen Token der jeweiligen Chain (zum Beispiel 5 USDC auf Arc, 0,002 ETH auf Base), kein Prozentsatz des Auftragswerts. Sie sind keine Garantie. Ein externer Pre-Audit-Scan (Olympix) ist erledigt: 10 Befunde behoben, 7 bewusst akzeptiert; die Korrekturen sind in v2.1 enthalten. Ein vollständiges Audit ist weiterhin geplant. Belege: predgeAI/predge-deploy.
Legacy v1 (bekannte Probleme, keine Gelder)
Der Rest dieses Abschnitts beschreibt, wie die v1-Verträge funktionieren sollten. Das ist Geschichte, keine Garantie.
Predge sitzt auf dem Schiedsstellen-Platz eines Rückerstattungsprotokolls (nach dem Muster des Refund Protocol von Circle und der x402r-Rückerstattungserweiterung). Der Vertrag PredgeRefundArbiter sollte begrenzen, was dieser Platz tun kann.
- Die Parteien reichen Belege ein. Zahler oder Händler hinterlegen
sha256(evidence)on-chain mit dem eigenen Schlüssel. - Predge entscheidet und zitiert ihn. Die Entscheidung hält den Beleg-Hash und die Richtung (Rückerstattung oder Freigabe) fest, bevor Geld bewegt wird.
rule()akzeptiert nur Belege, die bereits on-chain hinterlegt wurden. - Anfechtungsfrist von 1 Tag. Der v1-Vertrag definiert ein Zeitfenster von 86.400 Sekunden, in dem
challengeaufgerufen werden kann. Die aktuellen Verträge halten keine Gelder. - Vorgesehene Prüfung, keine funktionierende Absicherung.
challengesollte den von Predge zitierten Hash mit dem vergleichen, den die Partei hinterlegt hat. Unsere Prüfung vom 20. Okt. 2026 ergab, dass eine Anfechtung nach einer erfolgreichen Entscheidung nie Erfolg haben kann (Befund H-03); verlasse dich also nicht darauf. Die v2-Verträge sollen das beheben.
Legacy v1 auf Arc Mainnet (chainId 5042)
| Vertrag | Adresse |
|---|---|
| PredgeRefundArbiter | 0xA9c39e9aEd452Ee638a10aC10f6A6288C4Ca6E89 |
| MockRefundProtocol (Demo-Ziel) | 0xf6659f725B3F790287a75f7A83C373E2a3D908aa |
| PredgeValidatorBond v2.1 | 0xfeE8b89eb8aa2499F7025Cd9aaEB13a4b046d0d1 |
| AgentJob (ERC-8183) | 0x8B9589B8F5857dDe080Ac68e8B370c3bA5E74495 |
| PredgeAgentValidator (ERC-8004) | 0xbe601d486D821450F9248ab91891736B1a09699F |
On-Chain gelesen: Diese Schiedsstelle (0xA9c3…6E89) hat challengeWindow = 86400 s und minBond = 0,05 USDC (Arcs nativer Gas-Token); der Bond hat disputeWindow = 86400 s. Die Untergrenze von 0,05 USDC gilt nur für diese frühere Arc-Schiedsstelle.
Ein vollständiger Durchlauf auf Mainnet
Ein Demonstrationslauf auf der früheren Arc-Schiedsstelle: Der Zahler hinterlegt einen Beleg, die Schiedsstelle entscheidet mit genau diesem Eintrag als Grundlage, und eine Rückerstattung wird gegen das Demo-Rückerstattungsprotokoll ausgeführt: fileEvidence · rule. Eine zweite Entscheidung zitierte einen nicht hinterlegten Beleg, und dagegen wurde eine Anfechtung (challenge) eingelegt. Das ist Geschichte aus der Zeit vor unserer Prüfung vom 20. Okt., keine Garantie; die aktuellen Verträge halten keine Gelder.
Dieser Lauf (18. Sep. 2026) nutzte die vorherige Schiedsstellen-Version, 0xA1533757…5Ad967. Die oben genannte aktive Schiedsstelle ergänzt eine Regel: Ein Beleg muss on-chain hinterlegt sein, bevor er zitiert werden kann. Quellcode und Belege: predgeAI/predge-arc.
Chains: v2.1 auf 9 Chains, Legacy v1 auf 16 Mainnets
Aktuell: v2.1 auf den 9 unten mit v2.1 markierten Chains, Adressen in der v2.1-Tabelle oben. Legacy v1 (bekannte Probleme, keine Gelder): ein Vertragssatz, eine Adresse pro Vertrag, auf jeder Chain unten. Quellcode auf Sourcify verifiziert (exact match).
| Chain | chainId | Verträge | Links |
|---|---|---|---|
| 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 |
| Vertrag | Adresse von Legacy v1 (alle 16 Chains) |
|---|---|
| PredgeRefundArbiter | 0xb2972B4944Eec83946EB7B23D572AbE04F46E22c |
| PredgeValidatorBond v2.1 | 0x800B5596a8540e752dE8f8a8AF99E927d139A643 |
| PredgeAgentValidator (ERC-8004) | 0x925767fdce6C819F027f55CC50464e3bCdfD2671 |
| AgentJob (ERC-8183) | 0xcBaB4a9FA4d756b4C5e2a18F055d2E0132CE7D1D |
| PredgeSettlement | 0x47BE8a7d461De505723a0Ac1d74982e53f8E412b |
| MockRefundProtocol (demo target) | 0xcaC30945CDF0F963f38972d939e111B87b80Cf79 |
On-Chain gelesen, auf allen 16 Chains gleich: Die Schiedsstelle hat challengeWindow = 86400 s und minBond = 1015 wei, also 0,001 des nativen Tokens der Chain (0,001 ETH auf Ethereum und den ETH-L2s, sonst 0,001 BNB, POL, AVAX, CELO, xDAI, S, MNT oder MON; auf Arc ist der native Token USDC, also 0,001 USDC). Der Bond wird im nativen Token hinterlegt.
Am 18. Okt. 2026 bereitgestellt von 0x5d016C1B4d7A42eB7c982da1Ae7fFdB958CFCAe9. Belege pro Chain: predgeAI/predge-deploy. Die Arc-Tabelle oben ist das frühere Arc-Deployment und der vollständige Mainnet-Lauf; beide bleiben live. Brauchst du eine andere EVM-Chain? Frag uns: Sie ist an einem Tag bereitgestellt.
Zcash: abgeschirmtes 2-von-3-Escrow (Mainnet)
Zcash · Mainnet. Predge betreibt ein abgeschirmtes 2-von-3-FROST-Escrow auf Zcash. Käufer, Verkäufer und eine neutrale Schiedsstelle (Predge) halten je einen Schlüsselanteil, und zwei beliebige davon können auszahlen. Die Schiedsstelle zeichnet nur genau die Zahlung mit, die ihr Ed25519-signiertes Urteil benennt; allein kann sie keine Gelder bewegen. Die Gelder liegen im abgeschirmten Ironwood-Pool von Zcash, und on-chain sieht eine Auszahlung wie eine gewöhnliche abgeschirmte Transaktion aus.
Status: Alle drei Pfade (Freigabe, Rückerstattung im Streitfall, Auszahlung im Streitfall) sowie die Weigerung der Schiedsstelle, eine falsche Auszahlung zu signieren, liefen am 31. Okt. 2026 Ende zu Ende im öffentlichen Zcash-Testnet. Am 13. Nov. 2026 lief der Rückerstattungspfad im Streitfall auf dem Zcash-Mainnet mit echtem ZEC: 0,02 ZEC wurden in das Escrow eingezahlt, die Schiedsstelle verweigerte eine Auszahlung an den Verkäufer, die ihr Urteil nicht benannte, und dann zeichneten Käufer und Schiedsstelle die Rückerstattung gemeinsam (Mainnet-Auszahlungstransaktion 50407885adf3b688f30d3a2e8d020297f1adb775dc9b5e2be9e6d50c61fcd5f2). Beispiel einer Testnet-Rückerstattungstransaktion: 2bc943804f1b30eb256a3f33b79a60677621c01e4cb41320ba7a32ee70c1f711.
Code: predgeAI/zcash-escrow. Predge steuert außerdem Manipulations-Testfälle zu OpenPGP-Wallet/frost-zec bei: Mitsignierer müssen eine PCZT ablehnen, die an die falsche Adresse zahlt.
Urteil anfordern (API)
Dein Agent hat für einen Dienstaufruf bezahlt. Schick Predge, was versprochen wurde, was ankam und was bezahlt wurde, und du erhältst ein signiertes Urteil zurück: delivered, not_delivered oder inconclusive. Die Prüfungen sind deterministisch (kein Modell, kein Mensch bei Predge): HTTP-Status, Content-Type, nicht leerer Body, gültiges JSON, dein JSON-Schema, Pflichtfelder, ein erwarteter sha256 und eine Latenzgrenze. Predge beobachtet die Lieferung nicht, das Urteil ist also nur so wahr wie die Belege, die du sendest.
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 reportZahle per x402 (USDC auf Base, Solana, Algorand, Arc oder Monad, ohne Schlüssel) oder sende einen Pilotschlüssel in x-predge-key: kostenlos während deines 30-tägigen Piloten, angerechnet auf das Tageskontingent des Schlüssels. Ein Aufruf in der falschen Preisstufe erhält 400 wrong_tier und wird nicht berechnet.
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"}
}'Know your agent (optional). Füge agent (den Käufer-Agenten) und provider_agent (den Agenten des Händlers) hinzu, jeweils mit id (eine ERC-8004-Agenten-ID oder ein beliebiger stabiler String), version, operator (das verantwortliche Unternehmen oder Wallet) und einer optionalen authorization_ref (eine Mandats- oder Policy-ID). Sie werden von dir angegeben und von Predge nicht überprüft, aber sie werden ins Urteil signiert, gespeichert und zurückgegeben (null, wenn nicht angegeben), sodass die Angabe nachträglich nicht geändert werden kann. Anfragen ohne sie funktionieren wie bisher.
Antwort (gekürzt):
{
"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": "..."}
}Aus TypeScript, mit einem Pilotschlüssel:
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);Das Urteil wird mit demselben ed25519-Schlüssel signiert wie jeder Predge-Eintrag (das Feld attestation und der Header x-predge-body-signature über den gesamten Body); prüfe es offline, wie unter Verify beschrieben. Wer die ID hat, kann es kostenlos unter GET /v1/verdicts/:id erneut abrufen; IDs sind nicht erratbar.
Monatlicher Bericht zur Streitbearbeitung
Für ein Risiko- oder Compliance-Team: GET /v1/verdicts/report?month=2026-10 mit deinem Schlüssel in x-predge-key (optional merchant_id, limit bis 1000, cursor). Er ist kostenlos und zählt als ein Aufruf im Kontingent des Schlüssels. Ein Schlüssel sieht nur die Urteile, die er angefordert hat; ohne Schlüssel lautet die Antwort 401.
curl "https://api.predge.io/v1/verdicts/report?month=2026-10" -H "x-predge-key: $PREDGE_KEY"Der Bericht enthält die Zahlen (gesamt, geliefert, nicht geliefert, nicht eindeutig), Rückerstattungsempfehlungen (Anzahl und Gesamtbetrag in USD), die häufigsten Reason-Codes, Median und p95 der Zeit vom Zeitstempel des Lieferbelegs bis zum Urteil, die Urteils-IDs mit Ergebnis und verify_url (paginiert), eine reproduzierbare Stichprobe und einen Hinweis zur methodology. Er ist wie ein Urteil signiert (attestation und x-predge-body-signature) und lässt sich daher offline nach Verify prüfen. Er zählt signierte Einträge auf Basis der Belege, die die Anfragenden geliefert haben; er ist kein Audit der Lieferungen.
refund nennt, wer wem wie viel zahlen soll, und der Händler führt es aus, per Gutschrift oder Erstattung außerhalb der Chain oder per Überweisung an den Zahler. Das signierte Urteil ist das Produkt; onchain ist in Urteilsantworten null. v2-Verträge sind auf Arc und Base live (Adressen unter Chains).Preise
Kostenlosen Piloten starten: Dein Schlüssel erscheint in Sekunden auf der Seite. Fragen? Telegram.
Settlement-Risiko
Ein Aufruf sagt dir, ob die Auflösung eines Polymarket-Marktes abgeschlossen, strittig oder in Erwartung einer UMA-Abstimmung ist, live gelesen aus UMAs Optimistic Oracle und Polymarkets UMA-CTF-Adapter auf Polygon. Kostenlos, ohne Schlüssel, signiert.
curl https://api.predge.io/v1/settlement-risk/:market:market = Condition-ID, numerische Markt-ID oder Slug.
Protocol-V2-Märkte: Von UMA aufgelöste werden über Polymarkets OracleAggregator gelesen (protocol: "v2"); von Chainlink oder einem EOA gemeldete sowie atomare Neg-Risk-V2-Märkte liefern 422 unsupported_protocol_v2, bis sie unterstützt werden. Ein 422 oder 404 ist nie die Antwort „kein Risiko“.
Was du bekommst
risk_level:ok(kein Vorschlag, kein Streit),watch,caution(strittig, an eine UMA-Abstimmung übergeben oder pausiert),resolved(die On-Chain-Auflösung ist endgültig).uma_state,dispute_count, jeder Streitfall mit seiner Tx,sent_to_uma_vote, Bulletin-Board-Updates,onchain_resolution.segment_dispute_rate: wie oft Märkte dieser Art 2026 strittig waren, mit einem 95-%-Intervall.attestation: eine ed25519-Signatur über den Eintrag, Schlüssel-ID3b6551a6439b9bda. Siehe Verify.
Streitfall-Tracker (kostenlos)
Jeder Polymarket-Markt, der in den letzten 30 Tagen auf UMA strittig war, mit seinem Status (disputed, uma_vote, resolved) und einem Link zu seinem signierten Eintrag. Seite: data.predge.io/disputes. Einbettbares Badge: <iframe src="https://data.predge.io/badge?market=ID" width="320" height="96">.
curl https://api.predge.io/v1/settlement-risk/activeSettlement-Schätzung (kostenpflichtig)
GET https://api.predge.io/v1/settlement-risk/:market/estimateDer vollständige signierte Eintrag plus settlement_estimate. $0.02 pro Aufruf über x402, in USDC auf Base, Solana, Algorand, Arc oder Monad; die Zahlung, die ihn gekauft hat, steht im signierten Eintrag. Ein 400/404/422/502 wird nicht berechnet; Protocol-V2-Märkte liefern hier 422 unsupported_protocol_v2, bis die Schätzung sie unterstützt. Pilotpartner können einen Schlüssel erhalten (Header x-predge-key), der sie ohne Zahlung freischaltet.
Signierte Zahlungsbelege folgen der offenen Spezifikation in predgeAI/x402-receipts.
Desk: Benachrichtigungen zu den Märkten deiner Wallets
Für Trader. Füge bis zu 10 Wallets hinzu; jeder Polymarket-Markt, den sie halten, wird beobachtet, und jedes Settlement-Ereignis geht an deinen Webhook und an Telegram: proposal, dispute, uma_vote (zweimal angefochten, das Ergebnis geht in eine UMA-Abstimmung), bulletin_update (Klarstellungen und andere Hinweise) und resolution. Jedes Ereignis enthält den signierten Settlement-Risiko-Eintrag, den Beleg für jeden Streitfall. 14-tägige Desk-Testphase starten, danach $300/Monat.
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-Zustellungen sind signiert: x-predge-signature: sha256=HMAC-SHA256(secret, "<x-predge-timestamp>.<raw body>"). Lehne Zeitstempel ab, die mehr als 5 Minuten abweichen. Antworten außerhalb von 2xx werden etwa eine Stunde lang wiederholt. Derselbe Schlüssel deckt 5.000 Aufrufe von /estimate pro Monat ab.
Whale-Daten-API und MCP
Polymarket-Whale-Trades, Wallet-Track-Records nach ergebnisgeprüftem Edge geordnet, Smart-Money-Signale und signierte Attestierungen. Zahle pro Aufruf in USDC über x402: kein Konto, kein API-Schlüssel.
| Route | Preis |
|---|---|
| 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, signiert |
Vollständige Routenliste und Preise: api.predge.io · openapi.json · /.well-known/x402. Kostenpflichtige Daten sind um 15 Minuten verzögert.
Aus dem Code aufrufen
npx x402-proxy https://api.predge.io/v1/whales/latest?limit=10Jeder x402-Client funktioniert (zum Beispiel @x402/fetch): Route anfragen, die 402 lesen, zahlen, erneut versuchen.
MCP-Server
claude mcp add predge-whale-data \
-e BUYER_PRIVATE_KEY=0xYOUR_FUNDED_BASE_KEY \
-e X402_NETWORK=base \
-- npx -y @predge/whale-data-mcp@predge/whale-data-mcp auf npm (Quellcode). Kostenpflichtige Tools geben echtes USDC aus und sind durch MAX_PRICE_USD ($0.05 standardmäßig) hart begrenzt, bevor Geld bewegt wird. Die kostenlosen Tools (Discovery, Settlement-Risiko, Prüfung von Einträgen) brauchen keinen Schlüssel. Nutze eine eigene Käufer-Wallet mit kleinem Guthaben. Für ein Abo mit Anmeldung statt Wallet nutze den gehosteten MCP-Server.
Gehosteter MCP-Server
Predge in Claude, ChatGPT, Cursor, Codex und anderen MCP-Clients: Polymarket-Whale-Trades, Wallet-Profile, Insider-Signale und die signierte Settlement-Risiko-Prüfung, mit Desk-Benachrichtigungen zu den Märkten deiner Wallets. Eine URL, Anmeldung mit deinem Predge-Konto, keine Wallet und keine Zahlungen pro Aufruf an Predge. Das ist der Abo-Weg für Menschen; Agenten, die pro Aufruf zahlen, nutzen den npm-Server und x402, und Urteile gibt es in der API.
https://app.predge.io/mcpStreamable HTTP, zustandslos, JSON-Antworten. Ohne Zugangsdaten antwortet er mit 401 und WWW-Authenticate: Bearer resource_metadata="https://app.predge.io/.well-known/oauth-protected-resource/mcp".
Verbinden
Claude (claude.ai, Desktop, mobil): Customize > Connectors > Add custom connector, die URL von oben einfügen, „Sign in now“ wählen, bei Predge anmelden und Allow klicken. ChatGPT: Plugins > + > Add custom MCP server, die URL einfügen, OAuth wählen. In Team- und Enterprise-Plänen fügt ein Owner den Connector einmal für die Organisation hinzu.
Clients, die einen Header akzeptieren, verwenden ein persönliches Zugriffstoken. Erstelle eines unter app.predge.io/app/agents (es beginnt mit pgm_, wird nur einmal angezeigt, bis zu 10 pro Konto) und sende es als Authorization: Bearer pgm_…. Diese Seite enthält auch Copy-and-paste-Anleitungen für jeden Client.
# 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
OAuth 2.1 nach der MCP-Autorisierungsspezifikation, für Clients mit Connect-Button. Dynamische Client-Registrierung (RFC 7591) unter /oauth/register, nur öffentliche Clients, es gibt also keine Client-ID und kein Secret einzugeben. Authorization Code mit PKCE S256 (Pflicht), Refresh-Tokens mit Rotation, Access-Tokens 1 Stunde gültig, Scope mcp. Jede Verbindung erscheint unter app.predge.io/app/agents als verbundene App und kann dort getrennt werden.
| Dokument | URL |
|---|---|
| Geschützte Ressource (RFC 9728) | app.predge.io/.well-known/oauth-protected-resource/mcp |
| Autorisierungsserver (RFC 8414) | app.predge.io/.well-known/oauth-authorization-server |
Pläne und Limits
| Kostenlos | Pro | Desk | |
|---|---|---|---|
| Preis | $0 | $20/Monat oder $195/Jahr | $300/Monat, 14 Tage kostenlos testen |
| Tools | search_markets, live_whale_trades, top_whales | alle Lese-Tools | Pro-Tools plus Desk-Benachrichtigungen und Wallets |
| Aufrufe pro UTC-Tag | 25 | 2,000 | 2,000 |
| Aufrufe pro Minute | 10 | 60 | 120 |
| Daten | Trades um 90 s verzögert, bis zu 10 Zeilen pro Aufruf | live | live |
Bei Überschreitung eines Limits oder bei einem Tool, das dein Plan nicht enthält, liefert der Aufruf einen MCP-Tool-Fehler, der den Grund nennt und auf app.predge.io/app/settings verweist. Wechsle dort den Plan und rufe erneut auf. Desk: Testphase starten.
Tools
| Tool | Plan | Was es tut |
|---|---|---|
| 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 |
Nur lesend, außer desk_add_wallet, das nur deine eigene Desk-Wallet-Liste bearbeitet. Tools mit dem Vermerk „paid x402 to“ an einen anderen Anbieter belasten dich nicht über Predge: Das Tool liefert die x402-Zahlungsanforderung dieses Anbieters zurück, und dein eigener x402-Client bezahlt den Anbieter direkt. Predge hält nie Schlüssel und platziert nie Orders. Settlement-Exits (ein Verkauf bei 2¢ oder weniger oder bei 98¢ oder mehr) werden aus Trade-Listen weggelassen, sofern du sie nicht anforderst.
Bezahlen
Drei Wege, je nachdem, wer du bist, dazu ein Dashboard zum Verwalten von Schlüsseln und Guthaben (4). Derselbe x402-Aufruf funktioniert in allen; ein Schlüssel ändert nur, was kostenlos ist.
1. Schlüsselloses x402, pro Aufruf
Kein Konto und kein Schlüssel. Du rufst eine kostenpflichtige Route auf, die API antwortet mit 402 samt Preis und akzeptierten Netzwerken, dein Client zahlt in USDC und wiederholt die Anfrage. Der 402-Header (PAYMENT-REQUIRED) ist x402 v2; der JSON-Body sagt dasselbe in einfachen Worten. Du brauchst eine Wallet mit etwas USDC in einem der akzeptierten Netzwerke. Hier ein vollständiger Node-Client für Base mit den v2-Paketen:
// 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());Verwende nicht das alte Paket x402-fetch v1: Es liest das Angebot aus dem Body, und eine v1-Zahlung ist nicht das, was der v2-Server erwartet. Zum Ausprobieren ohne Code: npx x402-proxy https://api.predge.io/v1/whales/latest?limit=10. Preise und Netzwerke pro Route: llms.txt.
2. Pilotschlüssel: 30 Tage kostenlos, danach pro Aufruf
Hol dir einen Schlüssel unter predge.io/start (nur E-Mail). Sende ihn als x-predge-key. 30 Tage lang erhältst du damit ein Tageskontingent für die kostenlosen signierten Routen und für die kostenpflichtige Settlement-Schätzung (GET /v1/settlement-risk/:market/estimate) ohne Gebühr. Nach 30 Tagen antwortet die Schätzung wieder mit 402 und dem Header X-Predge-Pilot: estimate_grant_expired. Danach zahlst du pro Aufruf mit dem schlüssellosen x402-Client von oben; der Schlüssel wird dafür nicht gebraucht. Plan, Kontingent und Ablauf siehst du mit GET /v1/me oder auf predge.io/account.
curl -H "x-predge-key: $PREDGE_KEY" https://api.predge.io/v1/me3. Desk, für Trader
Settlement-Benachrichtigungen zu deinen Polymarket-Wallets, $300 im Monat nach einer kostenlosen Testphase. Details und Anmeldung: predge.io/desk. API: oben.
4. Schlüssel und Guthaben verwalten
Melde dich unter app.predge.io/developers an, um deine API-Schlüssel an einem Ort zu verwalten: Schlüssel erstellen (bis zu 5 aktive, einmal angezeigt und nur als Hash gespeichert), umbenennen, widerrufen (wirksam ab der nächsten Anfrage) und rotieren (sofort ein neuer Schlüssel, der alte funktioniert noch für eine von dir gewählte Übergangsfrist, standardmäßig 24 Stunden). Außerdem zeigt es die Nutzung pro Schlüssel (heute, 7 und 30 Tage, nach Route) und dein Kontingent. Hast du einen Pilotschlüssel von predge.io/start? Öffne den Link unter deinem neuen Schlüssel oder füge den Schlüssel im Dashboard ein, um ihn deinem Konto zuzuordnen. Pilotschlüssel und Cabinet-Schlüssel (pdg_live_…) funktionieren gleich.
Um von einem Guthaben statt pro Aufruf zu zahlen, lade unter Billing USDC auf ($20, $50, $200 oder ein eigener Betrag von $10 bis $1.000). Aufrufe mit x-predge-key auf bepreiste Datenrouten ziehen ihren Preis dann zuerst aus deinem Guthaben, und die Antwort sagt es (X-Predge-Credits-Charged, X-Predge-Credits-Balance). Ein fehlgeschlagener Aufruf wird nicht berechnet. Ohne Guthaben oder bei einer Route, deren signierte Antwort eine x402-Zahlung nennt (/v1/attest, /v1/wallets/:address/attest, /v1/track-record), zahlst du pro Aufruf über x402 genau wie oben. Jede Aufladung hat einen Beleg zum Ausdrucken.
curl -H "x-predge-key: $PREDGE_KEY" https://api.predge.io/v1/whales/latest # paid from credits, no x402 client neededSignatur prüfen
Jeder signierte Eintrag trägt eine attestation mit canonical (den exakt signierten Bytes), signature und kid. Prüfe sie offline gegen das Schlüsselregister von Predge, nicht gegen den Schlüssel in der Antwort: Finde den Schlüssel über kid und lehne jeden Schlüssel ab, den das Register als revoked führt, egal wann die Signatur erstellt wurde. Schlüssel rotieren; lies das Register neu, statt einen Schlüssel fest zu hinterlegen.
| Aktuelle Schlüssel-ID (kid) | 3b6551a6439b9bda |
| ed25519-Public-Key | 3b6551a6439b9bda0de7e3b8dc89f276b2141fdfde310f762e663ab4ba2e9d1b |
| Schlüsselregister | 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"))); // trueWas signiert wird
Bei Settlement-Risiko-Einträgen (payload_version: "2", seit 18. Okt. 2026) deckt die Signatur auch die Marktfrage und den Slug ab, den sha256 jedes Bulletin-Board-Updates und den Polygon-Block, auf dem jeder Lesezugriff erfolgte (block: Nummer und Hash). Jeder eth_call läuft auf diesem Block, sodass ein Archive-Node den Eintrag exakt reproduziert. Seit payload_version: "3" werden die Marktdaten unter ihren Polymarket-Namen signiert: gamma_end_date (das bei der Erstellung gesetzte geplante Ende, oft veraltet), uma_end_date und closed_time (wann der Markt tatsächlich geschlossen wurde), jeweils ISO-8601 UTC oder null, mit den rohen Gamma-Strings in gamma_dates_raw. Das Feld end_date der Version 2 entfällt; lies gamma_end_date für denselben Wert. Ältere Einträge bleiben gültig.
Auch der gesamte HTTP-Body wird signiert, im Header x-predge-body-signature: ed25519 über predge-body-v1, einen Zeilenumbruch und dann die rohen Body-Bytes.
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"))); // trueSpezifikation: data.predge.io/canonicalization.md, Abschnitte 5a und 5b. Python: python3 verify_record.py record.json --body-signature "<header>" (verify_record.py).
Ohne Code: Füge einen Eintrag in data.predge.io/verify ein. Für signierte x402-Zahlungsbelege liegen Spezifikation, TypeScript-Bibliothek und Testvektoren unter predgeAI/x402-receipts.
GPU-Vermietung: Bezahlung pro geprüftem Tag
Abrechnung für die Vermietung von GPU-Zeit an einen Käufer, den du nicht kennst. Der Käufer zahlt jeden Tag vorab in USDC in einen Escrow-Vertrag auf Arc. Eine Probe prüft den Tag, und Predge signiert ein Urteil. Ein gelieferter Tag wird an den Host gezahlt; ein fehlgeschlagener Tag geht an den Käufer zurück. Überblick für Hosts und Käufer: predge.io/gpu.
Vertrag: AgentJobV2 auf Arc Mainnet
| Vertrag | Adresse (Arc, chainId 5042) |
|---|---|
| AgentJobV2 (Job-Escrow im Stil von ERC-8183) | 0x5C673c6aBF3c60C3F6Ce3f1509f5d99C08F8B13F |
Ein Job pro gemietetem Tag. USDC ist der native Gas-Token von Arc, daher ist das Escrow der mit createJob gesendete Betrag. Die USDC liegen im Vertrag, nicht bei Predge.
- Anlegen. Der Käufer (client) ruft
createJob(provider, evaluator, specHash, expiredAt)auf und sendet den Tagespreis; dieser Betrag ist das Escrow. Der Evaluator muss sich vom client und vom provider unterscheiden. Bei GPU-Deals ist Predge der Evaluator. - Einreichen. Vor
expiredAtruft der Host (provider)submit(jobId, deliverable, output)auf.deliverableist der sha256 der Belegdatei des Tages.outputist optional: Wird es mitgesendet, prüft der Vertrag on-chain, dass sein sha256 gleichdeliverableist. - Entscheiden. Innerhalb von
evaluationWindownach der Einreichung ruft Predgecomplete(jobId, reason, data)auf, um den provider zu bezahlen, oderreject(jobId, reason, data), um dem client zu erstatten.reasonist ein bytes32-Commitment auf das signierte Urteil. - Zeitablauf. Läuft der Job ohne Einreichung ab oder entscheidet Predge nicht innerhalb des Bewertungsfensters, kann jeder
claimRefund(jobId)aufrufen, und das Escrow geht an den client. - Abheben. Eine Auszahlung oder Erstattung wird dem Empfänger gutgeschrieben, der sie mit
withdraw()oderwithdrawTo(to)abhebt.
Einen Job liest du mit getJob(jobId). Events: JobCreated, Submitted, Completed, Rejected, Refunded, Withdrawn.
SLA und specHash
Host und Käufer vereinbaren das SLA, bevor der Käufer zahlt. Jeder Tag hat eine Spec: Deal-ID, Tagesnummer, Zeitfenster, Preis, SLA, Adressen von Host und Käufer sowie Netzwerk. Der sha256 ihres kanonischen JSON ist der specHash des Jobs, damit sind die Bedingungen des Tages on-chain festgelegt. Das SLA des Deals 1x A100 80GB:
"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
}Zu lesen als: Der GPU-Name enthält A100, mindestens 1 GPU, mindestens 80000 MiB Speicher pro GPU, in mindestens 95% von 24 Heartbeats erreichbar und mindestens 200 TFLOPS beim fp16-Matmul.
Probe
Die Probe läuft in der gemieteten Instanz, wie jede Arbeitslast des Käufers. Sie braucht keinen Zugriff auf die Maschinen oder das Netzwerk des Hosts. Über den Tag zeichnet sie nvidia-smi-Heartbeats auf (GPU-Name, Anzahl, Speicher) und führt einen kurzen fp16-Benchmark aus: ein 8192x8192-Matmul auf cuda:0 mit PyTorch und CUDA, etwa 10 Sekunden. Das Ergebnis ist ein Beleg-JSON (predge-compute-evidence-v1). Sein sha256 ist das deliverable, das der Host on-chain einreicht.
Urteil
Predge prüft den Beleg gegen die Spec und signiert ein Urteil für den Tag: delivered oder not_delivered. Es nutzt denselben predge-attest-v1-Umschlag wie andere Predge-Urteile (ed25519 über kanonisches JSON) und bindet den Hash der Job-Spec (job_sha256), die Vorauszahlungs-Transaktion (payment_ref) und den Beleg-Hash (delivery.body_sha256). Prüfe es offline wie jedes Urteil: Urteile und Signatur prüfen.
Nachweis: drei Tage auf Arc Mainnet
12. Nov. 2026. Eine gemietete A100, 0,20 USDC pro Tag im Escrow, insgesamt 14 Transaktionen. An Tag 2 setzte der Host eine A40 ein, und der Tag wurde erstattet.
| Tag | Was die Probe sah | Ergebnis | Urteils-Transaktion |
|---|---|---|---|
| Tag 1 | NVIDIA A100-SXM4-80GB, Prüfungen bestanden | An den Host gezahlt | 0xa292…37ba |
| Tag 2 | NVIDIA A40 (48 GB) statt der vereinbarten A100 | An den Käufer erstattet | 0x7fe8…4b16 |
| Tag 3 | Wieder NVIDIA A100-SXM4-80GB, Prüfungen bestanden | An den Host gezahlt | 0x3118…ea46 |
Grenzen heute
- Der Vertrag wurde mit den automatischen Tools von Olympix geprüft. Ein unabhängiges manuelles Audit gibt es noch nicht, deshalb sind die ersten Deals klein und gedeckelt.
- Ein Host, der die Maschine kontrolliert, könnte versuchen, der Probe falsche Messwerte zu liefern. In Produktion pinnen wir das Probe-Image und gleichen die Messwerte von außerhalb der Instanz ab.
Loslegen
Nenne uns deine GPUs und deinen Preis pro Tag: predge.io/gpu, oder schreib uns auf Telegram: t.me/latcom.
Kontakt
Buche einen 30-minütigen Anruf: calendly.com/hello-predge/30min. Oder schreib an hello@predge.io, oder schreib uns auf Telegram: t.me/latcom.