ORACLE-402 · Tienda

Paso 1 — mira un challenge (gratis, sin wallet): verás el precio y el wire x402 v2 en la cabecera PAYMENT-REQUIRED.

copiarcurl -i -X POST https://api.oracle402.com/v1/btc-context-signal \
  -H 'content-type: application/json' -d '{}'

Paso 2 — verifica un proof (gratis): el kit de verificación de una señal comprada.

copiarcurl -s https://api.oracle402.com/v1/signal/<signal_id>/proof

Para pagar hace falta firmar (EIP-712) — curl no firma. Hazlo aquí en la web (botón Comprar), con Node.js, o con tu agente (pestañas siguientes).

Paso 1 — instala el cliente oficial (Node ≥ 20):

copiarnpm i @x402/fetch @x402/core @x402/evm viem

Paso 2 — compra una señal (usa una wallet DEDICADA de bajo saldo; exporta su clave como WALLET_KEY):

copiarimport { wrapFetchWithPayment, decodePaymentResponseHeader } from '@x402/fetch';
import { x402Client } from '@x402/core/client';
import { registerExactEvmScheme } from '@x402/evm/exact/client';
import { privateKeyToAccount } from 'viem/accounts';

const signer = privateKeyToAccount(process.env.WALLET_KEY);
const client = new x402Client();
registerExactEvmScheme(client, { signer, networks: ['eip155:8453'] });
const fetchPay = wrapFetchWithPayment(fetch, client);

const res = await fetchPay('https://api.oracle402.com/v1/btc-context-signal', {
  method: 'POST', headers: { 'content-type': 'application/json' }, body: '{}'
});
const señal = await res.json();
const recibo = decodePaymentResponseHeader(res.headers.get('payment-response'));
console.log(señal.statement, '· tx:', recibo.transaction);

Paso 3 — verifica: pide /v1/signal/{id}/proof (gratis) y recomputa el sha256 del canónico. En la sección «Verificar» de esta página lo tienes hecho.

La transición humano → agente: has comprado a mano y te fías del formato. Ahora deja que tu agente IA consulte el oráculo él solo cuando su tarea lo pida — tú solo defines el presupuesto (el saldo de su wallet).

1. Crea una wallet DEDICADA para el agente con saldo pequeño (p. ej. $5 USDC en Base). Nunca le des tu wallet principal: el saldo de esa wallet ES su presupuesto de gasto.
2. Añade el server MCP a tu cliente (Claude Desktop → Settings → Developer → Edit config):

   copiar{
     "mcpServers": {
       "x402-services": {
         "command": "npx",
         "args": ["-y", "@fsantag/x402-mcp"],
         "env": { "X402_PRIVATE_KEY": "0x…clave de la wallet DEDICADA…" }
       }
     }
   }

3. Reinicia el cliente y pídeselo en lenguaje natural: «consulta la señal de contexto BTC del oráculo y resúmemela». El agente descubre la tool, paga los $0.05 y recibe la señal firmada — con recibo on-chain que puedes auditar.

Los agentes descubren los servicios de dos formas:

copiar# 1) Descriptor machine-readable por servicio (nuestro dominio)
curl -s https://api.oracle402.com/.well-known/x402/btc-context-signal

# 2) El Bazaar x402 (catálogo de CDP donde estamos indexados)
#    los clientes x402 lo consultan para encontrar recursos por tags/precio

Cada descriptor declara input/output schema, precio y red — suficiente para que un agente compre sin intervención humana. El disclaimer viaja en cada señal: contexto/régimen, no consejo de inversión.