Customize which tokens are first visible and available in the widget.
You can control which tokens appear
in the widget UI by using the following optional parameters.
☝️ Important — All
tokens (Jettons)
passed to either parameter must be listed on swap.coffee to be recognized and rendered correctly in the widget.
sendReceiveTokenAddresses
Send
and Receive
sections of the widget.unique pair
of tokens that users can swap from or to.🚧 Warning — If you pass an invalid token address, the widget and pair will not render correctly.
limitedJettonLists
Provides a custom list of Jetton addresses
that will be used to completely override the default token list in the widget.
🛑 This setting completely replaces the default token list — use it when you want a hard limit on what’s shown.
By default, the widget always displays assets:
(Toncoin)
(Tether USDT on TON)
(swap.coffee)
These are included automatically, even when no configuration is provided.
Even if a token is not in the list, users can still discover it using the built-in token search.
✅ As long as the token is listed on swap.coffee, it can be found.
Customize which tokens are first visible and available in the widget.
You can control which tokens appear
in the widget UI by using the following optional parameters.
☝️ Important — All
tokens (Jettons)
passed to either parameter must be listed on swap.coffee to be recognized and rendered correctly in the widget.
sendReceiveTokenAddresses
Send
and Receive
sections of the widget.unique pair
of tokens that users can swap from or to.🚧 Warning — If you pass an invalid token address, the widget and pair will not render correctly.
limitedJettonLists
Provides a custom list of Jetton addresses
that will be used to completely override the default token list in the widget.
🛑 This setting completely replaces the default token list — use it when you want a hard limit on what’s shown.
By default, the widget always displays assets:
(Toncoin)
(Tether USDT on TON)
(swap.coffee)
These are included automatically, even when no configuration is provided.
Even if a token is not in the list, users can still discover it using the built-in token search.
✅ As long as the token is listed on swap.coffee, it can be found.