# VICE Auctions - AI-First Auction Platform

> The next-generation auction platform. AI-first, human-led. Transparent fees, real-time bidding, and the best buyer/seller experience.

## Platform Overview

VICE Auctions is a next-generation, AI-first auction marketplace built on the Platphorm News network. We're revolutionizing online auctions with real-time bidding, AI-powered listing creation, prediction markets, and seamless eBay migration.

**Network**: Platphorm News (https://platphormnews.com)
**Launch Target**: GTA6 Launch Window (Fall 2025 - 2026)
**Scale Target**: 8 billion users

## Core Capabilities

### Auction Engine
- Real-time bidding with sub-100ms latency via Supabase Realtime
- Anti-sniping protection with automatic time extensions
- Multiple auction types: Standard, Reserve, Buy Now, Dutch
- Proxy/auto-bidding system
- Multi-currency support (USD, EUR, GBP, JPY, CNY, KRW, BRL, INR)

### AI Features
- AI-assisted listing creation from photos
- Automatic title and description generation
- Smart pricing recommendations based on market data
- Image enhancement and background removal
- Category auto-detection
- Fraud detection and risk scoring

### Prediction Markets
- "Will it sell?" betting on listings
- Market-driven price discovery
- Leaderboards and social features
- Integration with polymarkets.platphormnews.com

### eBay Migration
- One-click store import
- Listing history preservation
- Review/rating migration
- Bulk import API

## API Reference

Base URL: `https://vice.platphormnews.com/api/v1`

### Authentication
- Supabase Auth with JWT tokens
- OAuth providers: Google, GitHub, Apple
- API keys for programmatic access
- Header: `Authorization: Bearer <token>`

### Endpoints

#### Listings
```
GET    /listings              List active listings
GET    /listings/:id          Get listing by ID
GET    /listings/slug/:slug   Get listing by slug
POST   /listings              Create listing (auth)
PATCH  /listings/:id          Update listing (auth)
DELETE /listings/:id          Delete listing (auth)
```

#### Bids
```
GET    /bids?listing_id=:id   Get bids for listing
POST   /bids                  Place bid (auth)
DELETE /bids/:id              Retract bid (auth, if allowed)
```

#### Categories
```
GET    /categories            List all categories
GET    /categories/:id        Get category with children
```

#### Orders
```
GET    /orders                Get user orders (auth)
POST   /orders                Create order (auth)
GET    /orders/:id            Get order details (auth)
PATCH  /orders/:id            Update order status (auth)
```

#### Search
```
GET    /search?q=:query       Full-text search
GET    /search/suggest?q=:q   Autocomplete suggestions
```

#### Import
```
POST   /import/ebay/auth      Start eBay OAuth
POST   /import/ebay/listings  Import listings
GET    /import/ebay/status    Check import status
```

### Webhooks
Subscribe via `POST /api/webhooks`:
- `listing.created` - New listing published
- `listing.ended` - Auction ended
- `bid.placed` - New bid received
- `bid.outbid` - User was outbid
- `order.created` - Order created
- `order.paid` - Payment received
- `order.shipped` - Item shipped
- `order.delivered` - Item delivered
- `market.resolved` - Prediction market resolved

### Rate Limits
- Anonymous: 100 req/min
- Authenticated: 1,000 req/min
- Premium Sellers: 5,000 req/min
- Enterprise: 50,000 req/min

## MCP Integration

VICE Auctions exposes MCP tools for AI agents:

### Available Tools
1. `vice_search_listings` - Search and filter listings
2. `vice_get_listing` - Get listing details
3. `vice_place_bid` - Place a bid (requires auth)
4. `vice_create_listing` - Create new listing (requires auth)
5. `vice_get_user_profile` - Get user information

### MCP Endpoint
`https://vice.platphormnews.com/api/mcp`

### Example Tool Call
```json
{
  "tool": "vice_search_listings",
  "arguments": {
    "query": "iPhone 16 Pro",
    "category": "electronics",
    "max_price": 1500,
    "condition": "like_new"
  }
}
```

## Data Models

### Listing
```typescript
{
  id: string
  seller_id: string
  title: string
  slug: string
  description: string
  images: string[]
  category_id: string
  condition: 'new' | 'like_new' | 'good' | 'fair' | 'parts'
  starting_price: number
  current_bid: number | null
  buy_now_price: number | null
  reserve_price: number | null
  bid_count: number
  watch_count: number
  status: 'draft' | 'active' | 'ended' | 'sold' | 'cancelled'
  end_time: string
  created_at: string
  updated_at: string
}
```

### Bid
```typescript
{
  id: string
  listing_id: string
  bidder_id: string
  amount: number
  max_amount: number | null
  is_auto_bid: boolean
  status: 'active' | 'outbid' | 'won' | 'retracted'
  created_at: string
}
```

### User Profile
```typescript
{
  id: string
  display_name: string
  avatar_url: string | null
  bio: string | null
  seller_rating: number | null
  buyer_rating: number | null
  total_sales: number
  total_purchases: number
  verified: boolean
  created_at: string
}
```

## Network Integrations

- **Platphorm News Hub**: https://platphormnews.com
- **MCP Services**: https://mcp.platphormnews.com
- **Polymarkets**: https://polymarkets.platphormnews.com
- **Fingerprint**: https://fingerprint.platphormnews.com
- **Shipments**: https://shipments.platphormnews.com
- **CLAWS Security**: https://claws.platphormnews.com
- **Auto Auctions**: https://joecaruser.platphormnews.com
- **GTA6 Integration**: https://gta6.platphormnews.com
- **Onboarding**: https://onboard.platphormnews.com

## Feeds

- **RSS 2.0**: https://vice.platphormnews.com/rss.xml
- **Atom 1.0**: https://vice.platphormnews.com/feed.xml
- **JSON Feed**: https://vice.platphormnews.com/feed.json
- **Sitemap**: https://vice.platphormnews.com/sitemap.xml

## Documentation

- **API Docs**: https://vice.platphormnews.com/api/docs
- **Developer Guide**: https://vice.platphormnews.com/docs
- **Roadmap**: https://vice.platphormnews.com/roadmap
- **Security**: https://vice.platphormnews.com/security
- **Privacy Policy**: https://vice.platphormnews.com/privacy
- **Terms of Service**: https://vice.platphormnews.com/terms

## Contact

- **Support**: support@vice.platphormnews.com
- **API Support**: api@vice.platphormnews.com
- **Security**: security@vice.platphormnews.com
- **Network**: https://platphormnews.com

## Version

API Version: v1
Platform Version: 1.0.0
Last Updated: 2026-08-15