API Overview - Rewards

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

Method	Path	Description
`POST`	`/trigger`	Credit points via a named trigger
`GET`	`/leaderboard`	Ranked wallet list with points
`GET`	`/wallet`	Stats and rank for a single wallet
`GET`	`/rewards`	Available and claimed rewards
`GET`	`/activity`	Point event history

All requests require:

Authorization: Bearer rw_your_api_key