Partner Fee Collectors

Configure and collect custom partner fees for Symbiosis cross-chain operations

Overview

Symbiosis automatically charges protocol-level cross-chain fees and deducts gas fees for intermediate chains during cross-chain operations. The fee withholding logic is described in Symbiosis & Fees

To support partner integrations, Symbiosis also provides dedicated fee collector contracts. These contracts allow partners to charge and collect custom partner fees in addition to standard Symbiosis protocol fees.

Partner fee collection is available through two types of fee collectors:

• General Fee Collector: used for all cross-chain operations except operations to and from the Bitcoin network. The contract is deployed on the Symbiosis chain (the protocol host chain).

• BTC Fee Collectors: used for operations to and from the Bitcoin network. The contracts are deployed on Ethereum, BNB chain, Rootstock, and Citrea.

How partner fee collection works

The general flow is:

1. The partner contacts Symbiosis to enable custom fee collection.

2. Symbiosis configures the partner fee recipient address, fee model, and fee value.

3. The partner includes the configured partnerAddress in the SwapRequestSchema when calling the Symbiosis API.

4. Symbiosis applies the configured partner fee during the cross-chain operation.

5. The partner checks and claims accumulated fees through the Partner dashboard or manually through the fee collector contracts.

If partnerAddress is not included in the swap request, no custom partner fee is collected for that operation.

Collector types

Symbiosis uses different fee collector contracts depending on the route type:

• Use the General Fee Collector for all non-BTC cross-chain operations.

• Use BTC Fee Collectors for operations to or from the Bitcoin network.

General Fee Collector

The General Fee Collector is used for all cross-chain operations except operations to and from the Bitcoin network.

The contract is deployed on the Symbiosis chain, which is the protocol host chain.

Fee Token

Fees collected through the General Fee Collector are accumulated in sTokens, such as sUSDC, sUSDT, sWETH, and other supported synthetic assets.

Symbiosis uses sTokens to facilitate cross-chain operations. Each sToken is a 1:1 pegged representation of an asset on its corresponding native chain and can be unwrapped back to that chain.

For more information, see: Symbiosis sTokens and Supported Chains

Fee Configuration

The General Fee Collector is administered by the Symbiosis team. To enable custom partner fee collection, partners must contact Symbiosis to configure:

• Fee recipient address (partnerAddress) — the address authorized to withdraw collected fees from the contract.

• Fee model — percentage-based, fixed amount, or a combination of both,

• Fee value — the actual percentage and/or fixed amount to be charged.

Collecting Fees

To apply the configured partner fee during cross-chain operations, the fee recipient address must be included as partnerAddress in SwapRequestSchema when calling the Symbiosis API.

If partnerAddress is omitted or empty, no custom partner fee is collected for that operation.

BTC Fee Collectors

BTC Fee Collectors are used for cross-chain operations to and from the Bitcoin network.

Unlike the General Fee Collector, BTC Fee Collectors are deployed on several EVM-compatible networks that support BTC-related routing.

BTC Fee Collectors are deployed on Ethereum, BNB chain, Rootstock, and Citrea.

Fee Token

Fees collected through BTC Fee Collectors are accumulated in syBTC.

syBTC is a 1:1 BTC-pegged token that can be exchanged on EVM-compatible networks or unwrapped back to native Bitcoin.

Fee Configuration

BTC Fee Collector contracts are administered by the Symbiosis team.

To enable custom partner fee collection for BTC routes, partners must contact Symbiosis to configure:

• Fee recipient address (partnerAddress) — the address eligible to withdraw collected fees from the contract.

• Fee model — percentage-based, fixed amount, or a combination of both,

• Fee value — the actual percentage and/or fixed amount to be charged.

Collecting Fees

To apply the configured partner fee during swaps to or from BTC, the fee recipient address must be included as partnerAddress in SwapRequestSchema when calling the Symbiosis API.

If partnerAddress is omitted or empty, no custom partner fee is collected for that operation.

Checking and Claiming Fees

Partners can check and claim collected fees in two ways:

• through the Partner dashboard

• manually through the fee collector contracts

Partner Dashboard

To check and claim fees through the Partner dashboard:

1. Go to https://explorer.symbiosis.finance/partners

2. Connect the wallet address that is used to collect fees.

3. Claim fees for each available token.

4. Burn sTokens through the Mint/Burn page: https://app.symbiosis.finance/bridge

5. Exchange or burn syBTC token to BTC on at the Swap page: https://app.symbiosis.finance/swap

Manual method

Partners can also interact with the fee collector contracts manually.

Fee Management Methods

To interact with the fee collector contracts the following methods can be used:

• collectedFees() – Returns the total fees collected.

• claimFee() – Withdraws accumulated fees to the configured payout address.

Fee Collector Contracts

General Fee Collector

General fee collector on the Symbiosis chain: address

Important:

Fees collected through the General Fee Collector are accumulated in approximately 120 synthetic assets, or sTokens, on the Symbiosis chain.

Partners may need to call the withdrawal method for each token type with accumulated fees.

After withdrawal, sTokens need to be bridged or unwrapped to their respective native networks if the partner wants to receive the native assets.

BTC Fee Collectors

BTC fee collector addresses:

• Ethereum: address

• BNB chain: address

• Rootstock: address

• Citrea: address