Skip to main content
Rewards exposes a REST API that lets your applications credit points, read leaderboards, query wallet stats, and surface rewards — all authenticated via API keys scoped to specific point systems.

​
Quick example

curl https://api.rewards.so/trigger \
  -X POST \
  -H "Authorization: Bearer rw_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "triggerKey": "craft_artifact",
    "walletAddress": "0xabc123...",
    "pointSystemId": "your-point-system-uuid"
  }'

{
  "success": true,
  "pointsAdded": 10,
  "triggerKey": "craft_artifact",
  "walletAddress": "0xabc123..."
}

​
Endpoints

MethodPathDescription
POST/api/sdk/triggerCredit points via a named trigger
GET/api/sdk/leaderboardRanked wallet list with points
GET/api/sdk/walletStats and rank for a single wallet
GET/api/sdk/rewardsAvailable and claimed rewards
GET/api/sdk/activityPoint event history
All requests require: 
Authorization: Bearer rw_your_api_key