Overview
Token rewards let a loyalty rule pay an on-chain token amount directly into the user’s wallet on rule completion. The token is either:- A custom ERC-20 — you pick the token contract (e.g. FLOW, USDC, your project token).
- The chain native token — ETH on Ethereum/Base/Arbitrum/Optimism, MATIC on Polygon, BNB on BNB Chain, FTM on Fantom.
- A “mint NFT” rule that grants $50 in FLOW (ERC-20).
- A “10k impressions” rule that grants
0.01ETH (native). - A quest chain that grants $5 in USDC on the final step (ERC-20).
Requirements at a glance
Before a token-reward rule can pay out, all of these must hold:| Requirement | Why |
|---|---|
| Pro plan | Token rewards are gated to Pro and above; rejected at create and at run time otherwise. |
| A relayer on a supported chain | Payouts go out from a relayer. Only chains in the table below are supported. |
| For a custom token: the contract added on the relayer’s chain | The ERC-20 you pay out must be added as a contract on the same chain as the relayer. |
| Relayer holds the reward token | The relayer is the funding source — it must hold enough of the ERC-20 (or native token) to cover payouts. |
| Relayer holds native gas | Every payout is an on-chain transaction. The relayer needs the chain native token for gas, on top of the reward balance. For native-token rewards the native balance must cover both the reward and the gas. |
Multipliers do not apply to token rewards
Loyalty multipliers scale point-based earnings. They do not apply to token rewards. The amount you set on a token rule is the exact on-chain amount paid out; no multiplier inflates it. If you want a higher payout, set the higher amount directly on the rule.Supported chains
| Chain | Native token |
|---|---|
| Ethereum mainnet | ETH |
| Optimism | ETH |
| BNB Chain | BNB |
| Polygon | MATIC |
| Fantom | FTM |
| Base | ETH |
| Arbitrum | ETH |
Payout is asynchronous — it takes time
Token rewards are on-chain, so they are not instant. The user is credited the moment they complete the rule, but the actual transfer to their wallet is submitted shortly after as an on-chain transaction. The completion screen shows “It may take a few minutes to appear in your wallet.” — expect up to ~5 minutes under normal conditions, longer if the chain is congested or the relayer is low on gas. Token rewards show up on leaderboards, in balances, and in reward history just like any other currency.Fractional amounts
You can reward fractional amounts (e.g.0.5 USDC or 0.01 ETH). The amount you enter is the human value of the token — decimals are handled for you, so 0.5 pays out half a token, not half a smallest-unit.
Configuration
In the rule form:- Pick Tokens in the reward-type toggle.
- Pick a Relayer — filtered to relayers on a supported chain.
- Pick a Token — either a custom contract (filtered to the relayer’s chain) or the relayer chain’s native token.
- Set the amount per completion (
0.01minimum). The form shows the relayer’s live balance and the USD value of the entered amount, with a sufficient/insufficient indicator so you can confirm the relayer can fund the reward before saving.