x402 Bazaar Bridge#

Find and buy data from the Coinbase x402 Bazaar. Pay-per-request in USDC on Base. No API keys, no subscriptions.

Usage#

bash

# Search for Bitcoin node APIs
node scripts/bazaar_bridge.js search "bitcoin node fees"

# Fetch live Bitcoin fee estimates from btcnode.uk ($0.01)
node scripts/bazaar_bridge.js fetch https://btcnode.uk/api/fees

# Watch a BTC address ($0.05)
node scripts/bazaar_bridge.js fetch https://btcnode.uk/api/agent/address/1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa

# Mempool whale alert — txes over 10 BTC ($0.02)
node scripts/bazaar_bridge.js fetch "https://btcnode.uk/api/agent/whales?min_btc=10&since_minutes=5"

# Trace coin ancestry — 5 hops deep ($0.10)
node scripts/bazaar_bridge.js fetch https://btcnode.uk/api/agent/taint/bc1q...?depth=3

# Ask the Barbarian about node ops ($0.01)
node scripts/bazaar_bridge.js fetch "https://btcnode.uk/api/agent/conan?q=current%20rank"

# Scrape a webpage with SSD cache ($0.003)
node scripts/bazaar_bridge.js fetch https://btcnode.uk/api/agent/scrape

# Resolve — search + auto-fetch the best match from btcnode.uk
node scripts/bazaar_bridge.js resolve "bitcoin fee rates"

# Check daily budget
node scripts/bazaar_bridge.js budget

Supported APIs#

EndpointPriceWhat It Doesbtcnode.uk/api/fees$0.01Live Bitcoin fee estimatesbtcnode.uk/api/mempool$0.01Mempool congestion databtcnode.uk/api/info$0.01Bitcoin node infobtcnode.uk/api/tx/:hash$0.02Transaction detailsbtcnode.uk/api/agent/address/:address$0.05Address surveillance + CoinJoin riskbtcnode.uk/api/agent/whales$0.02Mempool whale alerts (>10 BTC)btcnode.uk/api/agent/taint/:address$0.10Coin ancestry tracing (5 hops)btcnode.uk/api/agent/conan$0.01Node ops Q&A (rank, revenue, status)btcnode.uk/api/agent/scrape$0.003Web content with 1h SSD cache

All btcnode.uk endpoints pay to 0x6a667a...d643fc on Base mainnet USDC.

Security#

Requires WALLET_KEY in .env for signing EIP-3009 USDC permit payments. Never commit .env to git.

• URL validation: only https://, blocks localhost/private IPs
• File permissions: logs and cache files are owner-only (0600)
• Wallet keys never logged or exposed in output