Public API Reference
The Xponent REST API lets you read leaderboard and member data for your server from any external application.
Base URL
https://xponentbot.xyz/api/v1
Authentication
Pass your server API key in the x-api-key header. Generate keys from Dashboard → API Keys.
x-api-key: YOUR_API_KEY
GET
/servers/{guild_id}/leaderboard
Returns the top members sorted by XP descending.
Query params
- limit (default 10, max 100)
- page (default 1)
Example response
{"data":[{"rank":1,"user_id":"123456","username":"Alice","level":42,"xp":176400}],"total":1240,"page":1}
GET
/servers/{guild_id}/members/{user_id}
Returns XP, level, rank, streak, and last_daily_claim for a specific member.
Example response
{"user_id":"123456","username":"Alice","level":42,"xp":176400,"rank":1,"daily_streak":7}
GET
/servers/{guild_id}/stats
Returns aggregate server stats: total members with XP, total XP earned, average level, and curve config.
Example response
{"total_members":1240,"total_xp":48200000,"average_level":8,"xp_curve":"standard","xp_multiplier":1.0}
Rate Limits
100 req/hr
Free plan
1,000 req/hr
Starter plan
10,000 req/hr
Pro plan