x402 API

Pay-per-call in USDC on Base

Built for AI agents. Each request carries a signed USDC authorization; we verify, settle, and return the answer. No signup, no API key, no subscription.

At a glance

Protocol
x402 v2 over HTTP (see coinbase/x402)
Network
Base mainnet
Settlement
USDC (ERC-3009 transferWithAuthorization)
Facilitator
Coinbase Developer Platform (KYT + OFAC screening handled)
Merchant address
0xCca4725e0e931982830bff523b141E1A7a58d3E7

Endpoints + pricing

EndpointPer callSummary
POST /api/x402/v1/email/verify$0.005 USDCDeliverability check via SMTP RCPT probe
POST /api/x402/v1/email/validate$0.003 USDCDNS-only deliverability check (syntax + MX + disposable + role)
POST /api/x402/v1/email/find$0.010 USDCFind working email via sequential SMTP pattern probing
POST /api/x402/v1/linkedin/find-url$0.008 USDCFind LinkedIn profile URL via public search engines
POST /api/x402/v1/prospects/search$0.012 USDCSearch the shared prospect pool by tag overlap

Machine-readable spec at api.bavlio.com/openapi.json (includes x-agent-examples for each endpoint). Human-readable docs: /docs (Swagger UI) and /redoc.

Example

# 1. GET the endpoint first. It returns HTTP 402 with x402 payment requirements.
curl -i https://api.bavlio.com/api/x402/v1/email/verify \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

# Response (402 Payment Required) includes 'x-payment' hints with:
#   - network: base-mainnet
#   - pay_to: 0xCca4725e0e931982830bff523b141E1A7a58d3E7
#   - price: 5000 (atomic USDC = $0.005)

# 2. Sign a USDC transferWithAuthorization with your CDP wallet and resubmit.
#    The x402 library (Python/TS) handles the signing + retry automatically:
#
#    from x402.clients.requests import X402Client
#    client = X402Client(wallet=your_cdp_wallet, network="base-mainnet")
#    response = client.post("https://api.bavlio.com/api/x402/v1/email/verify",
#                           json={"email": "[email protected]"})

Discovery: AgentCash + scanners

Bavlio ships with an AgentCash skill definition so autonomous agents can discover + invoke the 5 endpoints without human configuration. The same catalog feeds x402scan, x402.direct, and the x402 Bazaar (`x402.extensions.bazaar`). Listings return the live merchant address, pricing, and endpoint list — always sourced from api.bavlio.com/openapi.json.

Want an API key instead?

Bavlio customers on a SaaS plan can hit the same data via the traditional API-key authenticated REST endpoints. Usage draws from your plan credits instead of settling on-chain per call.