Challenges & Streaks

Encourages daily learner retention through streak milestones, quest objectives, and reward multipliers.

Daily Challenges & Active Streaks

Streak Mechanics

Daily Check-in: Completing at least 1 lesson per calendar day maintains the user’s active streak.
Streak Freeze: Users can spend gems to purchase streak freezes to protect their streak during inactive days.
Milestone Rewards: Reaching 7-day, 30-day, and 100-day streaks unlocks milestone gems and NFT badges.

Get Active Challenges

Endpoint

GET /api/v2/challenges

Headers

Authorization: Bearer <jwt_access_token>

Response (200 OK)

{
  "success": true,
  "data": {
    "currentStreak": 5,
    "longestStreak": 14,
    "challenges": [
      {
        "id": "challenge-daily-1",
        "title": "Complete 2 Lessons",
        "progress": 1,
        "target": 2,
        "rewardXP": 100,
        "rewardGems": 10,
        "isClaimed": false
      },
      {
        "id": "challenge-battle-1",
        "title": "Win 1 Quiz Battle",
        "progress": 1,
        "target": 1,
        "rewardXP": 150,
        "rewardGems": 15,
        "isClaimed": true
      }
    ]
  }
}