Auf dieser Seite
  1. Urteile
    1. Aktuell: v2.1-Verträge auf 9 EVM-Chains
    2. Legacy v1 (bekannte Probleme, keine Gelder)
    3. Legacy v1 auf Arc Mainnet (chainId 5042)
    4. Ein vollständiger Durchlauf auf Mainnet
    5. Chains: v2.1 auf 9 Chains, Legacy v1 auf 16 Mainnets
    6. Zcash: abgeschirmtes 2-von-3-Escrow (Mainnet)
    7. Urteil anfordern (API)
    8. Monatlicher Bericht zur Streitbearbeitung
    9. Preise
  2. Settlement-Risiko
    1. Was du bekommst
    2. Streitfall-Tracker (kostenlos)
    3. Settlement-Schätzung (kostenpflichtig)
    4. Desk: Benachrichtigungen zu den Märkten deiner Wallets
  3. Whale-Daten-API und MCP
    1. Aus dem Code aufrufen
    2. MCP-Server
  4. Gehosteter MCP-Server
    1. Verbinden
    2. OAuth
    3. Pläne und Limits
    4. Tools
  5. Bezahlen
    1. 1. Schlüsselloses x402, pro Aufruf
    2. 2. Pilotschlüssel: 30 Tage kostenlos, danach pro Aufruf
    3. 3. Desk, für Trader
    4. 4. Schlüssel und Guthaben verwalten
  6. Signatur prüfen
    1. Was signiert wird
  7. GPU-Vermietung: Bezahlung pro geprüftem Tag
    1. Vertrag: AgentJobV2 auf Arc Mainnet
    2. SLA und specHash
    3. Probe
    4. Urteil
    5. Nachweis: drei Tage auf Arc Mainnet
    6. Grenzen heute
    7. Loslegen
  8. Kontakt

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.

Beispiel
Ein Agent bezahlt für einen Bericht, der nie ankommt. Der Zahler hinterlegt den Hash seines Belegs on-chain, Predge entscheidet auf Rückerstattung und nennt diesen Hash, und die Rückerstattung wird ausgeführt. So war der Arbiter-Vertrag gedacht; die heutigen API-Urteile sind signierte Einträge mit einer Rückerstattungsempfehlung.
01 · Auftrag des Agenten geliefert?

Urteile

Die API für signierte Urteile ist das Produkt. Urteile werden mit dem veröffentlichten ed25519-Schlüssel von Predge signiert und sind offline überprüfbar (siehe „Urteil anfordern“ unten). Die On-Chain-Verträge sind optional und garantieren keinen Rechtsweg. v2.1-Verträge sind live auf Arc, Base, Arbitrum, Avalanche, BNB Chain, Celo, Optimism, Sonic und Unichain (unten). 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. Die v1-Verträge auf 16 Chains sind Legacy: bekannte Probleme aus unserer eigenen Prüfung (siehe Trust), keine Gelder gehalten.

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.

VertragAdresse (alle 9 v2.1-Chains)Links
PredgeAgentValidatorV20xE4CFdE5dbD9afD518b9c59136939607505bF643DSourcify · Arc · Base
AgentJobV20x5C673c6aBF3c60C3F6Ce3f1509f5d99C08F8B13FSourcify · Arc · Base
PredgeValidatorBondV20x97E960Fe3D7759af8f51A95319859E60Df554329Sourcify · Arc · Base
PredgeSettlementV20x6fac55c5187A9cdb519F77163C7e3fD9E87F6f24Sourcify · Arc · Base
MockRefundProtocolV2 (demo refund protocol)0x50041FdAb10f8f56E24FA9CA806f082CcAeb05E9Sourcify · Arc · Base
PredgeRefundArbiterV20xf404F908cb1ba47C01AB8526B725aAA940557eA9Sourcify · 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.

  1. Die Parteien reichen Belege ein. Zahler oder Händler hinterlegen sha256(evidence) on-chain mit dem eigenen Schlüssel.
  2. 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.
  3. Anfechtungsfrist von 1 Tag. Der v1-Vertrag definiert ein Zeitfenster von 86.400 Sekunden, in dem challenge aufgerufen werden kann. Die aktuellen Verträge halten keine Gelder.
  4. Vorgesehene Prüfung, keine funktionierende Absicherung. challenge sollte 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.
Klartext: v1 ist ein Referenz-Deployment mit bekannten Problemen. Kein On-Chain-Mechanismus beweist, dass eine Entscheidung richtig war, und v2 behebt die uns bekannten Befunde, ist aber noch nicht extern gescannt. Details und Daten: Trust.

Legacy v1 auf Arc Mainnet (chainId 5042)

VertragAdresse
PredgeRefundArbiter0xA9c39e9aEd452Ee638a10aC10f6A6288C4Ca6E89
MockRefundProtocol (Demo-Ziel)0xf6659f725B3F790287a75f7A83C373E2a3D908aa
PredgeValidatorBond v2.10xfeE8b89eb8aa2499F7025Cd9aaEB13a4b046d0d1
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).

ChainchainIdVerträgeLinks
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
VertragAdresse von Legacy v1 (alle 16 Chains)
PredgeRefundArbiter0xb2972B4944Eec83946EB7B23D572AbE04F46E22c
PredgeValidatorBond v2.10x800B5596a8540e752dE8f8a8AF99E927d139A643
PredgeAgentValidator (ERC-8004)0x925767fdce6C819F027f55CC50464e3bCdfD2671
AgentJob (ERC-8183)0xcBaB4a9FA4d756b4C5e2a18F055d2E0132CE7D1D
PredgeSettlement0x47BE8a7d461De505723a0Ac1d74982e53f8E412b
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 report

Zahle 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.

Die Rückerstattung ist eine Empfehlung, keine automatische Rückerstattung. Predge bewegt in dieser Version kein Geld: Der Block 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

Kostenlos30-tägiger Pilot
$0.05pro Urteil, bei Aufrufen unter $1
$0.50pro Urteil, bei Aufrufen ab $1

Kostenlosen Piloten starten: Dein Schlüssel erscheint in Sekunden auf der Seite. Fragen? Telegram.

02 · Prognosemärkte

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-ID 3b6551a6439b9bda. 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/active

Settlement-Schätzung (kostenpflichtig)

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

Der 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/events

Webhook-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.

03 · Für Agenten

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.

RoutePreis
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=10

Jeder 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.

Für Menschen · Gehosteter MCP

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/mcp

Streamable 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.

DokumentURL
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

KostenlosProDesk
Preis$0$20/Monat oder $195/Jahr$300/Monat, 14 Tage kostenlos testen
Toolssearch_markets, live_whale_trades, top_whalesalle Lese-ToolsPro-Tools plus Desk-Benachrichtigungen und Wallets
Aufrufe pro UTC-Tag252,0002,000
Aufrufe pro Minute1060120
DatenTrades um 90 s verzögert, bis zu 10 Zeilen pro Aufruflivelive

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

ToolPlanWas es tut
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

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.

Für Agenten · Bezahlen

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/me

3. 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 needed
04 · Vertraue niemandem

Signatur 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-Key3b6551a6439b9bda0de7e3b8dc89f276b2141fdfde310f762e663ab4ba2e9d1b
Schlüsselregisterapi.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

Was 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"))); // true

Spezifikation: 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.

05 · GPU-Vermietung

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.

Gebühr: 2% jedes bezahlten Tages, zahlt der Host. Nichts bei erstatteten Tagen. Der Vertrag zieht die Gebühr nicht ab: Er zahlt das volle Escrow des Tages aus.

Vertrag: AgentJobV2 auf Arc Mainnet

VertragAdresse (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.

  1. 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.
  2. Einreichen. Vor expiredAt ruft der Host (provider) submit(jobId, deliverable, output) auf. deliverable ist der sha256 der Belegdatei des Tages. output ist optional: Wird es mitgesendet, prüft der Vertrag on-chain, dass sein sha256 gleich deliverable ist.
  3. Entscheiden. Innerhalb von evaluationWindow nach der Einreichung ruft Predge complete(jobId, reason, data) auf, um den provider zu bezahlen, oder reject(jobId, reason, data), um dem client zu erstatten. reason ist ein bytes32-Commitment auf das signierte Urteil.
  4. 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.
  5. Abheben. Eine Auszahlung oder Erstattung wird dem Empfänger gutgeschrieben, der sie mit withdraw() oder withdrawTo(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.

TagWas die Probe sahErgebnisUrteils-Transaktion
Tag 1NVIDIA A100-SXM4-80GB, Prüfungen bestandenAn den Host gezahlt0xa292…37ba
Tag 2NVIDIA A40 (48 GB) statt der vereinbarten A100An den Käufer erstattet0x7fe8…4b16
Tag 3Wieder NVIDIA A100-SXM4-80GB, Prüfungen bestandenAn den Host gezahlt0x3118…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.

06 · Sprich mit uns

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.