Idioma
Entrar Cadastre-se

Compra agêntica: a superfície x402 e MCP da Proxy4G

A Proxy4G expõe uma superfície de compra legível por máquina para que agentes de IA autônomos possam abastecer um saldo e comprar proxies móveis sem um humano no processo. O fluxo usa o protocolo de pagamento x402 (esquema exact, USDC na Base) através de um único endpoint, /agent-api.php, retornando uma resposta real HTTP 402 Payment Required que seu agente liquida com uma autorização USDC EIP-3009.

Compra agêntica: a superfície x402 e MCP da Proxy4G

A superfície agêntica é um espelho programático do nosso checkout humano: um agente lê um arquivo de descoberta, cria uma conta para obter um token Bearer, solicita uma recarga de saldo, recebe um HTTP 402 com um bloco accepts, assina um pagamento USDC na Base, reenvia com um cabeçalho X-PAYMENT e, em seguida, gasta o saldo abastecido em qualquer um dos nossos 18 países e 43 operadoras. Sem cartão, sem PayPal, sem etapa de aprovação humana.

Para que serve a superfície x402 + MCP?

O x402 ressuscita o adormecido código de status HTTP 402 Payment Required como um verdadeiro handshake de pagamento: uma requisição não autenticada ou sem fundos retorna 402 mais um bloco estruturado accepts descrevendo exatamente como pagar, o agente paga e reenvia a mesma requisição com a comprovação. A Proxy4G implementa isso para a única ação que precisa de dinheiro — abastecer um saldo de carteira — para que um agente autônomo possa comprar proxies móveis 4G de ponta a ponta.

Este é o mesmo saldo descrito no nosso checkout com criptomoeda: humanos recarregam com Bitcoin, Ethereum, Solana ou USDT, enquanto agentes recarregam com USDC na Base via x402. Uma vez abastecido, o saldo compra planos dedicados ou SOCKS5 através da mesma lógica de pedido. Se você está construindo infraestrutura autônoma, consulte o caso de uso de agentes de IA e automação para padrões de runtime.

A superfície agêntica em resumo

402Status HTTP para pagamento
USDCAtivo de liquidação
BaseRede de liquidação
exactEsquema x402

Como um agente descobre a API?

Antes de transacionar, um agente deve buscar os descritores legíveis por máquina para poder planejar o fluxo sem fazer scraping de HTML. Três arquivos são servidos na raiz do site:

  • /.well-known/agent.json — o cartão do agente: capacidades, a base /agent-api.php e o esquema de pagamento (x402, exact, USDC na Base).
  • /openapi.json — a definição OpenAPI completa de cada ação (account, topup, endpoints de pedido) com formatos de requisição/resposta.
  • /llms.txt — um mapa em texto puro do site para crawlers de modelos de linguagem, com um /pricing.md complementar para a tabela de preços por país.

A descoberta é somente leitura e não autenticada, então um agente pode decidir se e o que comprar antes mesmo de criar uma conta ou movimentar fundos.

O fluxo de compra: configurar → cotar → pagar → provisionar

  1. 1

    Configurar

    O agente lê o agent.json e o pricing.md, depois escolhe um plano entre 18 países / 43 operadoras — por exemplo, uma porta dedicada US T-Mobile 5G ou um IP compartilhado France Free Mobile que rotaciona a cada 5 minutos.

  2. 2

    Conta

    POST /agent-api.php?action=account cria uma conta sem KYC na primeira chamada e retorna um token Bearer. Não é exigida verificação de nome, endereço, telefone ou e-mail.

  3. 3

    Cotação

    POST /agent-api.php?action=topup com o cabeçalho X-Payment-Mode: x402 e sem comprovação de pagamento retorna HTTP 402 mais um bloco accepts (esquema exact, ativo USDC, rede Base, valor, endereço payTo, nonce/validade).

  4. 4

    Pagar

    O agente assina uma transferWithAuthorization EIP-3009 para o valor USDC cotado ao endereço payTo na Base, produzindo um payload de autorização assinado.

  5. 5

    Liquidar

    Reenvie a mesma requisição de recarga com o cabeçalho X-PAYMENT carregando a autorização assinada. Após a verificação, o saldo é creditado e a resposta retorna 200.

  6. 6

    Provisionar

    O saldo abastecido compra o plano escolhido. As credenciais (HOST, PORT, usuário, senha) são enviadas por e-mail em minutos, e o acesso HTTP/HTTPS/SOCKS5 fica ativo com um IP de operadora com 100% de trust-score.

Passo 1 — criar uma conta, obter um token Bearer

bash
curl -s -X POST 'https://proxy4g.co/agent-api.php?action=account' \
  -H 'Content-Type: application/json'

# 200 OK
# {
#   "account_id": "acct_...",
#   "token": "BEARER_TOKEN",
#   "balance_usdc": "0.00"
# }

Passo 2 — solicitar uma recarga, receber a cotação 402

bash
curl -s -i -X POST 'https://proxy4g.co/agent-api.php?action=topup' \
  -H 'Authorization: Bearer BEARER_TOKEN' \
  -H 'X-Payment-Mode: x402' \
  -H 'Content-Type: application/json' \
  -d '{"amount_usd": 27}'

# HTTP/1.1 402 Payment Required
# {
#   "x402Version": 1,
#   "accepts": [{
#     "scheme": "exact",
#     "network": "base",
#     "asset": "USDC",
#     "maxAmountRequired": "27000000",
#     "payTo": "0xYOUR_PAYTO_ADDRESS",
#     "resource": "/agent-api.php?action=topup",
#     "nonce": "0x...",
#     "validUntil": 1748505600
#   }]
# }

Passo 3 — assinar EIP-3009 e reenviar com X-PAYMENT

bash
# Sign an EIP-3009 transferWithAuthorization for the quoted USDC
# amount to payTo on Base, then base64 the payload into X-PAYMENT.

curl -s -X POST 'https://proxy4g.co/agent-api.php?action=topup' \
  -H 'Authorization: Bearer BEARER_TOKEN' \
  -H 'X-Payment-Mode: x402' \
  -H 'X-PAYMENT: <base64 signed authorization>' \
  -H 'Content-Type: application/json' \
  -d '{"amount_usd": 27}'

# 200 OK -> balance credited; spend it on any plan.
# Verify a provisioned proxy:
# curl -x http://USER:PASS@HOST:PORT https://api.ipify.org

O que o fluxo agêntico herda do fluxo humano

  • Sem KYC: sem documento de identidade governamental, sem nome ou endereço, sem telefone, sem verificação de e-mail — a conta é criada automaticamente na primeira chamada
  • IPs reais de operadora em SIMs físicos em 18 países e 43 operadoras, 100% de trust score
  • Mesma lógica de planos: dedicado (rotaciona sob demanda ou automaticamente a cada 1–60 min) ou compartilhado (rotação automática a cada 5 min)
  • Todos os três protocolos: HTTP, HTTPS e SOCKS5, com autenticação por usuário/senha ou lista de IPs permitidos
  • Não registramos o tráfego de destino — compras agênticas não carregam telemetria extra

Construa com a superfície agêntica

Perguntas Frequentes

O que é o x402 e por que a Proxy4G o usa?

O x402 é um protocolo de pagamento construído sobre o código de status HTTP 402 Payment Required. Uma requisição que precisa de fundos retorna 402 com um bloco estruturado accepts descrevendo como pagar; o cliente paga e reenvia a requisição com a comprovação. A Proxy4G o usa para que agentes autônomos possam abastecer um saldo com USDC na Base e comprar proxies móveis sem etapa de checkout humana.

Qual rede e ativo o pagamento do agente usa?

O esquema é exact, o ativo é USDC, e a liquidação acontece na rede Base. O agente assina uma transferWithAuthorization EIP-3009 para o valor cotado ao endereço payTo retornado na resposta 402, depois reenvia a requisição com essa autorização assinada no cabeçalho X-PAYMENT.

Os agentes precisam concluir o KYC?

Não. O fluxo agêntico herda nosso modelo sem KYC: sem documento de identidade governamental, sem nome ou endereço, sem telefone e sem verificação de e-mail. A conta é criada automaticamente na primeira chamada action=account, e não registramos o tráfego de destino.

Como um agente descobre a API sem fazer scraping de HTML?

Busque os descritores servidos na raiz do site: /.well-known/agent.json para o cartão do agente e o esquema de pagamento, /openapi.json para os schemas completos das ações, e /llms.txt mais /pricing.md para o mapa do site e a tabela de preços. Toda a descoberta é somente leitura e não autenticada.

O que o agente recebe após uma compra bem-sucedida?

O mesmo que um comprador humano recebe: credenciais do proxy — host, porta, usuário e senha — enviadas por e-mail em minutos após o pedido. O proxy suporta HTTP, HTTPS e SOCKS5, com autenticação por usuário/senha ou lista de IPs permitidos, em um IP real de operadora de um dos 18 países e 43 operadoras.

O agente pode reutilizar o saldo para múltiplos pedidos?

Sim. A recarga credita um saldo de carteira, não um único pedido. Uma vez abastecido com USDC na Base, um agente pode fazer múltiplos pedidos contra esse saldo — por exemplo, várias portas dedicadas em diferentes países — e recarregar novamente com outro ciclo x402 sempre que o saldo ficar baixo.

Construa compra autônoma de proxies

Aponte seu agente para /.well-known/agent.json, abasteça um saldo USDC via x402 e provisione IPs reais de operadora sem um humano no processo.

Leia o cartão do agente