ES
x402 · USDC en Base

Herramientas pensadas para agentes.

APIs JSON de pago por llamada y Actors públicos de Apify para datos de empresas, identificadores, registros inmobiliarios oficiales franceses y utilidades web cotidianas. Sin cuenta. Sin clave API.

Inicio rápido

Pruébelo en 1 llamada

Llame a cualquier ruta de pago sin cabecera de pago. La pasarela devuelve HTTP 402 y un desafío JSON x402 v2. Luego reintente con un cliente x402 que firme y adjunte el pago.

1. Ver el desafío 402

curl -sS -D - "https://x402-gateway.forge-x402.workers.dev/api/iban?iban=FR7630006000011234567890189"

Espere HTTP/2 402 y un cuerpo con accepts[].amount (USDC atómico, 6 decimales), payTo y network: "eip155:8453" (Base).

2. Pagar y reintentar con un cliente x402

import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.EVM_PRIVATE_KEY);
const fetchWithPayment = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});

const res = await fetchWithPayment(
  "https://x402-gateway.forge-x402.workers.dev/api/iban?iban=FR7630006000011234567890189"
);
console.log(await res.json());

Use @x402/fetch con @x402/evm (x402 v2). Guarde la clave privada en una variable de entorno. El mismo patrón funciona en Python (véase el repositorio de ejemplos) o reintentando el curl con una cabecera PAYMENT-SIGNATURE.

Para agentes

Empiece por los archivos legibles por máquina.

Lea llms.txt o catalog.json, obtenga /.well-known/x402 para los precios en unidades atómicas, o adjunte openapi.json. El servidor MCP habla Streamable HTTP en https://x402-gateway.forge-x402.workers.dev/mcp.

Para desarrolladores

Una llamada sin pagar y luego un reintento firmado.

Cada ruta acepta GET o POST. Una primera petición sin cabecera de pago devuelve HTTP 402 y un desafío accepts[]. Reintente con PAYMENT-SIGNATURE o X-PAYMENT. Consulte las notas de pago. notas de pago.

Catálogo

Endpoints x402

Una muestra de las 14 rutas de pago. Todos los precios son por llamada, en USDC en Base.

Catálogo completo

Apify

Actors públicos

Versiones orientadas a lotes de las mismas fuentes oficiales, más una sincronización con Google Sheets. Cada ficha enlaza a su página pública de la tienda y enumera los eventos tarifados.

Fidelidad

Créditos por dirección del pagador Previsto

Regla prevista: cada 10 llamadas de pago liquidadas desde la misma dirección del pagador dan 1 crédito, canjeable por una llamada gratuita. Existe un endpoint de lectura en GET /loyalty/{address}, pero la pasarela x402 corre en otra cuenta y no alimenta este libro, así que los saldos siguen en cero. No es un programa de créditos en producción.

Leer la nota

Solicitudes de herramientas

Pedir una herramienta nueva

Envíe una propuesta breve. Una pequeña prueba de trabajo SHA-256, resuelta en el navegador, frena el correo basura. No es una tarifa y no garantiza que se construya la herramienta.

Abrir el formulario