Documentation menu

Quantity rule

A Quantity rule grants a role to members who hold a number of tokens within a range. Use it for tiers.

Settings

Field Description
Network The EVM chain the contract is on
Contract address The NFT contract
Standard ERC-721 or ERC-1155
Minimum The smallest number of tokens that qualifies
Maximum Optional. The largest number that qualifies. Leave blank for no upper bound.
Token IDs Optional. Count only these IDs.
Role The Discord role to grant

How it is checked

NXT counts the member's tokens across all of their wallets, excluding blocked tokens, and passes when the count is at least the minimum and, if set, no more than the maximum.

Example: holder tiers

Role Minimum Maximum
Holder 1 4
Collector 5 19
Whale 20

With a maximum on the lower tiers, a member holds exactly one tier role at a time. Without maximums, a whale would hold all three roles.

When a member's count moves from one tier to another, NXT grants the new role and removes the old one in the same check.

Something unclear or out of date? Tell us at support@nxtnft.app.