'Mode': How to specify the send or receive amount

When creating a bridge+swap transaction via the POST/bridge/quote/bridge-swap/user endpoint or via the SDK https://docs.rhino.fi/sdk/bridge-and-swap it is possible to specify whether the user will send a specific amount, and have the quote provide information on what amount they will receive, or to specify what the user wants to receive, and have the quote provide information on what amount they should send.

The options for the mode parameter are:

• Pay

• Receive

These are coupled with the amount parameter within the request body.

When "pay" is used within the mode, the amount represents the value on the chainIn which the depositor will send, and the quote will calculate what value will be received by the recipient on the chainOut .

When "receive" is used within the mode, the amount represents the value on the chainOut which the recipient should receive, and the quote will calculate what value the depositor must send on the chainIn .

User Case One

Pay Mode: A neobank deposit flow where the user inputs the amount they want to deposit in their source chain and token, and the information shown to them is how much will be received into their account on the destination chain and token.

Request Body

{
  "chainIn": "ETHEREUM",
  "chainOut": "SOLANA",
  "amount": "100",
  "mode": "pay",
  "tokenIn": "USDC",
  "tokenOut": "USDT",
  "depositor": "0x123...XYZ",
  "recipient": "0x987...ABC",
}

Response Body

{
  "_tag": "bridgeSwap",
  "chainIn": "ETHEREUM",
  "chainOut": "SOLANA",
  "payAmount": "100",
  "payAmountUsd": 100,
  "receiveAmount": "99.64",
  "receiveAmountUsd": 99.64,
  "fees": {
    "fee": "0.36",
    ....
    }
  },
  "tokenIn": "USDC",
  "tokenOut": "USDT",
  "depositor": "0x123...XYZ",
  "recipient": "0x987...ABC",
  "expiresAt": "2026-08-28T09:37:00Z",
  "quoteId": "165hfuf87dfjidf9",
  "flowCredits": 123,
  "speed": "fast",
  "estimatedDuration": 5000,
}

User Case Two

Receive Mode: A checkout provider showing the amount which the user must send on their desired chain:token, to ensure that onchain costs are covered for the supplier to receive the exact amounts of the goods/services in their desired chain:token.

Request Body

{
  "chainIn": "BASE",
  "chainOut": "AVALANCHE",
  "amount": "75.99",
  "mode": "receive",
  "tokenIn": "USDC",
  "tokenOut": "USDT",
  "depositor": "0x456...FGH",
  "recipient": "0x357...DYB",
}

Response Body

{
  "_tag": "bridgeSwap",
  "chainIn": "BASE",
  "chainOut": "AVALANCHE",
  "payAmount": "76.41",
  "payAmountUsd": 76.41,
  "receiveAmount": "75.99",
  "receiveAmountUsd": 75.99,
  "fees": {
    "fee": "0.42",
    ....
    }
  },
  "tokenIn": "USDC",
  "tokenOut": "USDT",
  "depositor": "0x456...FGH",
  "recipient": "0x357...DYB",
  "expiresAt": "2026-08-28T09:37:00Z",
  "quoteId": "165hfuf87dfjidf9",
  "flowCredits": 123,
  "speed": "fast",
  "estimatedDuration": 5000,
}