HollaEx®
⚙️ DashboardStart →
  • HollaEx® — The Crypto Exchange Solution
  • ☁️Cloud Operators
    • Launching the Exchange
    • Setting Domain for Cloud Exchanges
    • Easy SMTP for Cloud Exchanges
    • SEO Settings for Cloud Exchanges
      • SEO Advanced Settings
  • ⚙️Operating Your Exchange
    • Operator Control Panel
      • General
      • Users
      • User Profile
      • Assets
      • Markets
      • Stakes
      • Sessions
      • Plugins Apps
      • Trading Fees & Account Tiers
      • Roles
      • Chat
      • Billing
    • Customize Exchange
      • Browser Tools
        • Enter Edit Mode
        • Operator Controls (Visuals)
        • Console
      • Plugins
      • Forked Repo
    • Fiat Controls
      • Initial Setup
      • Setting Up Fiat On/ Off Ramp
      • Editing Deposit & Withdrawal Fees
      • Users Making Fiat Deposit
      • Users Trading With Fiat
      • User Making Fiat Withdrawal
    • Staking
    • OTC Broker
    • P2P
      • P2P Overview
      • P2P Setup
      • P2P Troubleshooting
      • P2P Vendor Flow
    • Smart Chain Trading
    • Assets & Trading Pairs
      • Add New Assets & Trading Pairs
      • Configure Pair Parameters
    • Set up the SMTP Email
      • Set up SMTP with AWS SES
      • Set up SMTP with Mailgun
      • Set up SMTP with SendGrid
      • Test the SMTP with Gmail
    • Enabling reCAPTCHA
    • Email Customization & Audit
    • DeFi Asset Staking Process
  • 🧩Plugins
    • HollaEx Plugins
      • Announcements
      • Bank
      • AWS SNS (Text Messages - SMS)
      • KYC
      • Automatic KYC
      • Messente
      • Advanced Referral
      • CoinMarketCap
      • Guardarian
    • Install Plugins
    • Developing Plugins
      • Development Walkthrough: Hello-Plugin
        • Initialization
        • Configuration
        • Scripting
        • Web View
        • The Final Product & Installation
      • Advanced
        • Initialization
        • Config
        • Server Script
        • Plugin Libraries
        • Web View
        • Final Plugin Product
        • Advanced Tutorial: Using the user meta field
        • Advanced Tutorial: Adding a new database table column
        • Advanced Tutorial: Creating a new database table
      • Simple Wallet Example
      • Web View Development
        • Overview
        • External dependencies
        • Getting started
        • Basic Tutorial: Hello Exchange Plugin web view
        • Advanced Tutorial: KYC Plugin web views
    • Bank Integration
      • Handling Deposits
      • Handling Withdrawals
  • 👷Developers
    • API Guide
      • API Example Scripts
    • Run Dev Mode
    • Build a New Front-end Interface
  • 🧰On-Premise Operators (Advanced Only)
    • On-Premise Exchange Setup
      • Getting Started — Requirements
      • Installation
      • Server Setup
      • Web Setup
      • Production
    • CLI How-Tos
      • Start Exchange
      • Stop Exchange
      • Upgrade Exchange
        • Build and Apply the Code Changes
      • Get Exchange Logs
      • Get a Backup and Restore
      • Exchange Migration
      • Command List
    • Run Exchange on Kubernetes
    • Troubleshooting Guide
  • 🚀Advanced
    • SEO Optimization
    • Nginx
    • Rate Limits
    • Database
      • Upgrade Database
    • Dependencies
    • Contents Delivery Network
      • Cloudflare CDN for HollaEx
      • CloudFront CDN for HollaEx
    • Load Balancer
      • AWS ELB
      • DigitalOcean LB
    • Customize Kubenretes Ingress
    • Exchange Keys
      • Exchange API Keys Troubleshoot
    • HollaEx on non-Linux
      • HollaEx on Windows
      • HollaEx on macOS
    • The Network Tool Library
      • Accessing the Network Tool Library
      • Functions
        • WebSocket
      • Simple Example: Creating a User and Wallet
      • Getting More Interesting: Orders with the Tools
        • Setup: Using the transferAsset function
        • Creating and Monitoring a Sell Order
        • Settling Fees
      • Private HollaEx Network
    • Docker Content Trust (DCT)
    • Revenue Sharing
  • 📦Releases
    • Release Notes
    • Side Notes
  • ➡️External Links
  • Blogs
  • Forum
  • Videos
  • Twitter X
  • Telegram
  • Interactive Demo
  • Discord Community
  • API Documentation
  • Tools Library Documentation
  • Node Library Documentation
  • Plugins Documentation
Powered by GitBook
On this page
  • Available To
  • What Is It?
  • Who Needs It?
  • How to Use It?
  • Example
  1. Plugins
  2. HollaEx Plugins

Advanced Referral

The Advanced Referral is an easy to setup, but powerful plugin that will encourage our users to bring in even more users and get them trading, and reward them all automatically

Available To

Available to:

  • Cloud Plans:

    • Crypto Pro

    • Enterprise

  • On-Premise Plans:

    • Boost

    • Voyager

For a one-time cost of $2,500

What Is It?

The advanced referral plugin automates rewarding users for referring new users to your exchange, encouraging your current user base to help build your exchange.

Users who refer others can earn a percentage of the trading fees generated by the referred users they onboarded. The exact percentage amount is left to you as a user.

Who Needs It?

Operators who want to encourage users to help build their exchange's user base, making them feel rewarded and valued for their contributions to the community.

How to Use It?

After installation, there are a handful of factors to decide in the configuration screen

Here referrer is the user who was on the exchange originally and sent their link to another person who signed up, the referee.

Public

  • earning_rate: The percentage of Orderbook trading fees that the referee generates that will be sent to the referrer.

  • earning_period: How long after the referee signs up, that the referrer will receive the above percentage from fees. Setting this to 0 will mean that there is no expiry date.

  • earning_interval: This box allows defining when all the settled referee fees, will be sent to all the relevant referrers. Three valid entries are possible:

    • Month: Fees are settled every first day of the month at midnight.

    • Week: Fees are settled every Sunday at midnight.

    • Day: Fees are settled every day at midnight.

Private

  • distributor_id: This is the account in which every earning_interval will have the total amount of calculated fees taken from it, and then distributed to all relevant referrers. In most cases, this account will match the exchange wallet in which exchange-wide fees are settled to. Ensure this is topped up such that referrers receive their rewards.

Example

Consider a simple example with the settings above. On my exchange, I have two referrers who both referred a single referee:

  • Homer - Who sent his invite link to:

    • Bart - Who traded $10,000 USD worth in his first week

  • Marge - Who sent her invite link to:

    • Lisa - Who traded $20,000 USD worth in her first week

In all trades let's imagine a 0.1% trading fee in all trades.

This would mean Bart and Lisa generated $30 in fees this week. In the case of a Crypto Pro exchange, 25% of this would go to HollaEx as part of revenue sharing, leaving $22.50 on the exchange.

With the Earning Rate set at 25%, $7.50 would be split between Homer and Marge. Homer will receive $2 worth of relevant assets and Marge will receive $5 due to the difference in the volume of their referees.

The leftover $15 (+ all over fees on the exchange) can be settled at any time in the Earning tab of the operating controls to the chosen account, likely the admin account with ID 1, so that I can ensure my referrers always receive their rewards.

This will be paid out from Account ID 1's (the admin) wallet (in the relevant assets) due to the chosen Distributor ID, at midnight every Sunday (due to the Settlement Interval).

This process will repeat for whatever amount of assets Bart and Lisa trade for until 3 months after they have signed up, at which point Homer and Marge will no longer get a cut of Bart and Lisa's trading fees due to my set Earning Interval.

PreviousMessenteNextCoinMarketCap

Last updated 4 months ago

🧩