ScorePlay provides REST API endpoints for accessing platform data. This is a high-level overview - full API reference coming soon.

Base URL

https://scoreplay.xyz/api

Authentication

Most endpoints require authentication via JWT token stored in cookies after wallet connection.

Main Endpoints

Events

• GET /api/available-events - List available matches/events
• GET /api/events/[id] - Get event details
• GET /api/events/[id]/odds - Get odds data for an event

Predictions

• GET /api/user/predictions - Get user's prediction history
• POST /api/pred2earn/bet-placed - Submit V1 bet placement
• POST /api/pred2earn/bet-placed-v2 - Submit V2 bet placement
• POST /api/pred2earn/claim-payout - Claim winnings from a bet

Leaderboard

• GET /api/leaderboard - Get leaderboard rankings
• GET /api/leaderboard/user-row - Get specific user's rank
• GET /api/leaderboard/top-points - Get top players by points

User

• GET /api/user/profile-stats - Get user statistics
• GET /api/referrals - Get referral stats
• POST /api/referrals - Redeem referral rewards

Daily Rewards

• GET /api/daily-raffle - Check daily raffle eligibility
• GET /api/reclaim/info - Get daily claim information
• POST /api/reclaim - Claim daily free credits

Rate Limiting

API endpoints are rate-limited. Check response headers for rate limit information.

Response Format

Most endpoints return JSON:

{
  "success": true,
  "data": { ... }
}

Error responses:

{
  "error": "Error message",
  "status": 400
}

Full Documentation

Full API reference documentation with detailed request/response schemas coming soon.

For integration questions, contact: [email protected]