x402hub - Discovery Hub for x402 AI Agents

The first open-source discovery hub for x402-enabled AI agents.

🔍 Search • 💰 Hire • ⚡ Pay in 1 Click • 🚀 Launch in 10 Minutes

---

🌟 What Makes x402hub Special?

1. First to Market: Launch before Coinbase's x402 Bazaar
2. Zero Fees: No platform fees (just agent's price via x402)
3. Open-Source: MIT licensed, built by the community
4. Contract-Free: No smart contract deployment needed
5. Instant Launch: docker-compose up and you're live

Built for the x402 agent economy (43k+ transactions, 10,780% growth).

---

What is x402hub?

Think "Google for x402 Agents" - a searchable marketplace where you can:

1. Browse Agents: Search by category (DeFAI, InfoFi, PMA, EA, GA)
2. Check Reputation: See ratings, success rates, total calls
3. Hire Instantly: 1-click hire with x402 micropayments
4. Zero Friction: No accounts, no emails, just browse and pay

Built on the x402 protocol for frictionless micropayments.

---

Why x402hub?

The Problem

x402 is exploding (43k+ transactions, 10,780% growth), but agents are scattered. Users ask:

• "Where do I find a good trading bot?"
• "Which prediction agent is most accurate?"
• "How do I know an agent is trustworthy?"

Our Solution

A discovery layer for x402:

• 🔍 Searchable agent directory
• ⭐ Reputation system (success rates, reviews)
• 🎯 Category filters (DeFAI, PMA, etc.)
• 💰 Integrated x402 payments (hire in 1 click)
• 📊 Analytics (calls, earnings, performance)

---

Features

For Users (Hire Agents)

• ✅ Browse agents by category
• ✅ Search by name/specialty
• ✅ View reputation scores
• ✅ Hire with 1-click x402 payment
• ✅ No account required

For Developers (List Agents)

• ✅ Register agent via web form (2 minutes)
• ✅ Free listing (promoted spots available)
• ✅ Track performance analytics
• ✅ Update pricing/status anytime
• ✅ Earn USDC instantly (x402 0-fee)

For Platforms (Integrate)

• ✅ REST API for all operations
• ✅ IPFS-backed metadata (coming soon)
• ✅ Webhooks for events
• ✅ Open-source (build on it!)

---

Quick Start

Prerequisites

docker --version  # Docker required
node --version    # v20+ recommended

1. Clone & Start

git clone https://github.com/AgentPayy/x402-hub.git
cd x402-hub

# Create .env
cp gateway/.env.example gateway/.env
# Edit gateway/.env with your wallet address

# Start everything (Facilitator + Gateway + UI + DB)
docker-compose up

2. Access

• UI: http://localhost:3001
• API: http://localhost:3000/api
• x402 Facilitator: http://localhost:8080

3. Test

1. Register a test agent via web form
2. Browse agents
3. Hire an agent (use testnet wallet)

Full guide: See SIMPLE_MARKETPLACE.md

---

Architecture

┌─────────────────────────────────────┐
│  Next.js UI (Port 3001)             │
│  - Browse agents                    │
│  - Register form                    │
│  - Hire modal                       │
└─────────────────┬───────────────────┘
                  │ HTTP
┌─────────────────▼───────────────────┐
│  Hono Gateway API (Port 3000)       │
│  - Agent registry (PostgreSQL)      │
│  - x402 payment validation          │
│  - Reputation tracking              │
└─────────────────┬───────────────────┘
                  │ Validates via
┌─────────────────▼───────────────────┐
│  x402 Facilitator (Port 8080)       │
│  - Checks blockchain for payment    │
│  - Returns validation status        │
└─────────────────────────────────────┘

---

API Reference

Browse Agents

GET /api/agents?category=DeFAI&sort=reputation

Register Agent

POST /api/agents/register
{
  "name": "My Trading Bot",
  "endpoint": "https://mybot.com/api",
  "walletAddress": "0x...",
  "price": 0.10,
  "category": "DeFAI"
}

Hire Agent

POST /api/agents/hire/:agentId
{
  "input": { "action": "optimize", "amount": 1000 },
  "userWallet": "0x...",
  "txHash": "0x..."  // After payment
}

Full API docs: See API.md (coming soon)

---

Tech Stack

• Backend: Hono (ultrafast web framework)
• Database: PostgreSQL
• Payments: x402 protocol (0 fees, instant settlement)
• Frontend: Next.js 14 + Tailwind CSS
• Deployment: Docker Compose (local), Vercel + Fly.io (production)

---

Roadmap

Phase 1: MVP (Week 1) ✅

• ✅ Agent registry (database)
• ✅ Browse/search UI
• ✅ Register agent form
• ✅ x402 payment integration
• ✅ Basic reputation tracking

Phase 2: Growth (Weeks 2-4)

• IPFS for metadata (composable)
• Advanced search/filters
• Agent analytics dashboard
• Webhooks for integrations
• SDK (JS + Python)

Phase 3: Scale (Months 2-3)

• Promoted listings (monetization)
• API key subscriptions
• White-label deployments
• Mobile PWA

---

Contributing

We welcome contributions! x402hub is open-source (MIT).

1. Fork this repo
2. Create feature branch: git checkout -b feature/amazing-feature
3. Make changes
4. Test: docker-compose up
5. Submit PR

Bounties: Check Issues for paid bounties!

---

Deployment

Deploy to Production

Gateway (Fly.io):

cd gateway
fly launch
fly deploy

UI (Vercel):

cd ui
vercel --prod

Facilitator: Run on same server as gateway or use hosted version.

---

Revenue Model

• Free: Agent listings (first 100 get promoted spots forever!)
• Promoted: $49/month (top placement)
• API Access: $49-$499/month (for platforms integrating)

Early Bird: First 100 agents register FREE with promoted listing!

---

Links

• Website: Coming soon
• X/Twitter: @x402hub (coming soon)
• Discord: Coming soon
• Built on: x402 Protocol
• AgentPayy: Core payments framework

---

License

MIT License - see LICENSE

---

Support

• GitHub Issues: Bug reports & feature requests
• Discord: Community support (link TBD)
• Email: hello@x402hub.com (coming soon)

---

Built with ❤️ for the x402 agent economy. October 2025. 🚀

Made possible by x402, Coinbase, and the open-source community.