User Tier API

Build engaging gamification systems with tier levels, task rewards, and progression tracking

Overview

The User Tier API enables you to create and manage a comprehensive gamification system within the NYYU platform. Build tier-based progression with customizable task rewards that encourage user engagement and platform interaction.

Core Types

Tier

🏆

Tier Type

Represents a user tier level in the gamification system

type Tier {
  level: Int!
  name: String
  point: Float
  svg: String
}

Identification

level - Unique tier identifier (1-5)

name - Display name (e.g., Bronze, Gold)

Requirements

point - Points needed to reach tier

svg - Visual badge/icon content

Tier Level Examples

📊

Standard Tier Progression

Typical tier structure for user advancement

Bronze Tier

Entry level - 0-1000 points

Silver Tier

Intermediate - 1000-5000 points

Gold Tier

Advanced - 5000-15000 points

Platinum Tier

Expert - 15000-50000 points

Diamond Tier

Elite - 50000+ points

Task System Types

WalletTask

💰

WalletTask Type

Deposit-based reward configuration

type WalletTask {
  amount: Int!
  point: Float!
}

amount

Deposit amount threshold (e.g., $100)

point

Points awarded for this deposit

WalletTaskInput

📝WalletTaskInput (Input Type)

input WalletTaskInput {
  amount: Int!
  point: Float!
}

Used when configuring wallet task rewards in task settings

StakeTask

🔒

StakeTask Type

Staking-based reward configuration

type StakeTask {
  expiredTime: Int!
  ratio: Float!
}

expiredTime

Staking duration in days (e.g., 30)

ratio

Point multiplier (e.g., 1.5x)

StakeTaskInput

📝StakeTaskInput (Input Type)

input StakeTaskInput {
  expiredTime: Int!
  ratio: Float!
}

Used when configuring staking task rewards in task settings

TaskSetting

⚙️

TaskSetting Type

Comprehensive task reward configuration

type TaskSetting {
  id: Int!
  verification: Float
  wallet: [WalletTask]
  auction: Float
  direct: Float
  staking: [StakeTask]
}

One-time Tasks

verification - Email/KYC verification points

auction - Auction participation points

direct - Direct purchase points

Repeatable Tasks

wallet - Deposit reward tiers

staking - Staking reward multipliers

TaskSettingInput

📝TaskSettingInput (Input Type)

input TaskSettingInput {
  verification: Float!
  wallet: [WalletTaskInput]!
  auction: Float!
  direct: Float!
  staking: [StakeTaskInput]!
}

Used when creating or updating task reward settings

Task Type Examples

🎯

Sample Task Configuration

Common reward structures

Verification Tasks

One-time completion rewards

• Email verification: 10 points

• KYC completion: 50 points

Wallet Deposit Tiers

Graduated rewards for deposits

• $100 deposit: 10 points

• $500 deposit: 75 points

• $1000 deposit: 200 points

Trading Activities

Engagement rewards

• Auction participation: 5 points per bid

• Direct purchase: 2 points per transaction

Staking Bonuses

Time-based multipliers

• 30-day stake: 1.5x multiplier

• 90-day stake: 2.0x multiplier

• 180-day stake: 3.0x multiplier

Key Features

🎮

Gamification System

Create engaging tier-based progression with customizable levels and rewards

🎁

Flexible Rewards

Configure points for various activities: deposits, trading, staking, and verification

📈

User Progression

Track user advancement through tier levels with point accumulation

🏅

Visual Badges

Display SVG badges for each tier level to showcase user achievements

Use Cases

💡

Implementation Scenarios

Common ways to leverage the tier system

User Retention

Encourage continued platform usage with tiered benefits and exclusive features for higher tiers

Behavioral Incentives

Reward specific actions like deposits, trading, and staking to drive desired user behaviors

Loyalty Programs

Build long-term user loyalty with progressive rewards and tier-based privileges

Community Engagement

Foster competitive participation through visible tier rankings and achievement badges

Get User Tiers

Retrieve all tier configurations

Add New Tier

Create new tier level (Admin)

Update User Tier

Modify tier configuration (Admin)

Delete User Tier

Remove tier level (Admin)

Add Task Setting

Create task reward settings (Admin)

Update Task Setting

Modify task rewards (Admin)

🚀

Ready to build your gamification system?

Explore our tier and task management documentation to create engaging user progression

User Tier API Overview