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 distribution campaign — either an on-chain token airdrop or off-chain gift-card codes. You choose who’s eligible (a points range, a saved view, a hand-picked list, or a raffle) and how the total is split (proportional to points, or an equal share). Token campaigns are deployed on Somnia (Mainnet 5031, Testnet 50312) and Base (Mainnet 8453, Sepolia 84532). See Campaigns.

​
Triggers

Triggers connect your application to the point system. You define a trigger key in the Triggers dashboard, then call the API from your app to credit points whenever that event occurs. Separately, Automations watch those points and queue qualifying wallets into a draft reward.