x402 endpoint checker

npx add-mcp 'https://x402-seller-kit.soloearn.workers.dev/mcp'

Verificador de endpoint x402

Cole uma URL paga. O verificador a solicita da mesma forma que um cliente x402 ou um rastreador de diretórios faria, e então avalia o 402: status, cabeçalho PAYMENT-REQUIRED, rede, ativo USDC, unidades de valor, checksum payTo, domínio EIP-712, CORS, HEAD e metadados de descoberta.

O que ele verifica

Verificação	Como é o "bom"
Status	A solicitação não paga retorna 402, não 200, 401, 403 ou 405. Redirecionamentos são seguidos (até 3) e relatados.
Cabeçalho PAYMENT-REQUIRED	Presente, base64 padrão e decodifica para JSON (transporte HTTP x402 v2).
Versão e corpo	x402Version é 1 ou 2; se o corpo espelha os termos para humanos e rastreadores.
accepts[]	Pelo menos uma opção de pagamento, com um esquema conhecido.
Rede	Um ID CAIP-2 que o verificador reconhece, com testnets sinalizadas.
Ativo	O contrato USDC nativo para aquela rede, e não o USDC de outra cadeia.
Unidades de valor	Uma string inteira nas menores unidades: "29000000" é 29 USDC; "29" seria 0,000029.
payTo	Um endereço válido que passa no checksum EIP-55 quando em maiúsculas/minúsculas mistas, e não é o endereço zero.
Domínio EIP-712	extra.name e extra.version correspondem ao name() e version() on-chain do contrato USDC (redes verificadas).
maxTimeoutSeconds	Presente e em um intervalo razoável.
resource, description, mimeType	resource.url corresponde à URL pública; uma descrição útil para diretórios.
Descoberta	Metadados Bazaar (extensions.bazaar v2) ou outputSchema (v1).
CORS	Access-Control-Allow-Origin, e PAYMENT-REQUIRED listado em Access-Control-Expose-Headers para que clientes de navegador possam lê-lo.
Paridade HEAD	HEAD também retorna 402, para rastreadores e verificadores de links que sondam com HEAD.

O verificador nunca paga. Para testar o caminho pago, use uma biblioteca de cliente x402 com uma carteira de teste, idealmente primeiro na Base Sepolia. Versões passo a passo com curl dessas verificações estão em Como testar um endpoint x402 com curl.

Use a partir de um script ou um agente

API JSON. Mesmas verificações, mesmos limites:

curl -s 'https://x402-seller-kit.soloearn.workers.dev/api/x402-check?url=https://x402-seller-kit.soloearn.workers.dev/download' | jq '{verdict, summary}'

Servidor MCP. HTTP streamable em https://x402-seller-kit.soloearn.workers.dev/mcp, uma ferramenta somente leitura: check_x402_endpoint(url, method?). Adicione-o a uma configuração de cliente MCP:

{
  "mcpServers": {
    "x402-checker": { "type": "http", "url": "https://x402-seller-kit.soloearn.workers.dev/mcp" }
  }
}

FAQ

O verificador x402 é gratuito?

Sim. Sem cadastro, sem carteira e sem pagamento. É limitado a 20 verificações por minuto por IP para que continue gratuito para todos.

Ele paga, assina ou armazena algo?

Não. Ele envia uma solicitação não paga (GET ou POST) e, para GET, uma solicitação HEAD, e então lê a resposta. Ele nunca cria uma assinatura de pagamento. As URLs que você verifica não são armazenadas; o site apenas mantém contagens diárias de visualizações de página.

Ele suporta x402 v1 e v2?

Sim. Os termos v2 são lidos do cabeçalho PAYMENT-REQUIRED base64 (e do corpo, se espelhado). Os termos v1 são lidos do corpo JSON, e nomes de rede v1 como base ou base-sepolia são mapeados para IDs CAIP-2.

O que a verificação do domínio EIP-712 faz?

Para pagamentos "exatos" USDC em cadeias EVM, os clientes assinam uma autorização EIP-3009 usando o nome e a versão do token que você envia em extra. O verificador os compara com os valores que o contrato USDC retorna on-chain (name() e version(), lidos em 8 de outubro de 2026 para Base, Base Sepolia, Ethereum, Avalanche, Fuji, Optimism e Arbitrum). Na mainnet Base, isso é "USD Coin" e "2"; na Base Sepolia, é "USDC" e "2". Uma incompatibilidade faz as assinaturas falharem no facilitador.

Por que diz que meu 402 não tem termos x402?

Um status 402 sozinho não é x402. Os clientes precisam de um cabeçalho PAYMENT-REQUIRED (v2) ou um corpo JSON x402 (v1) com uma lista accepts. Alguns paywalls retornam 402 com HTML ou seu próprio formato JSON.

Posso chamá-lo de um script ou um agente de IA?

Sim. GET /api/x402-check?url=… retorna o relatório completo como JSON, e /mcp é um endpoint Model Context Protocol (HTTP streamable) com uma ferramenta somente leitura, check_x402_endpoint.

Quais redes e tokens ele conhece?

Redes: Base, Base Sepolia, Ethereum, Polygon (e Amoy), Avalanche (e Fuji), Optimism, Arbitrum, Sei, IoTeX, Solana e Solana Devnet. Endereços USDC nativos: Base, Base Sepolia, Ethereum, Polygon, Avalanche, Fuji, Optimism, Arbitrum, Solana e Solana Devnet. Outros tokens são relatados como desconhecidos, não como erros.

Construindo o próprio endpoint pago? O x402 Seller Kit é um modelo testado de Cloudflare Worker que passa em todas as verificações acima, além de um checkout com código de pedido para compradores que pagam por uma exchange. Leia o guia gratuito ou o README primeiro.

Obtenha o kit · $29