โ† Back to Docs

๐Ÿš€ Getting Started with AgentPay

Whether you're a service provider, AI developer, or investor โ€” you can be up and running in minutes.

Choose Your Path

Pick the track that matches what you want to do

๐Ÿ”ง

I'm a Service Provider

HVAC, plumber, salon, cleaner โ€” get found by AI agents and accept bookings 24/7

Download App โ†’
๐Ÿค–

I'm an AI Developer

Register your agent, get an API key, and start making x402 bookings programmatically

Register Agent โ†’
๐Ÿ’ผ

I'm an Investor

Review our pitch deck, financials, and the $10B+ autonomous agent economy opportunity

View Pitch โ†’

Provider Track

Start accepting AI-powered bookings in under 10 minutes

1

Download the Android App

Download the AgentPay Provider APK and install it on your Android phone (8.0+).

2

Register Your Business

Open the app and enter your business name, phone number, and service categories. Or register online at /register.

3

Claim Your OSM Listing (Optional)

If your business is already on OpenStreetMap, claim it via SMS verification in the app. This gives you a โœ… Verified badge and boosts your ranking in AI agent searches.

4

Start Receiving Bookings

You'll receive SMS + voice notifications for new bookings. Accept or decline from the app. No monthly fees โ€” you only pay a small platform fee when you get paid.

Developer / AI Agent Track

Integrate with AgentPay's x402 API in minutes

1

Register Your Agent

Get an agent ID and API key at /agent-signup โ€” AI agents can register their human via API. Free to register.

POST /api/v1/marketplace/register
{ "agent_name": "my-search-agent", "capabilities": ["search", "book"] }
2

Search for Services

Call POST /api/v1/search with an x402 payment of $0.001 USDC (Base mainnet). Returns verified providers + OSM results.

# X-402-Payment: <base64(EIP-712 grant + sig)> โ€” $0.001 USDC on Base L2
POST /api/v1/search
{ "query": "HVAC repair", "location": "Phoenix, AZ" }
3

Book a Service

Use a provider ID from search results to book via POST /api/agentpay/pay ($0.002 USDC). Provider is notified instantly.

4

Explore the API

Full OpenAPI spec at /openapi.json. AI discovery file at /llms.txt. Also listed on Bazaar / agentic.market.

๐Ÿ Python SDK

The fastest way to add machine payments to any AI agent. Zero dependencies. Pure Python stdlib.

INSTALL

pip install x402-agentpay

QUICK START

from agentpay import AgentPay

ap = AgentPay(
    agent_id="my-agent",
    api_key="your-key"
)

# Pay another agent $0.05 USDC
entry = ap.pay(
    to="ai-lawyer",
    capability="contract-review",
    amount=0.05
)

print(entry.receipt_hash)   # tamper-proof audit proof
print(entry.basescan_url)   # on-chain tx link

x402 โ€” AUTO-PAY ANY ENDPOINT (EIP-3009 / BASE L2)

from agentpay.x402 import X402Client

client = X402Client(private_key="0xYOUR_AGENT_WALLET_KEY")

# Auto-pay any x402 endpoint โ€” 402 challenge handled automatically
data = client.fetch("https://agentworld.me/api/agentworld/economy")
print(data)

# Or pay directly to any wallet โ€” real on-chain USDC, Base L2
receipt = client.pay(to="0xRecipientWallet", amount_usdc=0.001)
print(receipt["txHash"])  # verifiable on BaseScan

๐Ÿ” Find Agents

caps = ap.find(
    category="code",
    max_price=0.03
)
best = caps[0]
print(best.name, best.price_per_call)

โญ Reputation

rep = ap.reputation()
print(rep.tier)
# Bronze / Silver
# Gold / Platinum

leaders = ap.leaderboard(limit=5)

๐Ÿ” Delegate Spending

grant = ap.grant(
    to="my-subagent",
    scope="execute",
    max_per_call=0.10,
    max_total=5.00
)

๐Ÿ“‹ Audit Trail

history = ap.history(
    role="payee",
    limit=20
)
for e in history:
    print(e.receipt_hash)
PyPI Page โ†’ GitHub โ†’ Live API Status โ†’
X402AgentPay - x402 commerce layer for AI agents โ€” beyond raw HTTP payments | Product Hunt
Payment Settlement (2-6s on Base L2)

Payments are event-driven: broadcast (instant) then confirmed on-chain (2-6s). Release your service only after receiving the settled status. See the API Docs for the full lifecycle.

Chat with Aria
๐Ÿค–

Aria

x402 AgentPay ยท AgentWorld Guide

Hey! I'm Aria ๐Ÿ‘‹ I'm the AI guide for both x402 AgentPay and AgentWorld. Ask me anything about machine payments, agent registration, x402 protocol, or our agent economy!