# AuctionBotPro

> Precision auction sniping for ShopGoodwill.com. Automated last-second bidding, price research, and shipping calculations. Pay-per-use via x402 (USDC on Base) or API key.

## API

- [OpenAPI Spec](https://api.auctionbotpro.com/.well-known/openapi.json): Full machine-readable API specification
- [AI Plugin Manifest](https://api.auctionbotpro.com/.well-known/ai-plugin.json): ChatGPT/LLM plugin configuration
- [Full API Documentation](https://api.auctionbotpro.com/llms-full.txt): Complete API reference in a single file

## Capabilities

- **Search**: Find items on ShopGoodwill by keyword, category, price range
- **Item Details**: Get full listing info including images, current price, end time
- **Shipping**: Calculate shipping costs to any US zip code
- **Snipe**: Create automated last-second bids with configurable timing (3-120s before end)
- **Quick Bid**: Place immediate bids without scheduling
- **Price Research**: Research resale prices across eBay, Mercari, Poshmark, Amazon
- **History**: View past bids and results

## Authentication

- **x402 (recommended for agents)**: No account needed. Pay per API call with USDC on Base chain. Send request without auth → receive 402 with payment details → pay → retry with payment proof.
- **API Key**: Set `X-API-Key` header. For automation and scripts.
- **Bearer Token**: Session token for authenticated web users.

## Pricing (x402)

- Search, item details, shipping, list/get snipes, history: $0.01/call
- Price research: $0.25/call
- Quick bid: $0.50/call
- Create snipe: $1.00/call

## Links

- [Website](https://auctionbotpro.com)
- [Documentation](https://auctionbotpro.com/docs)
- [Developer Guide](https://auctionbotpro.com/developers)
- [Terms of Service](https://auctionbotpro.com/terms)
- [Privacy Policy](https://auctionbotpro.com/privacy)