Optional Parameters

The parameters listed in this section are not required for getting started with the widget.

They exist to give integrators the flexibility of widget to their specific needs — such as setup and customizing referral fees, start jetton parameters, or configure limited liquidity sources list.

⚠️ Use these options only when necessary. By default, the widget works out of the box with minimal setup.

UI-Based Settings

ParameterTypeDescription
firstTokenAmountnumberPredefined first token amount shown on first load.
limitDcaVisibilitybooleanHides/show Limited&DCA related UI elements.

Token Properties

ParameterTypeDescription
sendReceiveTokenAddressesstring[]List of token addresses to be shown in the Send/Receive section only.
limitedJettonListsstring[]Custom list of token addresses (jettons) to restrict the widget UI to specific tokens.

Fee Logic

ParameterTypeDescription
widgetReferralstringPartneer referral tag. Needs to setup custom fee.
customFeeSettingsobjectOverride default fee logic.
customFeeSettings.percentage_feenumberPercentage fee in basis points (e.g., 3000 = 3%).
customFeeSettings.min_percentage_fee_fixedstringMinimum fee in nano-units (e.g., 500000000).
customFeeSettings.max_percentage_fee_fixedstringMaximum fee in nano-units (e.g., 4000000000).
customFeeSettings.fixed_feestringFixed fee in nanoton-units (e.g., 1000000000).

Liquidity Sources

ParameterTypeDescription
liquiditySourcesstring[]Fixed list of liquidity sources to be included in the dex routing.

Optional Parameters

The parameters listed in this section are not required for getting started with the widget.

They exist to give integrators the flexibility of widget to their specific needs — such as setup and customizing referral fees, start jetton parameters, or configure limited liquidity sources list.

⚠️ Use these options only when necessary. By default, the widget works out of the box with minimal setup.

UI-Based Settings

ParameterTypeDescription
firstTokenAmountnumberPredefined first token amount shown on first load.
limitDcaVisibilitybooleanHides/show Limited&DCA related UI elements.

Token Properties

ParameterTypeDescription
sendReceiveTokenAddressesstring[]List of token addresses to be shown in the Send/Receive section only.
limitedJettonListsstring[]Custom list of token addresses (jettons) to restrict the widget UI to specific tokens.

Fee Logic

ParameterTypeDescription
widgetReferralstringPartneer referral tag. Needs to setup custom fee.
customFeeSettingsobjectOverride default fee logic.
customFeeSettings.percentage_feenumberPercentage fee in basis points (e.g., 3000 = 3%).
customFeeSettings.min_percentage_fee_fixedstringMinimum fee in nano-units (e.g., 500000000).
customFeeSettings.max_percentage_fee_fixedstringMaximum fee in nano-units (e.g., 4000000000).
customFeeSettings.fixed_feestringFixed fee in nanoton-units (e.g., 1000000000).

Liquidity Sources

ParameterTypeDescription
liquiditySourcesstring[]Fixed list of liquidity sources to be included in the dex routing.