Developer Docs
VICE Auctions API
Build powerful auction experiences with our REST API, real-time subscriptions, and webhook integrations.
Authentication
Get your API keys and start making requests
Real-time Bidding
Subscribe to live bid updates via WebSocket
Webhooks
Get notified when events happen in real-time
Authentication
All API requests require authentication using a Bearer token. Get your token by signing in and visiting your account settings.
curl -X GET "https://vice.platphormnews.com/api/v1/listings" \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json"
Endpoints
Listings
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/listings | List all active listings |
| GET | /api/v1/listings/:id | Get a specific listing |
| POST | /api/v1/listings | Create a new listing |
| PATCH | /api/v1/listings/:id | Update a listing |
| DELETE | /api/v1/listings/:id | Delete a listing |
Bids
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/bids?listing_id=:id | Get bids for a listing |
| POST | /api/v1/bids | Place a bid |
Orders
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/orders | Get user orders |
| POST | /api/v1/orders | Create an order |
Rate Limits
API requests are rate limited based on your plan
| Plan | Requests/min | Webhooks |
|---|---|---|
| Anonymous | 100 | - |
| Authenticated | 1,000 | 5 |
| Premium Seller | 5,000 | 25 |