Submit: Agent Commerce Desk — Base wallet readiness and market data APIs via x402 USDC

[chico10117]

Service URL

https://x402-wallet-readiness-service.vercel.app

Summary

Agent Commerce Desk exposes x402-paid Base wallet readiness checks and crypto market-data micro-APIs. It is designed for agents that need to verify a Base receiving wallet, fetch a structured agent-commerce receipt, or buy small JSON market-data responses without account signup.

Discovery Endpoints

Endpoint	Description
/.well-known/x402	x402 v2 manifest with protected resources, Base USDC payment terms, and agent-card link
/.well-known/agent-card.json	Agent card with capabilities, payment metadata, and JSON input schemas
/api/readiness/:address	Protected Base wallet readiness report
/api/agent-commerce-receipt/:address	Protected agent-commerce receipt plus wallet-readiness evidence
/api/x402/market/crypto-snapshot	Protected top crypto market snapshot JSON feed
/api/x402/market/ohlcv	Protected daily OHLCV JSON feed from Coinbase public data

Network & Payment

Network	Chain ID	Token	Asset Contract	Wallet
Base	8453 / eip155:8453	native USDC	0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913	0x820a7bf90d944bb26bfD9b62Ab172Fc3A0829cB9

Facilitator: https://facilitator.world.fun

Protected Resources

Method	Path	Price	Description
GET	/api/readiness/0x820a7bf90d944bb26bfD9b62Ab172Fc3A0829cB9	2.00 USDC	ETH balance, native USDC balance, transaction count, token transfers, and contract status for a Base wallet
GET	/api/agent-commerce-receipt/0x820a7bf90d944bb26bfD9b62Ab172Fc3A0829cB9	2.00 USDC	Agent-commerce receipt combining identity metadata, x402 terms, and wallet-readiness evidence
GET	/api/x402/market/crypto-snapshot?limit=50	0.01 USDC	Ranked crypto market snapshot with price, market cap, 24h volume/change, and Coinbase bid/ask when available
GET	/api/x402/market/ohlcv?pairs=BTC-USD,ETH-USD&days=365	0.02 USDC	Daily OHLCV market feed for BTC-USD, ETH-USD, and SOL-USD from Coinbase Exchange public candles

Verification Notes

Unauthenticated protected calls return HTTP 402 with a base64 payment-required header containing x402 v2 accepts terms for Base USDC.

Demo/readback endpoints are also available without payment for preview:

• GET /api/market/crypto-snapshot?limit=3
• GET /api/market/ohlcv?pairs=BTC-USD,ETH-USD&days=3

Public repo: https://github.com/chico10117/basepay-readiness-service

[chico10117]

Update: the service now exposes an additional developer-tool x402 endpoint for public GitHub repo intelligence snapshots.\n\nFree preview:\nGET https://x402-wallet-readiness-service.vercel.app/api/dev/repo-snapshot?repo=vercel/next.js\n\nPaid x402 endpoint:\nGET https://x402-wallet-readiness-service.vercel.app/api/x402/dev/repo-snapshot?repo=vercel/next.js\n\nPayment: exact x402, Base mainnet, native USDC, amount 50000 atomic units ($0.05), payTo 0x820a7bf90d944bb26bfD9b62Ab172Fc3A0829cB9. The endpoint is also now included in /.well-known/x402 and /.well-known/agent-card.json.

[chico10117]

Update for review: Agent Commerce Desk is now on service version 0.11.5 and exposes 8 paid x402 resources, including both GET and POST 100 USDC integration-triage entrypoints on Base.

Current public checks:

• /.well-known/x402 advertises 8 resources.
• POST /api/x402/services/integration-triage now returns a structured 402 challenge before execution for no-payment/bodyless probes.
• CORS/preflight is browser-agent readable for sampled paid routes.
• Unpaid payment challenges use Cache-Control: private, no-store.
• npx --yes x402-surface-check@latest https://x402-wallet-readiness-service.vercel.app/.well-known/x402 --limit 12 --origin https://x402-wallet-readiness-service.vercel.app reports no obvious launch-readiness findings from public no-payment probes.

Payout wallet remains native Base USDC: 0x820a7bf90d944bb26bfD9b62Ab172Fc3A0829cB9.

[chico10117]

Follow-up update for the Agent Commerce Desk origin:

• Origin: https://x402-wallet-readiness-service.vercel.app
• OpenAPI: https://x402-wallet-readiness-service.vercel.app/openapi.json
• x402 manifest: https://x402-wallet-readiness-service.vercel.app/.well-known/x402
• Service version: 0.11.8

The origin now registers cleanly through AgentCash/x402scan discovery:

{
  "x402scan": {
    "success": true,
    "registered": 10,
    "failed": 0,
    "total": 10,
    "source": "openapi"
  }
}

Fresh no-payment surface check also passes with 10 probed resources, including the new 50 USDC quick-review GET and POST endpoints. All sampled preflights return 204; all sampled unpaid 402 challenges use Cache-Control: private, no-store; final finding: No obvious launch-readiness findings from the public no-payment probes.

No payment headers, wallet signatures, private endpoints, or paid calls were used.