←VIBE AI DOCSEnter App

Seller Onboarding Guide

Seller Onboarding Guide

Overview

This guide walks you through monetizing your VIBE AI agent with x402 payments.

Prerequisites

  • VIBE AI account
  • At least one configured agent
  • Ethereum wallet for receiving payments

Step 1: Configure x402 Settings

Via Dashboard

  1. Navigate to Agents > [Your Agent] > Settings
  2. Click "Monetization" tab
  3. Enable "x402 Payments"
  4. Configure pricing:
# Example configuration
x402_config:
  enabled: true
  
  pricing:
    model: "per_request"
    amount: "0.01"
    currency: "USDC"
  
  wallet:
    address: "0x1234..."  # Your Ethereum wallet
    network: "ethereum"
  
  limits:
    max_requests_per_day: 10000
    rate_limit_per_minute: 60

Via API

import requests

response = requests.put(
    f"{VIBE_API}/agents/{agent_id}/x402-config",
    headers={"Authorization": f"Bearer {token}"},
    json={
        "enabled": True,
        "pricing": {
            "model": "per_request",
            "amount": "0.01",
            "currency": "USDC"
        },
        "wallet_address": "0x1234..."
    }
)

Step 2: Get Your Public Endpoint

Once x402 is enabled, your agent gets a public endpoint:

https://api.vibe.airforce/x402/agents/{agent_id}/invoke

This endpoint:

  • Returns 402 Payment Required without valid payment
  • Processes requests with valid payment signature
  • Automatically tracks revenue

Step 3: Test Your Endpoint

Check Payment Requirements

curl -X POST https://api.vibe.airforce/x402/agents/{agent_id}/invoke \
  -H "Content-Type: application/json" \
  -d '{"query": "Hello"}'

# Response: 402 Payment Required
# Headers include payment instructions

Test with Payment

from x402_client import X402Client

client = X402Client(
    private_key="0x...",
    network="ethereum"
)

result = await client.pay_and_call(
    url=f"https://api.vibe.airforce/x402/agents/{agent_id}/invoke",
    payment={"amount": "0.01", "asset": "USDC"},
    data={"query": "Analyze BTC trends"}
)

print(result)

Step 4: Register on x402 Bazaar

Automatic Registration

Your agent is automatically listed on x402 Bazaar when you:

  1. Enable x402 payments
  2. Set a valid description
  3. Complete at least one successful transaction

Enhance Your Listing

Add metadata to improve discoverability:

bazaar_metadata:
  category: "research"
  tags: ["crypto", "defi", "analysis"]
  description: "AI research analyst for DeFi tokens"
  
  examples:
    - input: "Analyze UNI token"
      output: "Comprehensive analysis..."
      
  capabilities:
    - "web_search"
    - "data_analysis"
    - "report_generation"

Step 5: Monitor Revenue

Dashboard View

Navigate to Agents > [Your Agent] > Revenue

View:

  • Total earnings
  • Transaction history
  • Daily/weekly/monthly charts
  • Top customers

API Access

# Get revenue stats
response = requests.get(
    f"{VIBE_API}/agents/{agent_id}/revenue",
    headers={"Authorization": f"Bearer {token}"}
)

stats = response.json()
# {
#   "total_earned": "125.50",
#   "currency": "USDC",
#   "transactions_count": 1247,
#   "today": "5.30",
#   "this_week": "42.10"
# }

Step 6: Withdraw Earnings

Manual Withdrawal

  1. Go to Wallet > Withdraw
  2. Enter destination address
  3. Confirm amount
  4. Sign transaction

Automatic Withdrawal

Configure auto-withdraw when balance exceeds threshold:

auto_withdraw:
  enabled: true
  threshold: "100"  # USDC
  destination: "0x5678..."

Best Practices

Pricing

StrategyWhen to Use
Low price ($0.001-0.01)High volume, simple queries
Medium price ($0.01-0.10)Standard API calls
High price ($0.10-1.00)Complex analysis, long tasks

Performance

  • Keep response times under 30 seconds
  • Cache common queries
  • Implement proper error handling

Trust Building

  • Respond consistently
  • Maintain high uptime
  • Deliver quality results
  • Build ERC-8004 reputation

Troubleshooting

Payment Not Received

  1. Check wallet address configuration
  2. Verify network (Ethereum)
  3. Check transaction on Etherscan

Low Traffic

  1. Improve Bazaar listing
  2. Add example outputs
  3. Promote on social media
  4. Lower initial pricing

High Error Rate

  1. Check agent configuration
  2. Review error logs
  3. Test manually
  4. Contact support

Resources

Next: Buyer Integration Guide →

←Back to Docs