Developer & AI Agent Guide
AuctionBotPro exposes a full REST API that humans and AI agents can use to search, bid, and snipe ShopGoodwill auctions. Pay per call with USDC on Base via x402 — no account required.
Discovery Endpoints
Authentication
No account needed. Send a request without auth headers — the API returns HTTP 402 with payment requirements. Sign a USDC transfer on Base chain, retry with the payment proof, and receive your result.
# 1. Send request (no auth) → get 402 with payment info
curl https://api.auctionbotpro.com/api/search -d '{\"searchText\":\"lamp\"}'
# 2. Sign payment with your wallet, retry with X-PAYMENT header
curl https://api.auctionbotpro.com/api/search \
-H "X-PAYMENT: <base64-payment-payload>" \
-d '{\"searchText\":\"lamp\"}'
For scripts and automation. Set via the Settings page or admin dashboard.
curl https://api.auctionbotpro.com/api/search \
-H "X-API-Key: your-api-key" \
-d '{\"searchText\":\"vintage lamp\"}'
For authenticated web users. Session tokens are issued on sign-in via Better Auth.
x402 Payment Protocol
x402 is an open payment protocol that uses the HTTP 402 status code for internet-native payments. AI agents can autonomously discover prices, pay with USDC on Base, and receive results.
Request without auth
Server returns 402 Payment Required with X-PAYMENT-REQUIRED header
Decode payment requirements
Base64-decode the header to get: network (evm:8453), amount (USDC), payTo address
Sign payment
Sign a USDC TransferWithAuthorization (EIP-3009) for the required amount
Retry with payment proof
Add X-PAYMENT header with Base64-encoded payment payload. Server verifies and returns result.
Payment details: USDC on Base (chain ID 8453) • Contract: 0x8335...02913 • Facilitator: facilitator.x402.org • Learn more about x402
Endpoints & Pricing
All endpoints are available via x402 pay-per-call. Authenticated users with credits are not charged per-call.
/api/search$0.01/api/snipes/item/{id}$0.01/api/snipes/shipping$0.01/api/snipes$1.00/api/snipes/test-bid$0.50/api/research$0.25/api/snipes$0.01/api/history$0.01AI Agent Quick Start
AI agents can discover AuctionBotPro through standard web protocols:
/llms.txt to understand available capabilities/.well-known/openapi.json for full endpoint schemasFor full API details including request/response schemas, load /llms-full.txt — it contains everything in a single, context-window-friendly file.