loyalteez_get_user_stats
Retrieve a user's balance, lifetime earnings, streak, activity, and rank by providing their platform and user identifier.
Instructions
Get comprehensive stats for a single user including balance, lifetime earnings, streak, activity, and rank.
Implementation Note: User stats aggregate data from multiple services. If the aggregation endpoint is unavailable, stats can be obtained by calling:
loyalteez_get_streak_statusfor streak dataloyalteez_get_leaderboardfor rank and lifetime earningsloyalteez_get_user_balancefor balancePlatform-specific APIs for activity (messages, voice, reactions)
See also: loyalteez://docs/shared-services/leaderboard-service
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"userIdentifier": "<userIdentifier>",
"platform": "<platform>"
},
"name": "loyalteez_get_user_stats"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brandId | No | Your brand wallet address. If not provided, uses LOYALTEEZ_BRAND_ID environment variable. | |
| platform | Yes | Platform: "discord" | "telegram" | "web" | etc. | |
| userIdentifier | Yes | User identifier (platform_userId@loyalteez.app or email) |