🫘 GoldBean

⚡ Live Demo — Try it Now

Click a button below to call a real GoldBean API endpoint. No sign-up required!

🚀 Quick Start — 30 Seconds

# Get weather (free)
curl "https://goldbean-api.xyz/weather-now?city=London"

# BTC price (free)
curl "https://goldbean-api.xyz/btc-price"

# ETH gas (free)
curl "https://goldbean-api.xyz/gas"

# Step 1: Get x402 pricing quote
curl -H "Accept: application/x402+json" \
  "https://goldbean-api.xyz/paid/weather-now?city=Tokyo"

# Step 2: Sign the 402 challenge with your wallet
# (see x402 tutorial below)

# Step 3: Call with signed payment
curl -H "Authorization: x402 " \
  "https://goldbean-api.xyz/paid/weather-now?city=Tokyo"

# Add to your Claude Desktop / Cursor / Windsurf config:
{
  "mcpServers": {
    "goldbean": {
      "command": "npx",
      "args": ["-y", "goldbean-mcp"]
    }
  }
}

# Or install globally:
npm install -g goldbean-mcp

💰 Pricing — Starting at $0.01

No subscription. No monthly fees. Pay only for what you use.

View Full Plan Details →

🔐 How x402 Works

x402 is a pay-per-request protocol for HTTP APIs. Instead of API keys or subscriptions, you pay per call using USDC on Base.

Quick x402 Signing Tutorial:

1. Install a wallet
   Use MetaMask or any EVM wallet on Base network. Get USDC on Base.
2. Make an x402 request

   curl -v -H "Accept: application/x402+json" \
     "https://goldbean-api.xyz/paid/weather-now?city=Tokyo"

3. Sign the challenge
   The server returns a 402 Payment Required with a X-402-Payment header containing the payment URL. Use your wallet to sign the transaction.

   # Example response header:
   # X-402-Payment: https://goldbean-api.xyz/x402/pay/0x1234...
   # 
   # Send USDC to the contract address returned
   # Include the signed transaction hash as Bearer token

4. Get your data

   curl -H "Authorization: Bearer <signed-tx-hash>" \
     "https://goldbean-api.xyz/paid/weather-now?city=Tokyo"

📚 Resources