Referral fees
Add referrer_id=<your account> to your requests. DEXs that support referrals get your account in their swap calls. Without it, the aggregator’s own account dex-aggregator.intear.near is used.
Every DEX handles referrals differently:
| DEX | Tracking | Fees | Setup |
|---|---|---|---|
| Rhea | ✅ | Share of protocol fees | Manual approval by Rhea |
| Aidols | ✅ | Share of protocol fees, in wNEAR | None |
| Plach | ✅ | Your own fee, up to 5% | Configure with the manage CLI |
| Rhea DCL, staking, Wrap | ❌ | ❌ | — |
Rhea (classic pools, not DCL) needs manual approval from the Rhea team to pay referral fees. Approved referrers get 20% of the protocol fee, which is 20% of the pool fee. For $1,000,000 of volume in a pool with a 0.3% fee, that’s about $120, paid as LP shares of the pool.
Without approval, referrer_id still works for tracking: every trade in the Intear API has a referrer field, filled in whether the referrer is approved or not.
Aidols
Section titled “Aidols”No approval needed. On every trade, the referrer gets 1% of the protocol fee, sent as wNEAR. The protocol fee is the larger of 0.01 NEAR and 1% of the trade. For $1,000,000 of volume that’s about $100, or more if you have many small trades where the 0.01 NEAR minimum applies.
Works for tracking with no setup. You can also charge your own fee, up to 5%, using the manage CLI:
# 1% (10000) on all pairs, 0.1% (1000) on pairs where both assets are "stable"manage xyk referrers set-settings alice.near 10000 1000“Stable” assets include NEAR, wNEAR, stablecoins and other stable tokens. The list may change and is decided by Intear.
The fee goes to your Plach fees account. It’s only charged in assets you registered, so register every asset you expect to receive:
manage xyk referrers register-fee-assets alice.near nep141:wrap.near near nep141:usdt.tether-token.nearThe fee is usually taken from the input token. In Launch pools it’s always taken in NEAR.