Predge dictamina si el trabajo pagado de un agente se entregó, con un registro firmado que cualquiera puede comprobar.
Predge es la capa de confianza y disputas para los pagos de agentes de IA. Las redes mueven el dinero; Predge responde la pregunta que dejan abierta, ¿se entregó el trabajo pagado?, con un dictamen firmado con la clave ed25519 publicada de Predge y verificable sin conexión, y una recomendación de reembolso cuando el trabajo nunca llegó. Los contratos v2 están activos en Arc y Base (direcciones en Cadenas; estado: Confianza); los reembolsos son recomendaciones que ejecuta el comercio, y el veredicto firmado es el producto. No operamos una red de pagos. Activo hoy: pagos x402 en Base, Solana, Arc, Monad y Algorand; el diseño es independiente de la red. Los mercados de predicción son la primera vertical: los mismos registros firmados siguen el riesgo de liquidación en Polymarket, donde analizamos 3.005 disputas de UMA del 1 de ene al 2 de oct de 2026.
Veredictos
Actual: contratos v2.1 en 9 cadenas EVM
v2.1 se desplegó en Arc (5042) y Base (8453) el 23 de oct de 2026, y en Arbitrum, Avalanche, BNB Chain, Celo, Optimism, Sonic y Unichain el 26 de oct de 2026 (lista de cadenas y enlaces en Cadenas). Las mismas seis direcciones en todas las cadenas, todas verificadas en Sourcify (coincidencia exacta). Corrigen los hallazgos de nuestra propia autorrevisión H-01 a H-03 y M-01 a M-05.
| Contrato | Dirección (las 9 cadenas v2.1) | Enlaces |
|---|---|---|
| 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 |
Propietario: 0x9084f5000E07C7133D6dA5eE4f271AB6D1821144, una EOA única y temporal. Está prevista la transferencia a un multisig Safe 2 de 3 (Ownable2Step), objetivo 23 de oct de 2026. Operador (clave operativa en caliente, rotable por el propietario): 0x8ffFB76c4329DDC8ee4a859DDF55AB48ba25e292. Las fianzas son un mínimo de unos $5 en el token nativo de cada cadena (por ejemplo 5 USDC en Arc, 0,002 ETH en Base), no un porcentaje del valor del trabajo. No son una garantía. Se hizo un análisis previo a la auditoría externa (Olympix): 10 hallazgos corregidos, 7 aceptados por diseño; las correcciones están en v2.1. Todavía está prevista una auditoría completa. Recibos: predgeAI/predge-deploy.
v1 heredado (problemas conocidos, sin fondos)
El resto de esta sección describe cómo se diseñó el funcionamiento de los contratos v1. Es historia, no una garantía.
Predge ocupa el puesto de árbitro de un protocolo de reembolso (con la forma del Refund Protocol de Circle y la extensión de reembolso x402r). El contrato, PredgeRefundArbiter, se diseñó para limitar lo que puede hacer ese puesto.
- Las partes presentan evidencia. El pagador o el comercio registra
sha256(evidence)en la cadena con su propia clave. - Predge dictamina, citándola. El dictamen registra el hash de la evidencia y la dirección (reembolso o liberación) antes de mover dinero.
rule()solo acepta evidencia que ya se registró en la cadena. - Ventana de impugnación de 1 día. El contrato v1 define una ventana de 86.400 segundos en la que se puede llamar a
challenge. Los contratos actuales no custodian fondos. - Comprobación prevista, no una salvaguarda que funcione.
challengese diseñó para comparar el hash que citó Predge con el que registró la parte. Nuestra revisión del 20 de oct de 2026 encontró que, tras un dictamen exitoso, una impugnación nunca puede prosperar (hallazgo H-03), así que no confíes en ella. Los contratos v2 están pensados para resolverlo.
v1 heredado en Arc mainnet (chainId 5042)
| Contrato | Dirección |
|---|---|
| PredgeRefundArbiter | 0xA9c39e9aEd452Ee638a10aC10f6A6288C4Ca6E89 |
| MockRefundProtocol (destino de demostración) | 0xf6659f725B3F790287a75f7A83C373E2a3D908aa |
| PredgeValidatorBond v2.1 | 0xfeE8b89eb8aa2499F7025Cd9aaEB13a4b046d0d1 |
| AgentJob (ERC-8183) | 0x8B9589B8F5857dDe080Ac68e8B370c3bA5E74495 |
| PredgeAgentValidator (ERC-8004) | 0xbe601d486D821450F9248ab91891736B1a09699F |
Leído on-chain: este árbitro (0xA9c3…6E89) tiene challengeWindow = 86400 s y minBond = 0,05 USDC (el token de gas nativo de Arc); la fianza disputeWindow = 86400 s. El mínimo de 0,05 USDC se aplica solo a este árbitro anterior de Arc.
Una ejecución completa en mainnet
Una ejecución de demostración con el árbitro anterior de Arc: el pagador registra la evidencia, el árbitro dictamina citando exactamente ese registro y se ejecuta un reembolso contra el protocolo de reembolso de demostración: fileEvidence · rule. Un segundo dictamen citó evidencia no registrada, y se presentó una impugnación (challenge) contra él. Es historia anterior a nuestra revisión del 20 de oct, no una garantía; los contratos actuales no custodian fondos.
Esa ejecución (18 de sep de 2026) usó la versión anterior del árbitro, 0xA1533757…5Ad967. El árbitro activo de arriba añade una regla: la evidencia debe registrarse on-chain antes de poder citarse. Código y recibos: predgeAI/predge-arc.
Cadenas: v2.1 en 9 cadenas, v1 heredado en 16 mainnets
Actual: v2.1 en las 9 cadenas marcadas v2.1 abajo, con direcciones en la tabla v2.1 de arriba. v1 heredado (problemas conocidos, sin fondos): un solo conjunto de contratos, una dirección por contrato, en cada cadena de abajo. Código fuente verificado en Sourcify (coincidencia exacta).
| Cadena | chainId | Contratos | Enlaces |
|---|---|---|---|
| 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 |
| Contrato | Dirección del v1 heredado (las 16 cadenas) |
|---|---|
| PredgeRefundArbiter | 0xb2972B4944Eec83946EB7B23D572AbE04F46E22c |
| PredgeValidatorBond v2.1 | 0x800B5596a8540e752dE8f8a8AF99E927d139A643 |
| PredgeAgentValidator (ERC-8004) | 0x925767fdce6C819F027f55CC50464e3bCdfD2671 |
| AgentJob (ERC-8183) | 0xcBaB4a9FA4d756b4C5e2a18F055d2E0132CE7D1D |
| PredgeSettlement | 0x47BE8a7d461De505723a0Ac1d74982e53f8E412b |
| MockRefundProtocol (demo target) | 0xcaC30945CDF0F963f38972d939e111B87b80Cf79 |
Leído on-chain, igual en las 16 cadenas: el árbitro tiene challengeWindow = 86400 s y minBond = 1015 wei, es decir, 0,001 del token nativo de la cadena (0,001 ETH en Ethereum y las L2 de ETH; en las demás, 0,001 BNB, POL, AVAX, CELO, xDAI, S, MNT o MON; en Arc el token nativo es USDC, así que 0,001 USDC). La fianza se deposita en el token nativo.
Desplegado el 18 de oct de 2026 desde 0x5d016C1B4d7A42eB7c982da1Ae7fFdB958CFCAe9. Recibos por cadena: predgeAI/predge-deploy. La tabla de Arc de arriba es el despliegue anterior en Arc y la ejecución completa en mainnet; ambos siguen activos. ¿Necesitas otra cadena EVM? Pídenosla: se despliega en un día.
Zcash: escrow blindado 2 de 3 (mainnet)
Zcash · mainnet. Predge opera un escrow blindado FROST 2 de 3 en Zcash. El comprador, el vendedor y un árbitro neutral (Predge) poseen cada uno una parte de la clave, y cualquiera dos de ellos pueden autorizar el pago. El árbitro cofirma solo el pago exacto que nombra su veredicto firmado con Ed25519; no puede mover fondos por sí solo. Los fondos están en el pool blindado Ironwood de Zcash, y en la cadena un pago se ve como una transacción blindada normal.
Estado: los tres caminos (liberación, reembolso por disputa, pago por disputa), además de que el árbitro rechace un pago incorrecto, se ejecutaron de principio a fin en la testnet pública de Zcash el 31 de oct de 2026. El 13 de nov de 2026 el camino de reembolso por disputa se ejecutó en la mainnet de Zcash con ZEC reales: se depositaron 0,02 ZEC en el escrow, el árbitro rechazó un pago al vendedor que su veredicto no nombraba, y luego el comprador y el árbitro cofirmaron el reembolso (transacción de pago en mainnet 50407885adf3b688f30d3a2e8d020297f1adb775dc9b5e2be9e6d50c61fcd5f2). Transacción de reembolso de ejemplo en testnet: 2bc943804f1b30eb256a3f33b79a60677621c01e4cb41320ba7a32ee70c1f711.
Código: predgeAI/zcash-escrow. Predge también aporta casos de prueba de manipulación a OpenPGP-Wallet/frost-zec: los cofirmantes deben rechazar un PCZT que pague a la dirección equivocada.
Solicitar un veredicto (API)
Tu agente pagó por una llamada a un servicio. Envía a Predge lo prometido, lo que llegó y lo que se pagó, y recibe de vuelta un veredicto firmado: delivered, not_delivered o inconclusive. Las comprobaciones son deterministas (sin modelo y sin personas en Predge): estado HTTP, tipo de contenido, cuerpo no vacío, JSON válido, tu JSON Schema, campos obligatorios, un sha256 esperado y un límite de latencia. Predge no observa la entrega, así que el veredicto es tan cierto como la evidencia que envíes.
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 reportPaga por x402 (USDC en Base, Solana, Algorand, Arc o Monad, sin clave) o envía una clave piloto en x-predge-key: gratis durante tu piloto de 30 días, contado en la cuota diaria de la clave. Una llamada enviada al nivel de precio equivocado recibe 400 wrong_tier y no se cobra.
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"}
}'Conoce a tu agente (opcional). Añade agent (el agente comprador) y provider_agent (el agente del comercio), cada uno con id (un id de agente ERC-8004 o cualquier cadena estable), version, operator (la empresa o wallet responsable) y un authorization_ref opcional (un id de mandato o política). Los declaras tú y Predge no los verifica, pero quedan firmados en el veredicto, almacenados y devueltos (null si no se indican), de modo que la declaración no puede cambiarse después. Las solicitudes sin ellos funcionan como antes.
Respuesta (abreviada):
{
"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": "..."}
}Desde TypeScript, con una clave piloto:
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);El veredicto se firma con la misma clave ed25519 que todos los registros de Predge (el campo attestation y la cabecera x-predge-body-signature sobre todo el cuerpo); compruébalo sin conexión como se describe en Verificar. Quien tenga el id puede volver a leerlo gratis en GET /v1/verdicts/:id; los ids no se pueden adivinar.
Informe mensual de gestión de disputas
Para un equipo de riesgo o cumplimiento: GET /v1/verdicts/report?month=2026-10 con tu clave en x-predge-key (opcionales merchant_id, limit hasta 1000, cursor). Es gratis y cuenta como una llamada en la cuota de la clave. Una clave solo ve los veredictos que solicitó; sin clave la respuesta es 401.
curl "https://api.predge.io/v1/verdicts/report?month=2026-10" -H "x-predge-key: $PREDGE_KEY"El informe contiene los recuentos (total, entregados, no entregados, no concluyentes), las recomendaciones de reembolso (número y total en USD), los principales códigos de motivo, la mediana y el p95 del tiempo entre la marca de tiempo de la evidencia de entrega y el veredicto, los ids de veredicto con su resultado y verify_url (paginado), una muestra reproducible y una nota de methodology. Está firmado como un veredicto (attestation y x-predge-body-signature), así que se verifica sin conexión según Verificar. Cuenta registros firmados construidos sobre la evidencia que aportaron los solicitantes; no es una auditoría de las entregas.
refund indica quién debe pagar a quién y cuánto, y el comercio lo ejecuta, con un crédito o reembolso fuera de la cadena o una transferencia al pagador. El veredicto firmado es el producto; onchain es null en las respuestas de veredicto. Los contratos v2 están activos en Arc y Base (direcciones en Cadenas).Precios
Empieza un piloto gratis: tu clave aparece en la página en segundos. ¿Preguntas? Telegram.
Riesgo de liquidación
Una llamada te dice si la resolución de un mercado de Polymarket está liquidada, en disputa o esperando un voto de UMA, leída en directo del Optimistic Oracle de UMA y del adaptador UMA CTF de Polymarket en Polygon. Gratis, sin clave, firmada.
curl https://api.predge.io/v1/settlement-risk/:market:market = condition id, id numérico del mercado o slug.
Mercados del Protocolo V2: los resueltos por UMA se leen a través del OracleAggregator de Polymarket (protocol: "v2"); los mercados V2 reportados por Chainlink o por una EOA y los neg-risk atómicos devuelven 422 unsupported_protocol_v2 hasta que se admitan. Un 422 o un 404 nunca significa «sin riesgo».
Qué obtienes
risk_level:ok(sin propuesta ni disputa),watch,caution(en disputa, enviado a voto de UMA o en pausa),resolved(la resolución on-chain es definitiva).uma_state,dispute_count, cada disputa con su tx,sent_to_uma_vote, actualizaciones del tablón de anuncios,onchain_resolution.segment_dispute_rate: con qué frecuencia se disputaron en 2026 los mercados de este tipo, con un intervalo del 95%.attestation: una firma ed25519 sobre el registro, key id3b6551a6439b9bda. Ver Verificar.
Seguimiento de disputas (gratis)
Todos los mercados de Polymarket en disputa en UMA en los últimos 30 días, con su estado (disputed, uma_vote, resolved) y un enlace a su registro firmado. Página: data.predge.io/disputes. Insignia incrustable: <iframe src="https://data.predge.io/badge?market=ID" width="320" height="96">.
curl https://api.predge.io/v1/settlement-risk/activeEstimación de liquidación (de pago)
GET https://api.predge.io/v1/settlement-risk/:market/estimateEl registro firmado completo más settlement_estimate. $0.02 por llamada con x402, en USDC en Base, Solana, Algorand, Arc o Monad; el pago que la compró queda dentro del registro firmado. Un 400/404/422/502 no se cobra; los mercados del Protocolo V2 devuelven aquí 422 unsupported_protocol_v2 hasta que la estimación los admita. Los socios piloto pueden obtener una clave (cabecera x-predge-key) que la desbloquea sin pago.
Los recibos de pago firmados siguen la especificación abierta en predgeAI/x402-receipts.
Desk: alertas sobre los mercados que tienen tus wallets
Para traders. Añade hasta 10 wallets; se vigila cada mercado de Polymarket que tengan, y cada evento de liquidación se envía a tu webhook y a Telegram: proposal, dispute, uma_vote (disputado dos veces, el resultado va a un voto de UMA), bulletin_update (aclaraciones y otros avisos) y resolution. Cada evento incluye el registro firmado de riesgo de liquidación, la evidencia de cada disputa. Empieza la prueba de 14 días de Desk, luego $300/mes.
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/eventsLas entregas de webhook van firmadas: x-predge-signature: sha256=HMAC-SHA256(secret, "<x-predge-timestamp>.<raw body>"). Rechaza marcas de tiempo con más de 5 minutos de diferencia. Las respuestas que no sean 2xx se reintentan durante aproximadamente una hora. La misma clave cubre 5.000 llamadas a /estimate al mes.
API de datos de ballenas y MCP
Operaciones de ballenas de Polymarket, historiales de wallets ordenados por ventaja verificada con resultados, señales de smart money y atestaciones firmadas. Paga por llamada en USDC con x402: sin cuenta, sin clave de API.
| Ruta | Precio |
|---|---|
| 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, firmado |
Lista completa de rutas y precios: api.predge.io · openapi.json · /.well-known/x402. Los datos de pago llegan con 15 minutos de retraso.
Llámala desde código
npx x402-proxy https://api.predge.io/v1/whales/latest?limit=10Sirve cualquier cliente x402 (por ejemplo @x402/fetch): pide la ruta, lee el 402, paga y reintenta.
Servidor MCP
claude mcp add predge-whale-data \
-e BUYER_PRIVATE_KEY=0xYOUR_FUNDED_BASE_KEY \
-e X402_NETWORK=base \
-- npx -y @predge/whale-data-mcp@predge/whale-data-mcp en npm (código). Las herramientas de pago gastan USDC reales y tienen un tope estricto con MAX_PRICE_USD ($0.05 por defecto) antes de mover dinero. Las herramientas gratuitas (descubrimiento, riesgo de liquidación, verificación de registros) no necesitan clave. Usa una wallet de comprador dedicada y con poco saldo. Para una suscripción con inicio de sesión en lugar de una wallet, usa el servidor MCP alojado.
Servidor MCP alojado
Predge dentro de Claude, ChatGPT, Cursor, Codex y otros clientes MCP: operaciones de ballenas de Polymarket, perfiles de wallets, señales de insiders y la comprobación firmada de riesgo de liquidación, con alertas de Desk para los mercados que tienen tus wallets. Una URL, inicias sesión con tu cuenta de Predge, sin wallet y sin pagos por llamada a Predge. Es la vía de suscripción para personas; los agentes que pagan por llamada usan el servidor npm y x402, y los veredictos están en la API.
https://app.predge.io/mcpHTTP en streaming, sin estado, respuestas JSON. Sin credenciales responde 401 con WWW-Authenticate: Bearer resource_metadata="https://app.predge.io/.well-known/oauth-protected-resource/mcp".
Conectar
Claude (claude.ai, Desktop, móvil): Customize > Connectors > Add custom connector, pega la URL de arriba, elige «Sign in now», inicia sesión en Predge y pulsa Allow. ChatGPT: Plugins > + > Add custom MCP server, pega la URL, elige OAuth. En los planes Team y Enterprise, un propietario añade el conector una vez para toda la organización.
Los clientes que aceptan una cabecera usan un token de acceso personal. Crea uno en app.predge.io/app/agents (empieza por pgm_, se muestra una sola vez, hasta 10 por cuenta) y envíalo como Authorization: Bearer pgm_…. Esa página también tiene la configuración para copiar y pegar de cada cliente.
# 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 según la especificación de autorización de MCP, para clientes con botón de conexión. Registro dinámico de clientes (RFC 7591) en /oauth/register, solo clientes públicos, así que no hay client id ni secret que introducir. Código de autorización con PKCE S256 (obligatorio), refresh tokens con rotación, access tokens válidos durante 1 hora, scope mcp. Cada conexión aparece en app.predge.io/app/agents como una app conectada y se puede desconectar allí.
| Documento | URL |
|---|---|
| Recurso protegido (RFC 9728) | app.predge.io/.well-known/oauth-protected-resource/mcp |
| Servidor de autorización (RFC 8414) | app.predge.io/.well-known/oauth-authorization-server |
Planes y límites
| Gratis | Pro | Desk | |
|---|---|---|---|
| Precio | $0 | $20/mes o $195/año | $300/mes, prueba gratuita de 14 días |
| Herramientas | search_markets, live_whale_trades, top_whales | todas las herramientas de lectura | Herramientas Pro más alertas y wallets de Desk |
| Llamadas por día UTC | 25 | 2,000 | 2,000 |
| Llamadas por minuto | 10 | 60 | 120 |
| Datos | operaciones con 90 s de retraso, hasta 10 filas por llamada | en directo | en directo |
Si superas un límite, o usas una herramienta que tu plan no incluye, la llamada devuelve un error de herramienta MCP que explica el motivo y enlaza a app.predge.io/app/settings. Mejora tu plan allí y vuelve a llamar. Desk: empieza la prueba.
Herramientas
| Herramienta | Plan | Qué hace |
|---|---|---|
| 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 |
Solo lectura, salvo desk_add_wallet, que solo edita tu propia lista de wallets de Desk. Las herramientas marcadas «paid x402 to» otro proveedor no te cobran a través de Predge: la herramienta devuelve el requisito de pago x402 de ese proveedor y tu propio cliente x402 le paga directamente. Predge nunca custodia claves ni coloca órdenes. Las salidas por liquidación (una venta a 2¢ o menos, o a 98¢ o más) se omiten de las listas de operaciones salvo que las pidas.
Pagos
Tres formas, según quién seas, más un panel para gestionar claves y créditos (4). La misma llamada x402 funciona en todas; una clave solo cambia lo que es gratis.
1. x402 sin clave, por llamada
Sin cuenta y sin clave. Llamas a una ruta de pago, la API responde 402 con el precio y las redes que acepta, tu cliente paga en USDC y repite la solicitud. La cabecera 402 (PAYMENT-REQUIRED) es x402 v2; el cuerpo JSON dice lo mismo en lenguaje llano. Necesitas una wallet con algo de USDC en una de las redes aceptadas. Este es un cliente Node completo para Base, con los paquetes v2:
// 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());No uses el antiguo paquete x402-fetch v1: lee la oferta del cuerpo, y un pago v1 no es lo que espera el servidor v2. Para probar sin escribir código: npx x402-proxy https://api.predge.io/v1/whales/latest?limit=10. Precios y redes por ruta: llms.txt.
2. Clave piloto: gratis 30 días, luego por llamada
Consigue una clave en predge.io/start (solo con email). Envíala como x-predge-key. Durante 30 días te da una cuota diaria en las rutas firmadas gratuitas y la estimación de liquidación de pago (GET /v1/settlement-risk/:market/estimate) sin coste. Pasados los 30 días la estimación vuelve a responder 402, con la cabecera X-Predge-Pilot: estimate_grant_expired. A partir de ahí pagas por llamada con el cliente x402 sin clave de arriba; la clave no hace falta para eso. Consulta tu plan, cuota y vencimiento con GET /v1/me o en predge.io/account.
curl -H "x-predge-key: $PREDGE_KEY" https://api.predge.io/v1/me3. Desk, para traders
Alertas de liquidación sobre tus wallets de Polymarket, $300 al mes tras una prueba gratuita. Detalles y registro: predge.io/desk. API: arriba.
4. Gestionar claves y créditos
Inicia sesión en app.predge.io/developers para gestionar tus claves de API en un solo lugar: crea claves (hasta 5 activas, se muestran una vez y se guardan solo como hash), renómbralas, revócalas (surte efecto en la siguiente solicitud) y rótalas (una clave nueva ya, y la antigua sigue funcionando durante un periodo de gracia que eliges, 24 horas por defecto). También muestra el uso por clave (hoy, 7 y 30 días, por ruta) y tu cuota. ¿Tienes una clave piloto de predge.io/start? Abre el enlace bajo tu clave nueva, o pega la clave en el panel, para asociarla a tu cuenta. Las claves piloto y las del panel (pdg_live_…) funcionan igual.
Para pagar desde un saldo en lugar de por llamada, añade fondos en USDC en Facturación ($20, $50, $200 o la cantidad que quieras entre $10 y $1.000). Las llamadas con x-predge-key a rutas de datos con precio toman primero su precio de tus créditos, y la respuesta lo indica (X-Predge-Credits-Charged, X-Predge-Credits-Balance). Una llamada que falla no se cobra. Sin créditos, o en una ruta cuya respuesta firmada nombra un pago x402 (/v1/attest, /v1/wallets/:address/attest, /v1/track-record), pagas por llamada con x402 exactamente como arriba. Cada recarga tiene un recibo que puedes imprimir.
curl -H "x-predge-key: $PREDGE_KEY" https://api.predge.io/v1/whales/latest # paid from credits, no x402 client neededVerificar una firma
Cada registro firmado lleva una attestation con canonical (los bytes exactos firmados), signature y kid. Compruébala sin conexión contra el registro de claves de Predge, no contra la clave que viene en la respuesta: busca la clave por kid y rechaza cualquier clave que el registro marque como revoked, sea cual sea el momento en que se hizo la firma. Las claves rotan; vuelve a leer el registro en lugar de fijar una clave.
| Id de la clave actual (kid) | 3b6551a6439b9bda |
| Clave pública ed25519 | 3b6551a6439b9bda0de7e3b8dc89f276b2141fdfde310f762e663ab4ba2e9d1b |
| Registro de claves | 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"))); // trueQué se firma
En los registros de riesgo de liquidación (payload_version: "2", desde el 18 de oct de 2026) la firma también cubre la pregunta y el slug del mercado, el sha256 de cada actualización del tablón de anuncios y el bloque de Polygon en el que se hizo cada lectura (block: número y hash). Cada eth_call se ejecuta en ese bloque, así que un nodo de archivo reproduce el registro exactamente. Desde payload_version: "3" las fechas del mercado se firman con sus nombres de Polymarket: gamma_end_date (el fin programado al crearse, a menudo desactualizado), uma_end_date y closed_time (cuándo se cerró realmente el mercado), cada una en ISO-8601 UTC o null, con las cadenas Gamma originales en gamma_dates_raw. El campo end_date de la versión 2 ya no existe; lee gamma_end_date para el mismo valor. Los registros anteriores siguen siendo válidos.
También se firma todo el cuerpo HTTP, en la cabecera x-predge-body-signature: ed25519 sobre predge-body-v1, un salto de línea y luego los bytes del cuerpo sin procesar.
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"))); // trueEspecificación: data.predge.io/canonicalization.md, secciones 5a y 5b. Python: python3 verify_record.py record.json --body-signature "<header>" (verify_record.py).
Sin código: pega un registro en data.predge.io/verify. Para los recibos de pago x402 firmados, la especificación, la biblioteca de TypeScript y los vectores de prueba están en predgeAI/x402-receipts.
Alquiler de GPU: pago por día verificado
Liquidación para alquilar tiempo de GPU a un comprador que no conoces. El comprador paga por adelantado cada día en USDC a un contrato de escrow en Arc. Una sonda revisa el día y Predge firma un veredicto. Un día entregado se paga al host; un día fallido se devuelve al comprador. Resumen para hosts y compradores: predge.io/gpu.
Contrato: AgentJobV2 en Arc mainnet
| Contrato | Dirección (Arc, chainId 5042) |
|---|---|
| AgentJobV2 (escrow de trabajos al estilo ERC-8183) | 0x5C673c6aBF3c60C3F6Ce3f1509f5d99C08F8B13F |
Un trabajo por cada día alquilado. USDC es el token nativo de gas de Arc, así que el escrow es el valor enviado con createJob. Los USDC están en el contrato, no en Predge.
- Crear. El comprador (client) llama a
createJob(provider, evaluator, specHash, expiredAt)y envía el precio del día; ese valor es el escrow. El evaluador debe ser distinto del client y del provider. En los acuerdos de GPU el evaluador es Predge. - Entregar. Antes de
expiredAtel host (provider) llama asubmit(jobId, deliverable, output).deliverablees el sha256 del archivo de evidencia del día.outputes opcional: si se envía, el contrato comprueba on-chain que su sha256 es igual adeliverable. - Decidir. Dentro de
evaluationWindowtras la entrega, Predge llama acomplete(jobId, reason, data)para pagar al provider o areject(jobId, reason, data)para devolver el dinero al client.reasones un compromiso bytes32 con el veredicto firmado. - Plazo vencido. Si el trabajo vence sin entrega, o Predge no decide dentro de la ventana de evaluación, cualquiera puede llamar a
claimRefund(jobId)y el escrow va al client. - Retirar. Un pago o una devolución se acredita al destinatario, que lo retira con
withdraw()owithdrawTo(to).
Lee un trabajo con getJob(jobId). Eventos: JobCreated, Submitted, Completed, Rejected, Refunded, Withdrawn.
SLA y specHash
Host y comprador acuerdan el SLA antes de que el comprador pague. Cada día tiene una spec: id del acuerdo, número de día, ventana de tiempo, precio, SLA, direcciones del host y del comprador y red. El sha256 de su JSON canónico es el specHash del trabajo, así que las condiciones del día quedan fijadas on-chain. El SLA del acuerdo 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
}Se lee así: el nombre de la GPU contiene A100, al menos 1 GPU, al menos 80000 MiB de memoria por GPU, activa en al menos el 95% de 24 heartbeats y al menos 200 TFLOPS en el matmul fp16.
Sonda
La sonda se ejecuta dentro de la instancia alquilada, como cualquier carga de trabajo del comprador. No necesita acceso a las máquinas ni a la red del host. A lo largo del día registra heartbeats de nvidia-smi (nombre de la GPU, cantidad, memoria) y ejecuta un benchmark fp16 corto: un matmul de 8192x8192 en cuda:0 con PyTorch y CUDA, de unos 10 segundos. El resultado es un JSON de evidencia (predge-compute-evidence-v1). Su sha256 es el deliverable que el host registra on-chain.
Veredicto
Predge compara la evidencia con la spec y firma un veredicto para el día: delivered o not_delivered. Usa el mismo sobre predge-attest-v1 que los demás veredictos de Predge (ed25519 sobre JSON canónico) y vincula el hash de la spec del trabajo (job_sha256), la transacción de prepago (payment_ref) y el hash de la evidencia (delivery.body_sha256). Verifícalo offline como cualquier veredicto: Veredictos y Verificar una firma.
Prueba: tres días en Arc mainnet
12 nov 2026. Una A100 alquilada, 0,20 USDC por día en escrow, 14 transacciones en total. El día 2 el host puso una A40 en su lugar y el día se devolvió.
| Día | Lo que vio la sonda | Resultado | Transacción del veredicto |
|---|---|---|---|
| Día 1 | NVIDIA A100-SXM4-80GB, controles superados | Pagado al host | 0xa292…37ba |
| Día 2 | NVIDIA A40 (48 GB) en lugar de la A100 contratada | Devuelto al comprador | 0x7fe8…4b16 |
| Día 3 | De nuevo NVIDIA A100-SXM4-80GB, controles superados | Pagado al host | 0x3118…ea46 |
Límites actuales
- El contrato se revisó con las herramientas automáticas de Olympix. Aún no hay una auditoría manual independiente, así que los primeros acuerdos son pequeños y tienen límite.
- Un host que controla la máquina podría intentar dar lecturas falsas a la sonda. En producción fijamos la imagen de la sonda y contrastamos las lecturas desde fuera de la instancia.
Empezar
Cuéntanos tus GPU y tu precio por día: predge.io/gpu, o escríbenos por Telegram: t.me/latcom.
Contacto
Reserva una llamada de 30 minutos: calendly.com/hello-predge/30min. O escribe a hello@predge.io, o mándanos un mensaje por Telegram: t.me/latcom.