GoldBean

Mercado de API de IA com pagamento por chamada, com 47 endpoints — OCR, chat com LLM, geração de imagens, TTS

Documentação

🫘 GoldBean - Mercado de API com micropagamentos x402

Pague por requisição com USDC na Base. Sem cadastro, sem chave de API, sem assinatura mensal. Cada chamada custa $0,02 USDC via protocolo x402.

GoldBean está no ar: http://104.225.233.23:9879

Início Rápido

1. Pré-requisitos

USDC na Base (eip155:84532 testnet ou eip155:8453 mainnet)
Uma carteira que possa assinar pagamentos x402 (AgentCash, CDP Wallet ou qualquer carteira EVM)

2. Experimente um Endpoint Gratuito

curl http://104.225.233.23:9879/health
# {"status":"ok","service":"GoldBean","timestamp":"2026-05-15T12:00:00.000Z"}

curl http://104.225.233.23:9879/eth-price
# {"usd":"2255.93","change24h":"+0.31%","timestamp":"2026-05-15T12:00:00.000Z"}

3. Chame um Endpoint Pago

curl http://104.225.233.23:9879/paid/btc-price
# HTTP 402 Payment Required
# x402-challenge: {...}

Para pagar o 402 e obter dados, você precisa de um cliente compatível com x402:

Usando AgentCash:

npx agentcash@latest fetch http://104.225.233.23:9879/paid/btc-price

Usando x402-proxy (ferramenta CLI):

npx x402-proxy http://104.225.233.23:9879/paid/btc-price

Usando curl com pagamento manual (avançado):

# Step 1: Request triggers 402
curl -s -D - http://104.225.233.23:9879/paid/btc-price

# Step 2: Parse x402-challenge header, sign with your wallet
# Step 3: Retry with x402-payment header
curl -H "x402-payment: <signed-payment>" http://104.225.233.23:9879/paid/btc-price

4. Integração MCP

Adicione à configuração do Claude Desktop / Cursor / Cline mcpServers:

{
  "mcpServers": {
    "goldbean": {
      "url": "http://104.225.233.23:9879/mcp"
    }
  }
}

Endpoints Disponíveis

Gratuitos (sem necessidade de pagamento)

Endpoint	Descrição
`GET /`	Informações do serviço e lista de endpoints
`GET /health`	Verificação de saúde
`GET /eth-price`	Preço do ETH em tempo real (via CoinGecko)
`GET /gas`	Estimativa de preço de gás do ETH
`GET /card`	Cartão de serviço / metadados
`GET /mcp`	Manifesto do protocolo MCP

Pagos ($0,02 USDC por chamada)

Endpoint	Descrição
`GET /paid/btc-price`	Preço do BTC em tempo real (via CoinGecko)
`GET /paid/gas-forecast`	Previsão de preço de gás
`GET /paid/market-intel`	Sentimento do mercado e Índice de Medo e Ganância
`GET /paid/defi-insights`	TVL de DeFi e dados de cadeia
`GET /paid/network-health`	Saúde da rede blockchain
`GET /paid/tracker-report`	Relatório de MEV e rastreador on-chain
`GET /paid/sol-token-risk`	Avaliação de risco de token Solana

Como Funciona o Pagamento x402

Client                          GoldBean Server
  │                                   │
  ├─ GET /paid/btc-price ─────────────┤
  │◄─ 402 Payment Required ───────────┤
  │   x402-challenge: {...}           │
  │                                   │
  ├─ Sign challenge with wallet ──────┤
  │   (off-chain, no gas fee)         │
  │                                   │
  ├─ GET /paid/btc-price ─────────────┤
  │   x402-payment: <signed>          │
  │◄─ 200 OK ─────────────────────────┤
  │   {"usd":"68000.00",...}          │
  │                                   │

O facilitador (x402.org) cuida da liquidação. Sua carteira envia USDC apenas quando o desafio é aceito. Sem cobranças recorrentes.

Fontes de Dados

API CoinGecko — Preços de criptomoedas em tempo real
API Etherscan — Oráculo de preço de gás
Alternative.me — Índice de Medo e Ganância

Informações do Vendedor

Carteira do vendedor: 0xB5f5CBe48E0595C044Bc626f278F757463eAc2Ce (Base)
Rede: eip155:84532 (testnet Base Sepolia) → migrando para eip155:8453 (mainnet Base)
Facilitador: https://x402.org/facilitator
Preço: $0,02 USDC por chamada paga

Arquitetura

┌─────────────┐     x402 protocol      ┌──────────────┐
│   Client    │ ◄─────────────────────► │   VPS (USCA) │
│ (curl/Agent)│     HTTP + 402 flow     │  GoldBean 🫘 │
└─────────────┘                         │  :9879       │
       │                                └──────┬───────┘
       │         ┌──────────────┐              │
       └────────►│    Email     │◄─────────────┘
                 │  (Gmail)     │  Monitor alerts
                 │   Monitor    │
                 └──────────────┘

Desenvolvimento

# Server
cd /opt/goldbean
npm install express axios @x402/express @x402/core @x402/evm
node server.js

# Monitor
python3 /opt/goldbean/chain_monitor.py

Ecossistema

Construído no Bandwagon VPS (USCA-2). Parte do ecossistema x402.