Help & Support

User Rewards

Learn about Lens Account rewards and token distribution.

Lens rewards active accounts with GHO tokens through our Smart Token Distributor: a data-driven, adaptive system that optimizes user engagement, retention, and economic participation in the decentralized ecosystem.

How It Works

The Smart Token Distributor uses a combination of heuristics, machine learning, and reinforcement learning to allocate tokens fairly and strategically. The system evaluates users across multiple dimensions:

  • Contributors: Accounts who interact frequently (likes, comments, tips, collects)

  • Verified Accounts: Authentic accounts filtered by ML models to exclude spam and bots

  • Creators: Accounts who receive meaningful engagement on their content

  • Influencers: Accounts with strong network connections and social influence

  • Financially Active Accounts: Accounts with significant on-chain financial participation

  • Engaged Accounts: Accounts who engage regularly over time

The distributor calculates a composite score based on:

  • Contributor Score: Measures ecosystem engagement through interactions

  • Creator Score: Rewards valuable content generation and quality engagement received

  • Consistency Score: Ensures sustainable, long-term participation

  • Wallet Score: Considers financial participation and staking activity

Fetch Account Rewards

You can fetch the token distributions received by the logged-in Account using the tools below.

Use the useTokenDistributions hook to fetch rewards from token distributions.

const { data, loading, error } = useTokenDistributions(request);

Token distributions can be fetched only by the logged-in user Account.

Example
import { useTokenDistributions, evmAddress } from "@lens-protocol/react";
// …
const { data, loading, error } = useTokenDistributions();
if (loading) {  return <p>Loading…</p>;}
if (error) {  return <p>{error.message}</p>;}
// data: {items: Array<TokenDistribution>, pageInfo: PageInfo}

Continue with the Pagination guide for more information on how to handle paginated results.