← 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/v1/book ($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 bash.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

🔍 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.