> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gabox.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# Referrals and earnings

> Who receives the pack fee, and how fees are claimed

Refer friends and earn up to 20% of their Gabox fees.

## Where the pack fee goes

Every pack pays a 0.50% pack fee, inside its price. Where it goes depends on the buyer:

| Buyer | Before graduation | After graduation |
| - | - | - |
| Has a referrer | 0.20% of the price to the referrer, the rest to Gabox | 0.20% of the price to the referrer, the rest to Gabox |
| Has no referrer | Gabox | The machine's [Mega Pack](https://docs.gabox.fun/mega-pack.md), when it is on for the quote token; otherwise Gabox |

The creator gets no pack fee on their own machine. A creator earns pack fees only as somebody else's referrer. A [Fan coin machine](https://docs.gabox.fun/fan-coin-machines.md) is the exception: its 2% pack fee pays its creator 1.20%, the referrer 0.30% and Gabox 0.50%. With no referrer, the creator also gets the referrer's 0.30%.

## How a referral is bound

* A buyer can name a referrer on a purchase while they have none yet.
* The first valid referrer is bound to the buyer's wallet for ever, across every machine.
* A buyer cannot refer themselves.
* After that, the link cannot change. A purchase that names a different referrer fails, so the app does not send one.
* The buyer pays the same price with or without a referrer. The buyer pays the small rent of the new link account.

## Claiming pack fees

Pack fees collect per wallet and per quote token in an earnings account. The fee tokens wait in a shared fee account for that quote token.

* `claim_earnings` pays **all** unclaimed fees of one quote token to the wallet. A wallet that earned in two quote tokens claims twice.
* A SOL claim arrives as SOL.
* Creator pack fees from the earlier fee model also stay claimable this way.
* Nobody can claim a Mega Pack balance with `claim_earnings`. It is only paid out to the coin's holders.

## Creator earnings

On a new-coin machine, a creator earns from trading, not from packs:

| Market | Creator's part of each trade | Where it is claimed |
| - | - | - |
| Bonding curve | 0.96% (0.495% on older coins) | Meteora's creator fee for the coin |
| DAMM v2 pool | about 0.72% (about 0.25% on older coins) | Fees of the creator's locked pool position |

Older coins are coins launched before 29 October 2026. A coin keeps the fees it launched with.

These fees are held by Meteora, outside Gabox's `claim_earnings`. The app's **Creator earnings** panel collects them for you. Trading fees depend on trading that may never happen.

On a [Machine recharge](https://docs.gabox.fun/machine-recharge.md) machine, the machine receives these fees. All or part of them refill its prize pool. The creator claims the rest on their profile.

See [What a pack costs](https://docs.gabox.fun/what-a-pack-costs.md) for the full fee table.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.