Quicknode

17 de fevereiro de 2026 — 11 min de leitura

O Quicknode já suporta o acesso «pay-per-request» x402, proporcionando aos programadores e aos agentes de IA acesso imediato, autenticado através da carteira, a pontos de extremidade da blockchain em mais de 130 redes. Isto inclui interfaces RPC, WebSocket, REST e gRPC. Pague com USDC na Base, Solana ou Polygon e comece a efetuar chamadas em poucos minutos.

O x402 é um método de acesso adicional que complementa os planos existentes da Quicknode. As equipas que executam cargas de trabalho de produção beneficiam dos planos padrão da Quicknode, com SLAs, apoio dedicado e faturação baseada em créditos. O x402 acrescenta uma nova opção para casos de utilização em que a prioridade é um acesso leve e sem autorização prévia.

Este artigo explica o que é o x402, como funciona com o Quicknode, o que se pode criar com ele e como começar.

O que é o x402?

O x402 é um protocolo de pagamento aberto desenvolvido pela Coinbase que introduz pagamentos nativos no HTTP. Este protocolo retoma o código de estado HTTP 402 «Pagamento Necessário», há muito reservado, e transforma-o numa camada de pagamento funcional para a Internet.

O conceito é simples: quando um cliente envia um pedido a um ponto final compatível com x402 sem efetuar o pagamento, o servidor responde com um código de estado 402 e inclui instruções de pagamento (preço, tokens aceites, rede e endereço da carteira). O cliente assina uma autorização de pagamento em USDC, anexa-a ao cabeçalho do pedido e volta a tentar. O servidor verifica o pagamento através de um facilitador, liquida-o na cadeia de blocos e devolve os dados solicitados.

Isto é especialmente significativo para os agentes de IA. Os sistemas de pagamento tradicionais exigem registos, gestão de credenciais e ciclos de faturação efetuados por pessoas. O x402 elimina tudo isso. Um agente com uma carteira pode, de forma autónoma, descobrir, pagar e utilizar serviços de API sem qualquer intervenção humana.

Por que é que a Quicknode suporta o x402

A Quicknode fornece infraestrutura de blockchain a programadores e empresas em mais de 80 cadeias e mais de 130 redes. O acesso a essa infraestrutura implica, normalmente, a criação de uma conta e a gestão de chaves API, o que funciona bem para equipas que desenvolvem aplicações de produção.

O x402 adiciona uma via de acesso complementar para uma categoria de utilizadores em crescimento: agentes de IA, criadores de protótipos rápidos e programadores que pretendem testar algo antes de se comprometerem com um plano. Com o x402 ativado nos terminais Quicknode, qualquer pessoa (ou entidade) com uma carteira pode:

• Aceda a pontos de extremidade RPC, WebSocket, REST e gRPC em mais de 130 redes de blockchain

• Pagamento por pedido com USDC, utilizando um modelo de crédito por débito. Recarregue o seu saldo uma única vez e cada pedido será automaticamente debitado dos seus créditos, pelo que não há atrasos no pagamento por cada chamada.

• Autenticar utilizando a autenticação baseada em carteira (Sign-In with X / SIWx), compatível tanto com carteiras EVM como com carteiras Solana

• Comece já com até 10 000 pedidos gratuitos utilizando o devnet USDC

A rede de pagamentos está dissociada dos pontos finais que consulta. Isso significa que pode pagar com USDC na Base e efetuar chamadas à Solana, ou pagar com USDC da Solana e consultar a Ethereum, ou ainda pagar com USDC da Polygon. A cadeia na qual efetua o pagamento não precisa de corresponder à cadeia que está a consultar.

x402 vs. Planos Quicknode Padrão

O x402 é complementar. Não substitui os planos padrão da Quicknode. As equipas com cargas de trabalho de produção devem continuar a utilizar os planos SLA padrão, o apoio dedicado e os limites de taxa mais elevados.

Redes de pagamento suportadas

A implementação do x402 da Quicknode suporta atualmente pagamentos em USDC nas seguintes plataformas:

• Base (rede principal e rede de testes Sepolia)

• Solana (rede principal e rede de desenvolvimento)

• Polygon (rede principal e rede de testes Amoy)

Estão a ser adicionadas ativamente novas redes de pagamento. O protocolo x402 foi concebido para ser independente da cadeia, pelo que é fácil alargar o suporte à medida que novos facilitadores entram em funcionamento.

Para efeitos de teste, os programadores podem utilizar a rede de desenvolvimento USDC na Base Sepolia, na rede de desenvolvimento da Solana ou na Polygon Amoy para obterem até 10 000 pedidos gratuitos para qualquer um dos pontos de extremidade de produção da Quicknode.

Como funciona: o fluxo técnico

Eis o que acontece nos bastidores quando um agente ou programador envia um pedido compatível com x402 ao Quicknode:

1. Pedido inicial: O cliente envia um pedido HTTP para o ponto de extremidade Quicknode x402 sem cabeçalhos de pagamento.

2. Resposta 402: O servidor responde com um código HTTP 402 e um cabeçalho PAYMENT-REQUIRED que contém os detalhes do pagamento: o preço por pedido, os tokens aceites (USDC), as redes suportadas (Base, Solana, Polygon) e o endereço da carteira para onde efetuar o pagamento.

3. Autenticação por carteira: O cliente autentica-se utilizando o SIWx (Sign-In with X). A implementação da Quicknode utiliza o SIWx para emitir tokens JWT, otimizando o desempenho ao evitar a sobrecarga da verificação da assinatura em cada pedido (o que acrescentaria 10-20 ms por chamada).

4. Autorização de pagamento: O cliente assina uma autorização de transferência de USDC utilizando o EIP-3009 (para EVM) ou um método de assinatura equivalente da Solana. Trata-se de uma operação sem custos de gás para o cliente.

5. Reintentar com o pagamento: O cliente reintenta o pedido original com o pagamento assinado no cabeçalho X-PAYMENT.

6. Verificação e liquidação: O facilitador verifica a autorização assinada, liquida a transferência de USDC na cadeia de blocos e confirma o pagamento.

7. Resposta: O Quicknode devolve os dados solicitados.

As bibliotecas de cliente x402 tratam automaticamente dos passos 2 a 6. Do ponto de vista do programador, o código parece ser um pedido HTTP normal.

O que pode construir

Agentes de IA com acesso autónomo à blockchain

O caso de utilização mais imediato consiste em permitir que os agentes de IA interajam com dados da blockchain sem chaves de API pré-configuradas. Um agente pode:

• Consultar os preços dos tokens e os saldos das carteiras em várias cadeias

• Monitorizar a atividade da carteira e o histórico de transações

• Executar leituras na blockchain para protocolos DeFi

• Aceder a dados históricos por quarteirão para análise

Tudo isto sem que seja necessário que uma pessoa crie primeiro uma conta.

Servidor MCP para gestão de infraestruturas assistida por IA

Servidor MCP oficial da Quicknode (@quicknode/mcp) integra a gestão da infraestrutura de blockchain diretamente em assistentes de IA como o Claude e o Cursor. Com o servidor MCP, um assistente de IA pode instalar e configurar pontos de acesso Quicknode em várias redes, monitorizar a utilização e a faturação e gerir a infraestrutura através de linguagem natural. Isto combina bem com o x402: utilize o servidor MCP para provisionar e gerir a sua infraestrutura Quicknode e utilize o x402 para um acesso leve aos pontos de acesso, autenticado pela carteira.

Instalar através do npx:

npx -y @quicknode/mcp

Consulte o pacote no npm: npmjs.com/package/@quicknode/mcp

Competências em blockchain para agentes de programação de IA

A Quicknode também disponibiliza o Blockchain Skills, um pacote de referência leve que fornece aos agentes de programação de IA conhecimentos precisos e atualizados sobre toda a gama de produtos da Quicknode. Basta um comando para o adicionar ao Claude Code, ao Cursor, ao Codex, ao Windsurf ou a qualquer agente compatível com skills:

npx skills add quicknode-labs/blockchain-skills

Com cerca de 240 tokens, fornece ao seu agente os endpoints adequados, os parâmetros corretos e as melhores práticas atuais, sem sobrecarregar a janela de contexto. Totalmente de código aberto em github.com/quicknode-labs/blockchain-skills. Consulte-o no registo de competências em skills.sh/quicknode-labs/blockchain-skills.

Desenvolvimento e prototipagem com pagamento por pedido

Os programadores que pretendam testar uma ideia em várias cadeias podem utilizar o x402 para aceder a qualquer uma das redes suportadas pela Quicknode sem se comprometerem com um plano. Crie um protótipo, pague alguns cêntimos em USDC pelas chamadas RPC que efetivamente realizar e siga em frente.

A API de administração da Quicknode oferece controlo programático total sobre a configuração da sua conta e infraestrutura, permitindo que os agentes e programadores criem pontos de acesso, gerem a segurança e monitorizem a utilização através de chamadas REST simples.

HyperCore CLI com x402

A ferramenta HyperCore CLI de código aberto da Quicknode também suporta o acesso x402 com pagamento por pedido. Os programadores podem transmitir e preencher retroativamente conjuntos de dados do Hyperliquid (transações, ordens, execuções, TWAP, atualizações do livro de ordens, eventos, blocos) diretamente a partir do terminal, pagando por pedido com uma carteira, em vez de precisarem de uma conta Quicknode.

Instale-o globalmente:

npm install -g @quicknode/hypercore-cli

A CLI suporta transmissão em tempo real através de WebSocket e gRPC, reconexão automática com recuperação de intervalos, preenchimento de dados históricos e saída em JSON, CSV ou SQLite.

Monetização de conteúdos e APIs

Para além de utilizarem serviços compatíveis com o x402, os programadores também podem criar as suas próprias APIs baseadas no x402, utilizando as ferramentas de código aberto da Quicknode:

• x402-rails: Uma gem Ruby para adicionar paywalls x402 a aplicações Rails

• x402-payments: Uma gem Ruby para gerar cabeçalhos de pagamento assinados

• qn-x402-exemplos: Exemplos de implementações para os fluxos de pagamento tanto da EVM como da Solana

Os pacotes npm @quicknode/x402 e @quicknode/x402-solana

O @quicknode/x402 O pacote npm é a forma recomendada de interagir com o gateway x402 da Quicknode. Este pacote integra todo o fluxo de autenticação e pagamento numa única instalação: autenticação da carteira SIWX, gestão de sessões JWT e processamento de pagamentos x402.

Anteriormente, a integração com o x402 no Quicknode exigia a gestão manual da assinatura SIWX, do ciclo de vida do token JWT e da construção do cabeçalho de pagamento. Este pacote abstrai tudo isso. Os agentes e os programadores podem instalar o pacote, ligar uma carteira e começar a efetuar pedidos autenticados e pagos em poucos minutos.

npm i @quicknode/x402

O pacote é compatível com carteiras EVM e Solana e funciona em todas as redes de pagamento suportadas (Base, Solana, Polygon).

@quicknode/x402 no npm: npmjs.com/package/@quicknode/x402

Fonte: github.com/quicknode-labs/quicknode-x402

Para os utilizadores da Solana: o @quicknode/x402-solana npm envolve @quicknode-x402 e acrescenta a possibilidade de utilizar Kit Solana com os serviços RPC da Quicknode, de forma imediata.

@quicknode/x402-solana no npm: npmjs.com/package/@quicknode/x402-solana

Fonte: github.com/quicknode-labs/x402-solana

A API de administração

A API de administração da Quicknode proporciona aos programadores e agentes controlo programático total sobre as operações relacionadas com contas e infraestruturas, desde a criação de pontos de extremidade e a configuração da segurança até à monitorização da utilização e à gestão de equipas, tudo através de chamadas REST padrão. Em combinação com o x402 e o servidor MCP, isto significa que um agente pode não só consultar dados da blockchain, mas também provisionar e gerir a infraestrutura da qual esta depende.

Introdução

Pré-requisitos

• Uma carteira de criptomoedas (qualquer carteira compatível com EVM ou carteira Solana)

• USDC na Base, Polygon ou Solana (ou USDC na rede de desenvolvimento para testes gratuitos)

• Node.js 18+ e o pacote @quicknode/x402 (npm i @quicknode/x402)

Introdução rápida ao Devnet USDC (gratuito)

Para efeitos de teste, pode utilizar o USDC da rede de desenvolvimento para efetuar até 10 000 pedidos gratuitos:

1. Obtenha Base Sepolia USDC na fonte de USDC da Circle

2. Ou obtém USDC da rede de desenvolvimento da Solana através da «faucet» da Solana

3. Ou obtenha Polygon Amoy USDC através da fonte de USDC da Circle

4. Siga o guia de introdução

Configuração da produção

Para utilização em ambiente de produção com USDC real:

1. Carregue a sua carteira com USDC na Base, na Solana ou na Polygon

2. Instale o pacote @quicknode/x402 (npm i @quicknode/x402)

3. Envie os seus pedidos para o ponto de extremidade Quicknode x402

O pagamento por pedido é mínimo, o que torna esta opção viável tanto para cargas de trabalho de agentes com grande volume como para testes de desenvolvimento.

Código Aberto e Ecossistema

A Quicknode tem investido fortemente no ecossistema x402, indo além da simples facilitação de pagamentos nos seus próprios terminais:

• x402 Explorer: Uma aplicação de exemplo para testar os fluxos de pagamento x402

• Demonstração do sistema de acesso pago a vídeos x402: Um exemplo que mostra como aplicar um paywall a conteúdos de vídeo com o x402

• Integração do x402 com o Rails: Um guia para adicionar o x402 às APIs do Ruby on Rails

• Guia do Paywall x402: Um guia completo sobre a implementação do x402

• llms.txt: Documentação legível por máquina sobre a descoberta de LLM e agentes. O protocolo em si é de código aberto e é mantido pela Coinbase em github.com/coinbase/x402

• Pacote @quicknode/x402:

Perguntas frequentes

O que é o x402 no Quicknode?

O x402 no Quicknode é uma funcionalidade em fase alfa que permite o acesso, autenticado pela carteira e com pagamento por pedido, aos pontos de extremidade do Quicknode (RPC, WebSocket, REST e gRPC) utilizando USDC. Recorre à norma HTTP 402 «Pagamento Necessário» e baseia-se no protocolo aberto x402 da Coinbase.

O x402 substitui as contas ou os planos do Quicknode?

O plano n.º x402 é complementar. Oferece uma via de acesso complementar aos planos padrão da Quicknode. As equipas que executam cargas de trabalho de produção devem continuar a utilizar os planos padrão para os SLAs, o apoio dedicado e limites de taxa mais elevados. O plano x402 foi concebido para agentes de IA, prototipagem rápida e acesso sem autorização prévia.

O x402 requer uma conta Quicknode?

O acesso ao n.º x402 é autenticado através de uma carteira. É necessária uma carteira de criptomoedas e USDC, e não uma conta Quicknode nem uma chave API.

Que redes de pagamento são suportadas?

Os pagamentos em USDC são atualmente suportados na Base (rede principal e rede de testes Sepolia), na Solana (rede principal e rede de desenvolvimento) e na Polygon (rede principal e rede de testes Amoy). Estão a ser adicionadas redes de pagamento adicionais. A rede de pagamento não precisa de corresponder à cadeia que está a consultar.

Os agentes de IA podem utilizar o x402 de forma autónoma?

Sim. O x402 foi concebido para o acesso autónomo de agentes. Um agente com uma carteira com saldo pode descobrir, autenticar, pagar e utilizar os pontos de acesso da Quicknode sem qualquer intervenção humana.

O x402 já está pronto para ser utilizado em produção?

O x402 no Quicknode encontra-se atualmente em fase alfa. Está funcional e disponível para utilização, mas não oferece as mesmas garantias de SLA que os planos padrão do Quicknode. Para cargas de trabalho de produção que exijam garantias de tempo de atividade e apoio dedicado, utilize um plano padrão do Quicknode.

Quanto custa cada pedido?

O preço por pedido é mínimo e está expresso em USDC. Os programadores podem testar gratuitamente utilizando o USDC da rede de desenvolvimento (devnet), que oferece até 10 000 pedidos gratuitos para os pontos finais RPC de produção.

Que carteiras são compatíveis para autenticação?

Qualquer carteira compatível com EVM ou carteira Solana. A autenticação utiliza o SIWx (Sign-In with X), que suporta a assinatura tanto com carteiras EVM como com carteiras Solana.

Resumo técnico

Recursos

• Guia: Aceder aos pontos de extremidade do Quicknode com pagamentos x402

• Exemplos: github.com/quicknode-labs/qn-guide-examples

• Vídeo explicativo: Como começar a utilizar o x402 no Quicknode

• Explicação do Protocolo x402: O que é o Protocolo de Pagamento x402?

• Aplicações de exemplo: Biblioteca de aplicações de exemplo do Quicknode

• HyperCore CLI: npmjs.com/package/@quicknode/hypercore-cli

• llms.txt: x402.quicknode.com/llms.txt

• Ecossistema x402:

A Quicknode fornece infraestrutura de blockchain a programadores e empresas em mais de 80 cadeias e mais de 130 redes. Comece com um plano padrão ou aceda instantaneamente aos endpoints com o acesso x402 de pagamento por pedido.