Skip to main content
Rewards lets you manage wallets, distribute points, configure leaderboards, and trigger rewards from your apps via API.

​
Concepts

​
Point system

A point system is the top-level container for your rewards program. Everything — wallets, points, rewards, triggers, leaderboard — lives inside one point system. You can create multiple point systems for different apps or seasons.

​
Wallet

A wallet is a user identified by their Ethereum address within a point system. Wallets accumulate points over time through events, and can claim rewards when eligible.

​
Points

Points are awarded to wallets via manual grants in the dashboard or automated triggers from your app via the API. Each point event records the amount, the event type, and the timestamp.

​
Rewards

A reward is a token distribution campaign. You define a total amount, eligibility rules (minimum points), and an allocation type. Rewards calculates each wallet’s share proportionally based on their points.

​
Triggers

Triggers connect your application to the point system. You define a trigger key in the Automation dashboard, then call the API from your app to credit points whenever that event occurs.