Skip to content
NoetherDocs

Referrals

Create an on-chain referral code, share your link, bind referees, and claim your 10% share of their trading fees in USDC while they save 4% on every trade.

Noether has an on-chain referral program. This page shows you how to create your referral code, share it, how referees bind to it, and how the fee share and the referee discount are paid.

How the program works

RoleWhat you doWhat you get
ReferrerRegister a code, share your link10% of every trading fee your referees are charged, claimable in USDC
RefereeOpen a share link and bind the code4% off the fee on every trade

Everything settles on-chain:

  • Codes are on-chain. Registering a code is a Stellar transaction owned by your wallet.
  • Bindings are on-chain and permanent. Once a wallet binds to a code, you cannot rebind it to another one. You also cannot bind to your own code.
  • One wallet, one code. Each wallet can register exactly one referral code, and it cannot be changed later.
  • Fees are split on-chain. When the market charges a referee a fee, it takes 4% off and credits 10% of the original fee to the referrer's claimable balance in the same transaction. There is no off-chain accounting.
How a referral pays out A referrer creates a code and shares the link, the referee binds to it once, and on every referee trade the market asks the referral registry for the split, charges the referee 4% less, sends 10% of the original fee to the registry as USDC, and the referrer claims it. CREATE CODE SHARE LINK BIND CODE OPEN TRADE RECORD_TRADE 4% / 10% PAYOUT USDC CREDIT CLAIM USDC Referrer owns a code Referee binds once Registry referral_v1 Market fee path LEGEND Holds the split Call Return Off-chain Payout
The discount and the payout are both computed on the original fee, in the same transaction as the trade. Open full size (opens in a new tab)

Create your code

You only need a connected wallet, no sign-in or API key.

Open the Referrals page

Go to Referrals in the top navigation on testnet.noether.exchange, and connect your wallet if you have not (see Getting started).

Pick a code

In the "Register your referral code" card, enter a code of 3 to 16 characters using letters, numbers, underscores and hyphens. Codes are case-sensitive. When you click away from the field, the page checks availability against the chain, so you see "available" or "already taken" before you submit.

Sign the transaction

Click Register code and approve one wallet signature. Your code is now recorded on-chain and permanent. The dashboard may show zeroed stats for a few seconds while the indexer catches up.

The registry can require a minimum 14-day trading volume before a wallet may register a code; it is currently set to zero, so any wallet can register.

The "Share your code" card gives you two copy buttons, one for the bare code and one for the full link. The link format is:

https://testnet.noether.exchange/?ref=YOURCODE

Any Noether page URL with ?ref=YOURCODE appended captures the code, but the generated link points at the home page.

What your referee sees

When someone opens your link:

  1. The code is saved in their browser and a floating "Referral invitation" card appears, showing the code, your (the referrer's) address and how many others have joined.
  2. They click "Bind referral code" (or "Connect wallet to bind" first) and approve one wallet signature. That is the on-chain binding.
  3. After binding, the Referrals page confirms which code they were referred by.

If they dismiss the card, the code is not lost: it is parked in their browser, and the Referrals page shows a "Have a referral code?" card pre-filled with it so they can bind later. Opening a fresh referral link brings the card back.

Binding is permanent

A wallet that has bound to a code cannot switch to a different referrer, so referees should bind to the code they actually want to support.

Earnings and the fee discount

  • Referees get 4% off the trading fee on every trade: a discount of 4% of the fee, not 4% of the trade.
  • Referrers earn 10% of each referee fee, measured before the referee's discount, accruing to a claimable on-chain balance.

For example, a $1,000 market open at the base taker rate of 0.050% carries a $0.50 fee. A referee pays $0.48, and their referrer earns $0.05.

Both rates apply to trading fees (see fees on the trading page) and are set on the referral contract. Because everything runs on testnet today, the fees, and therefore your referral earnings, are test USDC.

Claiming

The "Claim earnings" card on the Referrals page shows your claimable balance. When it is above zero, click Claim and approve one wallet signature; the registry pays the balance to your wallet in USDC and the card confirms the amount claimed. There is no minimum and no schedule: claim whenever you like.

Tracking your referrals

  • No sign-in is needed for the basics: your code, share link, the number of wallets bound to your code, the volume they generated, your total earned and your claimable balance are visible with just a connected wallet.
  • The collapsible "Advanced — full dashboard" section (trade-by-trade earnings and claims tables) requires a one-time wallet sign-in: you sign a challenge, and no funds move. During the closed beta this dashboard is limited to allowlisted wallets; if yours is not on the list yet, you see a closed-beta notice, and everything else on the page keeps working.

Quick reference

ItemValue
Code length3 to 16 characters
Allowed charactersLetters, digits, _, - (case-sensitive)
Codes per wallet1, permanent
Binding1 wallet signature, permanent, no self-referral
Referee discount4% of each trading fee, applied on-chain
Referrer share10% of each referee fee before the discount, claimable in USDC
ClaimingOne signature, any time the balance is above zero
Share linkhttps://testnet.noether.exchange/?ref=YOURCODE

Questions about edge cases? Check the FAQ. Building on the program instead? See the referral REST endpoints.

On this page