← Back to Docs

⚡ Quick Reference

Everything you need at a glance — endpoints, fees, chains, and key facts.

API Endpoints

POST

/api/v1/search

Search for local service providers. Returns AgentPay verified + OSM results ranked by proximity.

$0.001 USDC
POST

/api/v1/book

Book a service with a provider. Triggers SMS + voice notification to provider instantly.

$0.002 USDC
POST

/api/v1/ai/search

Natural language AI-powered search. Describe what you need in plain English.

$0.002 USDC
POST

/api/v1/ai/chat

Chat with the AgentPay AI assistant. Free — no payment required.

Free
POST

/api/v1/marketplace/register

Register your AI agent and get an API key for programmatic access.

Free
GET

/openapi.json

Full OpenAPI 3.0 specification for all endpoints.

Free
GET

/llms.txt

AI agent discovery file — describes all capabilities for LLM agents.

Free
💰 Platform Fees
Under $503% — provider keeps 97%
$50 – $2002% — provider keeps 98%
Over $2001% — provider keeps 99%
AI agent API0.1% per call
Monthly feeNone — pay only when you earn
⛓️ Supported Chains
Base mainnetPRIMARY USDC x402
EthereumERC-20 USDC
PolygonUSDC.e
ArbitrumUSDC
OptimismUSDC
AvalancheUSDC.e
BaseUSDC (SPL)
StripeCards, Apple Pay, Google Pay
📞 Contact & Links
Support emailx402agentpay@gmail.com
Websitex402-agent-pay.com
GitHubgithub.com/shawnhvac/-x402-agent-network
Bazaar listingagentic.market
Android APK/downloads/agentpay-provider.apk
Chrome Extension ⬇ Download v1.0  ·  Register as Provider  ·  Provider Login
🔑 Key Pages
/marketplaceSearch and book services
/pricingFull pricing breakdown
/roadmapProduct roadmap
/register-agentRegister AI agent
/provider-downloadAndroid app download
/investor-pitchInvestor pitch deck
/docsFull documentation

🔏 EIP-712 Agent Grants

ConceptValue / Detail
EndpointPOST /x402/verify-grant
EIP-712 Domain name"x402-AgentGrant"
EIP-712 version"1"
chainId8453 (Base L2)
verifyingContract0x0000000000000000000000000000000000000000
Timing grace period±30 seconds on issuedAt / expiration
Revocation checkOnly in final 30% of grant lifetime
totalBudget unitUSDC micro-units (6 decimals) — $1 = 1,000,000
Conformance runnerGET /x402/conformance — runs all 6 spec vectors live
Test vectorsGET /x402/test-vectors — returns spec vector metadata
Full specgithub.com/shawnhvac/x402/specs/grants.md
Payment flow specgithub.com/shawnhvac/x402/specs/payment-flow.md

Grant Struct Fields

FieldTypeDescription
grantIduint256Unique grant identifier
principaladdressWho authorizes the spend (the signer)
agentaddressWho is authorized to spend
issuedAtuint256Unix timestamp when grant was signed
expirationuint256Unix timestamp when grant expires (typical: now + 900)
totalBudgetuint256Max total USDC (in micro-units, must be > 0)
perRequestCapuint256Max USDC per single request
scopesbytes32[]Tool namespaces authorized (e.g. keccak256("trade"))
saltbytes32Replay attack prevention (use ethers.id("unique-value"))

X-402-Payment Header Format (payment-flow.md)

FieldDescription
grantFull grant struct as JSON object
signatureEIP-712 signature from wallet.signTypedData()
receiptHashkeccak256 of request body — prevents replay

Encode as: base64(JSON.stringify({grant, signature, receiptHash})) → set as X-402-Payment header