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

# Referrals

> Take a share of the volume you send. Two fields on the quote, no sign-up.

## Fields

| Field            | Value                                                        |
| ---------------- | ------------------------------------------------------------ |
| `referralWallet` | The address the share is paid to, valid on the source chain. |
| `referralBps`    | Your rate, `0` to `15`.                                      |

Both or neither. They go on `POST /bridge/quote` and follow the decision through `POST /bridge/build`.

Your share is charged on every transfer you refer, including one on which Bridg itself charges nothing, and is capped at \*\*$10** per transfer, converted into the source asset at Bridg's price for it. The platform's own $10 cap is separate. `fees.referral.amountAtomic` is the capped amount.

```json theme={null}
{
  "fromChain": "base",
  "toChain": "solana",
  "fromToken": "USDC",
  "toToken": "USDC",
  "amountAtomic": "100000000",
  "sender": "0x1111111111111111111111111111111111111111",
  "recipient": "So1anaRecipient1111111111111111111111111111",
  "referralWallet": "0x2222222222222222222222222222222222222222",
  "referralBps": 10
}
```

The share is paid on the source chain, so the wallet must be valid for that chain's VM. An EVM address on a route leaving Solana is `400 invalid_referral_wallet`; a rate outside `0` to `15` is `400 invalid_referral_bps`. If you refer traffic on more than one chain family, hold one wallet per family.

## Disclosure

The share is shown next to the platform fee, in the same asset, before signing:

```json theme={null}
"fees": {
  "platform": { "bps": 5,  "amountAtomic": "50000",  "asset": "0x8335…02913", "tierSavedBps": 54 },
  "referral": { "bps": 10, "amountAtomic": "100000", "asset": "0x8335…02913", "wallet": "0x2222…2222" }
}
```

`referral: null` means no referrer was named. `platform: null` beside a non-null `referral` is an ordinary outcome: the route saved the user too little for a platform fee, and your share is still paid.

## Settlement

Your share is charged on top of the platform's and paid straight to your wallet in the same signature: an instruction inside the venue's Solana transaction, or a `fee` step beside the EVM bridge call. Nothing is forwarded later. The one case it is not taken is a source chain Bridg has no fee wallet on, where neither cut can be collected.

Each fee is a row in the transfer's `fees` list on `GET /bridge/transfers/{id}`:

| `status`   | When                                                               |
| ---------- | ------------------------------------------------------------------ |
| `offered`  | A `fee` step was built and not yet signed.                         |
| `expected` | The charge is inside a signed transaction.                         |
| `settled`  | The transfer completed. `txHash` is the transaction that paid you. |
| `void`     | The transfer refunded or failed, or the fee step was never signed. |