API Overview
Core concepts and available endpoints for the SNS Auctions API
Base URL
https://api.snsauctions.xyz/api/v1Authentication
Write endpoints require API keys. Some read endpoints support public access with lower limits.
Header
X-API-Key: sk_your_api_key_hereNever share your API keys publicly. Treat them like passwords.
Response Format
All responses are JSON with a consistent structure:
{
"success": true,
"data": {
// Response data here
},
"timestamp": 1234567890
}For errors:
{
"success": false,
"error": "Error message",
"code": "ERROR_CODE",
"timestamp": 1234567890
}Available Endpoints
Auctions
GET/auctions
List all auctions
GET/auctions/:id
Get auction details
POST/auctions/create
Create a new auction
Bidding
POST/auctions/:id/bid
Place a bid
POST/auctions/:id/settle
Settle a completed auction
Users
GET/users/:address
Get user profile
API Keys
POST/keys/create
Create API key
GET/keys
List keys for authenticated wallet
POST/keys/:id/revoke
Revoke API key
Rate Limiting
Route handlers currently enforce limits by endpoint/auth status:
| Endpoint | Limit |
|---|---|
| List/Get Auctions | 100/min public, 1000/min authenticated |
| Create Auction | 10 req/min |
| Place Bid | 60 req/min |
| Settle Auction | 30 req/min |
| Get User Profile | 100/min public, 1000/min authenticated |
Contact support if you need higher limits.
© 2026 SNSAuctions.xyz. Built on Solana.