Back to setup guide

Gating examples

Six common rule shapes with the exact fields to fill in. Mix and match using AND / OR combinators on the group page.

Hold X amount of an ERC-20

Most common. Set a flat threshold in tokens.

Type
Token (ERC-20)
Asset address
0xYourTokenAddress…
Threshold mode
Amount
Threshold value
1000 (in tokens, not wei)

If your token has 18 decimals, enter 1000 to require 1000 whole tokens. The bot handles the wei conversion.

Hold $X worth of an ERC-20

Threshold scales with price. Useful when token price is volatile.

Type
Token (ERC-20)
Asset address
0xYourTokenAddress…
Threshold mode
USD value
Threshold value
5000 (USD)

Requires the token to have a price route configured (either accepted-token entry on the same chain, or a stablecoin pair on a known DEX). Without that, the rule fails-safe to no-pass.

Hold X% of total supply

For deflationary tokens or whale-only groups.

Type
Token (ERC-20)
Asset address
0xYourTokenAddress…
Threshold mode
Supply percent
Threshold value
0.5 (means 0.5%)

The bot reads totalSupply() each tick and calculates the absolute threshold from your percent.

Own an NFT from a collection

ERC-721 or ERC-1155, any token in the collection counts.

Type
NFT
Asset address
0xYourCollectionAddress…
Threshold mode
Amount
Threshold value
1 (any one NFT in the collection)

To require multiple NFTs, raise the threshold. Specific traits or rarity tiers aren't supported on-chain at the rule level. For trait-gating, use a separate ERC-721 contract per trait or require members to lock their NFT in a side contract that exposes a trait-aware balance.

Hold LP tokens (UniswapV2 / Pancake-style)

Members must hold pair tokens for the project's pool.

Type
LP V2
Asset address
0xPairAddress… (the pair contract, not the token)
Threshold mode
USD value
Threshold value
1000 (USD)

Threshold is calculated from the LP holder's share of the pool's reserves, priced via the pool's stablecoin side.

Uniswap V3 LP NFT positions

Members must hold an NFT-position with USD value above the threshold.

Type
LP V3
Asset address
0xPoolAddress… (the V3 pool, not the position-manager)
Threshold mode
USD value
Threshold value
5000 (USD)

The bot enumerates the wallet's V3 positions on the position-manager contract and sums any that point at this pool. Out-of-range positions still count toward the USD value at current price.

Anti-flipper: minimum holding age

Block wallets that just bought in. Add to any rule.

Type
(any rule above)
Min holding days
30

The clock starts at the wallet's first observed Transfer-in for that asset. Sells then re-buys reset the timer. Use 7 to 30 days for a soft anti-flipper, longer for stricter rooms.

Combining rules

Add multiple rules to one group, then pick a combinator on the group's detail page:

  • AND: members must pass every rule. Use for stacked requirements (token + NFT + holding age).
  • OR: members pass if any rule passes. Use for "tier" setups where holding the token or an NFT is enough.
  • PAID_ONLY: ignore token rules entirely. Only paid-membership counts.
  • TOKEN_ONLY: ignore the paid membership. Token rules only.

No more freeloaders. Starting today.

Seven days of Pro, on us. No card. Your first gated group is live in five minutes.