O que é x402? O protocolo de pagamento para agentes de IA e APIs onchain

Agentes de IA precisam pagar por coisas: chamadas de API, feeds de dados, computação. Mas eles não têm cartão de crédito. Não conseguem preencher formulários de cadastro. O modelo de cobrança padrão pressupõe um humano do outro lado. Quando o cliente é um software, esse modelo não funciona.

x402 é um protocolo open-source criado para resolver isso. Ele embute pagamentos em criptomoeda diretamente no HTTP usando o código de status 402 "Payment Required", que está na especificação desde os anos 1990 mas nunca foi usado na prática. Um cliente envia uma requisição, recebe de volta os termos de pagamento, paga em cripto e tenta novamente. Sem API keys. Sem assinaturas. Sem dashboards de cobrança.

Desde o lançamento em maio de 2025, o x402 já processou mais de 100 milhões de pagamentos. Em dezembro de 2025, o x402 V2 foi lançado com suporte multi-chain, sessões baseadas em wallet e uma arquitetura extensível. Em abril de 2026, a Coinbase contribuiu o protocolo para a Linux Foundation, que lançou a x402 Foundation com mais de 20 membros fundadores, incluindo Google, Visa, Stripe, AWS, Mastercard, Circle, Microsoft e Shopify.

Como funciona o fluxo de pagamento do x402?

Todo o processo acontece em cinco etapas:

1. Um cliente solicita um recurso ao servidor.
2. Se o recurso exigir pagamento, o servidor retorna uma resposta 402 Payment Required com os termos de pagamento: valor, moeda e endereço de destino.
3. O cliente lê os termos, envia o pagamento (normalmente em USDC) e refaz a requisição com um header de pagamento.
4. O servidor verifica o pagamento, seja localmente ou através de um facilitator.
5. O servidor entrega o recurso com um 200 OK.

É só isso. Qualquer endpoint HTTP se torna um serviço pago, e qualquer cliente com uma wallet cripto se torna um cliente pagante. O pagamento acontece dentro do ciclo da requisição, não através de um sistema de cobrança separado.

O x402 já está em produção hoje. Você pode explorar transações reais em x402scan.com.

O que é HTTP 402, e por que nunca foi usado?

Se você já construiu algo para a web, conhece os códigos de status. 200 significa que a requisição funcionou. 404 significa que a página não existe. E 402? Payment required.

A maioria dos desenvolvedores nunca viu um 402 na prática. O código está na especificação do HTTP desde os anos 1990, mas os autores originais o reservaram "para uso futuro" sem definir como os pagamentos deveriam funcionar. Então os desenvolvedores construíram outros modelos de cobrança: criar uma conta, cadastrar um cartão de crédito, obter uma API key, pagar com base no uso.

O x402 preenche essa lacuna. Em vez de API keys e dashboards de cobrança, o pagamento acontece dentro da própria requisição HTTP. O servidor responde com 402, o cliente paga em cripto, o servidor entrega o recurso. HTTP e blockchain em uma única interação.

O que há de novo no x402 V2?

O x402 V2 foi lançado em dezembro de 2025 depois de seis meses de uso em produção. Quatro mudanças são as mais relevantes.

Pagamentos multi-chain e multi-rail

A V1 funcionava apenas com USDC na Base. A V2 suporta tokens em Base, Solana, Ethereum, Polygon, Starknet e Injective, com mais chains a caminho. Também funciona com trilhos de pagamento legados (ACH, SEPA, redes de cartão) através de facilitators plugáveis.

Se você está construindo um marketplace ou uma API multi-tenant, o roteamento dinâmico de "payTo" permite distribuir pagamentos para diferentes endereços ou roles por requisição.

Sessões baseadas em wallet

A V1 exigia um pagamento on-chain completo para cada requisição. Isso funciona bem para chamadas de API pontuais, mas não escala para cargas de alta frequência. A V2 introduz sessões de wallet: autentique-se uma vez e faça as requisições seguintes usando tokens de sessão. O servidor liquida o uso acumulado periodicamente, em vez de verificar cada chamada on-chain.

Se você está construindo um pipeline de inferência de LLM, um feed de dados em tempo real, ou um workflow de agente com múltiplas etapas, as sessões são o que tornam os micropagamentos viáveis. Menor latência, menor custo por requisição, menos transações on-chain.

Arquitetura extensível

A V2 separa a especificação do protocolo do SDK e dos facilitators. Novas chains, esquemas de pagamento e facilitators se conectam como pacotes independentes sem tocar no protocolo core. O SDK usa padrões CAIP para identificação de chain e asset, então adicionar uma nova rede não exige lógica personalizada.

Descoberta automática de API

Os serviços expõem metadados estruturados que os facilitators rastreiam automaticamente. Preços, rotas e endpoints permanecem sincronizados sem atualizações manuais ou catálogos hardcoded. Você publica seu serviço uma vez e todo facilitator na rede o descobre. Sem cadastros, sem integrações com parceiros, sem manutenção de catálogo.

Qual é o papel dos facilitators no x402?

Se você é um desenvolvedor de API, provavelmente não quer escrever lógica de liquidação de blockchain. Os facilitators fazem isso por você. Pense neles como processadores de pagamento para a web aberta: eles confirmam a autorização de um cliente, executam a transação on-chain e retornam a confirmação para o seu servidor.

Com um facilitator, você pode aceitar pagamentos x402 sem escrever nenhum código de blockchain. A V2 suporta múltiplos facilitators simultaneamente, e o SDK escolhe o melhor de acordo com a chain, o asset e suas preferências.

Para quem o x402 é indicado?

Se alguma dessas situações parece com o seu problema, o x402 foi feito para você:

• Você é um provedor de API e quer monetização por uso sem forçar os usuários a criar contas ou gerenciar assinaturas
• Você está construindo agentes de IA ou bots que precisam pagar por serviços sem um humano no processo
• Você trabalha com coding agents (Cursor, Claude Code, ChatGPT) que precisam acessar APIs, dados ou computação pagos por conta própria
• Você está construindo comércio agent-to-agent (A2A), pagamentos machine-to-machine, ou marketplaces de serviços autônomos

O x402 se encaixa em qualquer lugar onde um software precise pagar por recursos sozinho: APIs de inferência de IA, micropagamentos para acesso a dados, conteúdo com acesso restrito, cobrança de computação. Para compras fora do ecossistema cripto, projetos como o AgentCard dão aos agentes seus próprios cartões de crédito, com limites de gasto configuráveis e rastreamento em tempo real.

O que você pode construir com o x402?

• Endpoints de API pay-per-call para inferência de IA, feeds de dados ou computação
• Sistemas de micropagamento para conteúdo digital: imagens, vídeos, artigos de pesquisa, datasets
• Comércio autônomo agent-to-agent, onde agentes de IA compram dados, computação ou acesso a APIs uns dos outros
• Cobrança baseada em uso para storage, banda ou qualquer recurso medido
• APIs freemium com camadas premium com acesso restrito por cripto
• Pipelines de dados multi-chain que pagam por requisição a taxas sub-centavo usando sessões da V2

Isso não é hipotético. Agentes de IA já estão consultando dados de blockchain para gerenciar posições de DeFi, monitorando preços de tokens e executando trades sem supervisão humana, e rodando pipelines de indexação multi-chain de ponta a ponta. Alguns estão comprando computação e implantando smart contracts através de serviços habilitados para x402.

Para uma comparação detalhada entre x402 e o Machine Payments Protocol (MPP), veja x402 vs MPP: comparando protocolos de pagamento para agentes.

Como a Alchemy suporta o x402?

Construímos um agentic gateway que permite que agentes de IA acessem a infraestrutura de blockchain através do x402 sem nenhuma configuração humana.

É assim que funciona na prática: um agente chega com sua wallet onchain. Sem API key, sem conta em dashboard. Ele chama nossas APIs diretamente. Se o pagamento for exigido, retornamos um 402 com os termos de pagamento. O agente paga em USDC na Base, e processamos a requisição. As requisições seguintes utilizam o saldo já financiado até ele se esgotar, e então o gateway emite um novo 402 e o agente recarrega por conta própria.

APIs disponíveis

Os agentes têm acesso às mesmas APIs em produção usadas por equipes da Coinbase, Visa e Stripe, em mais de 100 blockchains:

• RPC core em mais de 100 blockchains
• NFT APIs para consultas de posse e metadados
• Portfolio APIs para visões multi-chain de wallets
• Prices APIs para preços de tokens spot e históricos

Os agentes podem começar com apenas $1 em créditos de computação, equivalente a $1 de CUs no nosso tier pay-as-you-go. Sem contratos. Sem filas de aprovação.

Alchemy Skills

Também publicamos Alchemy Skills: documentação estruturada e legível por máquina, projetada para agentes em vez de humanos. As Skills informam a um agente o que oferecemos, quais endpoints estão disponíveis e como chamá-los, para que os agentes possam descobrir e integrar nossos produtos sem ler documentação voltada para humanos.

Alchemy CLI

A Alchemy CLI foi feita para agentes e workflows de terminal: autentique-se, consulte dados com --json --no-interactive, e gere um manifesto de comandos completo para coding agents via alchemy --json --no-interactive agent-prompt.

Adicione Alchemy Skills ou conecte-se ao Alchemy MCP server.

Como começar a construir com o x402

Pronto para experimentar? Quatro caminhos dependendo de onde você quer começar:

• Leia a especificação completa e explore o SDK de referência em x402.org
• Clone o repositório coinbase/x402 no GitHub e rode os exemplos
• Construa agentes que pagam por dados de blockchain através da nossa plataforma de agentes, que suporta x402 nativamente: sem necessidade de API key, apenas uma wallet e uma chamada HTTP
• Instale a CLI e consulte endpoints pelo terminal com --json --no-interactive

Para desenvolvimento em testnet, obtenha Base Sepolia ETH no Alchemy Faucet e tokens de teste USDC no Circle Faucet.

Perguntas frequentes

O que é o protocolo x402?

O x402 é um protocolo open-source que usa o código de status HTTP 402 "Payment Required" para embutir pagamentos em criptomoeda diretamente em requisições web. Ele permite que agentes de IA, aplicativos e bots paguem por chamadas de API e serviços digitais em tempo real, sem API keys, assinaturas ou configuração manual de cobrança.

Como funciona o fluxo de pagamento do x402?

Um cliente envia uma requisição HTTP. O servidor responde com um status 402 e os termos de pagamento. O cliente paga (normalmente em USDC) e tenta novamente com um header de pagamento. O servidor verifica o pagamento e retorna o recurso com um 200 OK.

Quais blockchains o x402 suporta?

O x402 V2 suporta Base, Solana, Ethereum, Polygon, Starknet e Injective, com planos de expandir para todas as L1s e L2s que suportam transações em stablecoin. Ele também suporta trilhos de pagamento legados, como ACH, SEPA e redes de cartão, através de facilitators plugáveis.

O que é a x402 Foundation?

A x402 Foundation foi lançada em abril de 2026 sob a Linux Foundation como um órgão neutro em relação a fornecedores, responsável por governar o protocolo x402. Ela tem mais de 20 membros fundadores, incluindo Google, Visa, Stripe, AWS, Mastercard, Circle, Microsoft, Shopify e American Express.

Qual é a diferença entre x402 e MPP?

O x402 embute pagamentos em stablecoin diretamente no HTTP. O MPP (Machine Payments Protocol) estende o mesmo padrão 402 com trilhos agnósticos a método de pagamento, cobrança baseada em sessão, suporte a transporte MCP, e primitivas de protocolo padronizadas como idempotência e proteção contra replay. O MPP é compatível com versões anteriores do x402. Leia a comparação completa.

Preciso escrever código de blockchain para usar o x402?

Não. Os facilitators cuidam da verificação de pagamento e da liquidação on-chain, então os desenvolvedores de API podem aceitar pagamentos x402 sem escrever lógica de blockchain. A V2 suporta múltiplos facilitators que se conectam como pacotes independentes.

Agentes de IA podem usar a Alchemy com x402?

Sim. A Alchemy roda um agentic gateway que suporta x402 nativamente. Um agente se autentica com sua wallet onchain, paga em USDC na Base, e acessa o RPC core (mais de 100 chains), e as APIs de NFT, Portfolio e Prices. Sem necessidade de API key, dashboard ou configuração humana. Comece em alchemy.com/agents.

Qual criptomoeda o x402 usa para pagamentos?

O x402 usa principalmente USDC, uma stablecoin denominada em dólar, para pagamentos. A V2 expandiu o suporte para tokens em múltiplas chains e redes. O protocolo também suporta trilhos de pagamento legados (ACH, SEPA, cartões) através de facilitators plugáveis, embora as stablecoins permaneçam o principal método de pagamento.

Como começo a construir com o x402?

Comece com a especificação e o SDK de referência do x402.org, o repositório coinbase/x402 no GitHub, ou a plataforma de agentes da Alchemy para construir agentes que acessam dados de blockchain usando x402. A Alchemy CLI oferece um caminho rápido da configuração até a consulta de endpoints.