Macro Pulse

Índice de momentum econômico por país (PIB, inflação, desemprego) via micropagamentos x402 — US$ 0,02/chamada, USDC na Base.

Documentação

Macro Pulse — API paga via x402

Um endpoint protegido por x402 que fornece a agentes de IA uma "pontuação de momentum econômico" calculada por país. Construído inteiramente com dados gratuitos e de domínio público do Banco Mundial (https://data.worldbank.org) — nada aqui reembala um feed licenciado/pago.

O que faz

GET /macro-pulse/{country_code} (ex.: /macro-pulse/US) — preço: $0,02/chamada

Puxa dados de crescimento do PIB, inflação e tendências de desemprego da API do Banco Mundial e sintetiza uma única pontuação direcional de "momentum" + rótulo (melhorando / estável / deteriorando), com o histórico bruto dos indicadores incluído para transparência.

Testado localmente — confirmado que o gateway de pagamento retorna corretamente HTTP 402 com requisitos de pagamento válidos (scheme=exact, asset=USDC, network=Base) quando nenhum pagamento está anexado, e a lógica subjacente de dados/pontuação retorna dados corretos do Banco Mundial.

O que VOCÊ precisa fazer antes que isso possa gerar dinheiro de verdade

  1. Obtenha um endereço de carteira Base (Coinbase Wallet ou MetaMask configurado para Base). É para onde os pagamentos USDC são enviados. Defina-o como PAY_TO_ADDRESS. NUNCA compartilhe sua chave privada/frase-semente com ninguém, inclusive comigo.

  2. Decida entre testnet vs. mainnet:

    • Testnet (Base Sepolia, NETWORK=eip155:84532) — é para o que isso está configurado agora. Seguro para testar com USDC falso, $0 de risco real.
    • Mainnet (NETWORK=eip155:8453) — dinheiro real. Para liquidação em mainnet, você precisa de um facilitador que a suporte. O https://x402.org/facilitator público é apenas para testnet — para mainnet, crie uma conta gratuita no Coinbase Developer Platform (CDP) (https://portal.cdp.coinbase.com) e use o facilitador hospedado + chave de API deles.
  3. Implante-o em algum lugar publicamente acessível (um domínio/URL real, não localhost) para que agentes e marketplaces possam encontrá-lo — posso ajudar com isso assim que a carteira e a escolha de rede estiverem definidas.

  4. Liste-o em uma camada de descoberta — o Bazaar do https://www.x402scan.com ou https://x402.org para que agentes possam encontrá-lo e pagar por ele automaticamente. Adicione também um manifesto /.well-known/x402 para descoberta automática.

Expectativas realistas

A $0,02/chamada, isso precisa de volume real (centenas a milhares de chamadas) para acumular dinheiro significativo. Trate isso como um projeto paralelo de crescimento lento, não uma vitória rápida — veja a discussão anterior para faixas de receita realistas.

Arquivos

  • app.py — o serviço FastAPI completo com middleware de pagamento x402