# Predge API > Predge is the trust and dispute layer for AI-agent payments: it answers "was the paid job delivered?" with a signed ruling, and a refund recommendation when the work never arrived, rail-agnostic by design; live today on x402 (the networks listed below). Every ruling is signed with Predge's published ed25519 key and verifiable offline. v2.1 contracts are live on Celo, Arc, Base, Arbitrum, OP Mainnet, Avalanche, BNB Chain, Sonic and Unichain (addresses at https://predge.io/docs#chains); refunds are recommendations the merchant executes; the signed verdict is the product. See https://predge.io/docs#verdicts . This API serves the first vertical, prediction markets: pay-per-call over x402 in USDC, no account and no API key. Signed settlement-risk records read live from UMA on Polygon (free route), Polymarket whale and smart-money data, and ed25519-signed attestations that verify offline against Predge's published key (kid 13fa3d18a369e6c7). Paid data is delayed 15 minutes. Product docs: https://predge.io/docs . Long form for LLMs: https://predge.io/llms-full.txt . ## Discovery - [API index](https://api.predge.io/): every route with its price and the payment networks - [x402 manifest](https://api.predge.io/.well-known/x402): machine-readable payment requirements per route - [OpenAPI](https://api.predge.io/openapi.json): same route table in OpenAPI format - [Agent card](https://api.predge.io/.well-known/agent.json): ERC-8004 registration document - [Health](https://api.predge.io/health): service and database status ## How to pay Request a paid route; the HTTP 402 response carries a `payment-required` header (base64 JSON) whose `accepts[]` has one entry per network (the JSON body also explains the price in plain words and lists the Base and Solana entries for x402 v1 clients). Pay the USDC amount on any one of them and retry. Any x402 client works, e.g. `npx x402-proxy https://api.predge.io/v1/whales/latest?limit=10`. Networks (same USD price on each): - Base `eip155:8453`, facilitator PayAI - Solana `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`, facilitator PayAI - Algorand `algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=`, facilitator GoPlausible - Arc `eip155:5042`, facilitator Circle - Monad `eip155:143`, facilitator Monad ## Free pilot key and what comes after - https://predge.io/start : a free 30-day pilot key in one step (email, no card). Send it as the header `x-predge-key: `. It gives a daily quota on the free signed routes and the paid settlement estimate (`GET /v1/settlement-risk/:market/estimate`) at no charge for 30 days. `GET /v1/me` with the key shows your plan, quota and expiry; https://predge.io/account is the same in a page. - After the 30 days the estimate answers 402 again (header `X-Predge-Pilot: estimate_grant_expired ...`). Keep going without any account by paying per call over x402 as described above (USDC, same price as listed below); the key is not needed for that. Client code: https://predge.io/docs#paying . - https://predge.io/desk : Desk for traders, settlement alerts on your Polymarket wallets, $300/month after a free trial. ## Free routes - [Settlement risk](https://api.predge.io/v1/settlement-risk/5608010): `GET /v1/settlement-risk/:market` (condition id, numeric market id or slug), signed; risk_level is ok, watch, caution or resolved. UMA-resolved Polymarket Protocol V2 markets are supported; other V2 markets return 422 unsupported_protocol_v2, never a "no risk" answer - [Dispute tracker](https://api.predge.io/v1/settlement-risk/active): `GET /v1/settlement-risk/active` every Polymarket UMA dispute of the last 30 days with status (disputed = reset for a new proposal, uma_vote, resolved), the live uma_state and open_dispute (same rule as the signed record) and a link to each market's signed record; page at https://data.predge.io/disputes - [Verify](https://api.predge.io/verify): `GET|POST /verify` checks a signed record (`canonical`, `signature`, `public_key`, or `id` of a call) - [Key registry](https://api.predge.io/.well-known/predge-keys.json): published keys, each with `status` active, retired or revoked. /verify answers `valid: false`, `reason: key_revoked` for a signature under a revoked key and still reports `signature_ok` ## Delivery verdicts (was the paid work delivered?) A buyer or merchant that paid for a service call sends the job spec (what was promised), the delivery evidence (status, headers, body or its sha256, timing) and the payment reference, and gets a signed verdict: `delivered`, `not_delivered` or `inconclusive`, per-check results (status, content type, non-empty, JSON, JSON Schema, required fields, sha256, latency), reason codes and a refund recommendation. Deterministic checks, no LLM, no human at Predge. `POST /v1/verdicts` is $0.05 when the paid call is under $1; `POST /v1/verdicts/large` is $0.50 at $1 or more (the wrong tier answers 400 `wrong_tier` and is not charged). A pilot key (`x-predge-key`) is free inside its 30-day pilot window. Free re-read by id: `GET /v1/verdicts/:id`. The refund is a recommendation the merchant executes: nothing is refunded automatically; the signed verdict is the product. v2.1 contracts are live on Celo, Arc, Base, Arbitrum, OP Mainnet, Avalanche, BNB Chain, Sonic and Unichain (addresses at https://predge.io/docs#chains). Optional know-your-agent fields: `agent` and `provider_agent` (`id`, `version`, `operator`, optional `authorization_ref`) are signed into the verdict and returned. Monthly signed dispute-handling report for a key holder, free and counted as one call: `GET /v1/verdicts/report?month=YYYY-MM` (optional `merchant_id`, `limit`, `cursor`; header `x-predge-key`; covers only the verdicts that key requested; counts, refund recommendations, top reason codes, time to verdict, verdict ids with verify URLs, a sample and the methodology; verifies with `/verify`). Docs: https://predge.io/docs#verdicts . ## Desk (for traders, by key) Settlement alerts on every Polymarket market your wallets hold: proposal, dispute, UMA vote, bulletin-board update and on-chain resolution, sent to a webhook (HMAC-SHA256 signed, `x-predge-signature`) and Telegram, each event with the signed settlement-risk record. Routes take a Desk key in `x-predge-key`: `GET|PUT /v1/desk/config`, `POST /v1/desk/test`, `GET /v1/desk/events`. Docs: https://predge.io/docs#desk . Desk: self-serve 14-day trial at https://predge.io/desk . ## Paid routes (USD per call) - `GET /v1/whales/latest` $0.005: latest whale trades, $10,000+ notional (query limit 1-100) - `GET /v1/whales/market/:conditionId` $0.01: whale activity for one market over 7 days - `GET /v1/wallets/leaderboard` $0.01: top wallets over 7d or 30d, ranked by edge over resolved markets - `GET /v1/wallets/compare` $0.02: 2-10 wallets side by side - `GET /v1/wallets/:address` $0.01: one wallet's profile - `GET /v1/markets/movers` $0.005: largest YES-price moves over 1h/6h/24h - `GET /v1/signals/consensus` $0.03: smart-money consensus across markets - `GET /v1/signals/market/:conditionId` $0.01: single-market smart-money verdict - `GET /v1/signals/daily` $0.02: 24h whale digest - `GET /v1/signals/consensus/:category` $0.02: smart-money consensus for one category - `GET /v1/signals/daily/:category` $0.01: 24h whale digest for one category - `GET /v1/wallets/:address/history` $0.02: wallet trades plus win-rate and modeled PnL curve (resolved markets only) - `GET /v1/markets/:conditionId/edge` $0.002: lean per-market smart-money pulse, built for polling - `GET /v1/markets/:conditionId/history` $0.01: price/volume history for one market - `GET /v1/attest/:conditionId` $0.02: signed resolved-outcome attestation for one Polymarket market - `GET /v1/sports/attest/:league/:eventId` $0.02: signed settled sports outcome for one game - `GET /v1/settlement-risk/:market/estimate` $0.02: signed settlement-risk record with settlement_estimate (400/404/422/502 not charged) - `POST /v1/verdicts` $0.05: delivery verdict for a paid call under $1: did the service deliver as promised? Signed verdict, per-check results, refund recommendation (400 wrong_tier not charged) - `POST /v1/verdicts/large` $0.50: same, for a paid call of $1 or more - `GET /v1/bets/biggest` $0.005: largest single trades across all markets in a window - `POST /v1/calls` $0.10: commit a signed, hash-chained yes/no call on an open Polymarket market - `POST /v1/calls/:id/resolve` $0.02: attach the settled outcome to a signed call - `GET /v1/track-record/:pubkey` $0.05: signed track record of a predictor's resolved calls - `POST /v1/stakes` $0.02: bind a bounded, pre-funded rebate to a signed call while its market is open Currently paused (503 signed_wallet_outputs_paused): `GET /v1/wallets/:address/attest`, `GET /v1/onchain/pm-activity/:wallet`, `GET /v1/onchain/pm-flows`, the free `GET /v1/signal/:address`. ## Verify signatures - [Canonicalization spec](https://data.predge.io/canonicalization.md): the exact signed bytes and the body signature - [Browser verifier](https://data.predge.io/verify) - [verify_record.py](https://data.predge.io/verify_record.py): offline Python verifier Each record carries `attestation.canonical`, `attestation.signature` (hex) and `attestation.kid`. Verify ed25519 over the UTF-8 bytes of `canonical` with the published key `13fa3d18a369e6c71bf941563ba47822b30182273d5106a0e8fb61c5016352d9`, not the key inside the response. Settlement-risk records are at payload_version 3 (dates signed as gamma_end_date, uma_end_date, closed_time). The whole body is also signed in `x-predge-body-signature`: ed25519 over `predge-body-v1`, a newline, then the raw body. ## MCP - [@predge/whale-data-mcp](https://www.npmjs.com/package/@predge/whale-data-mcp): `npx -y @predge/whale-data-mcp`. Free tools need no key; paid tools need BUYER_PRIVATE_KEY and are capped by MAX_PRICE_USD (default $0.05) before paying ## Contact - hello@predge.io - https://t.me/latcom