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

sendReceiveTokenAddresses?: string[];
  • Defines a custom list of token addresses (Jettons) that should be available in the Send and Receive sections of the widget.
  • Use this when you want to set a unique pair of tokens that users can swap from or to.
createSwapWidget("#test", {
  sendReceiveTokenAddresses: [
    "EQAvlWFDxGF2lXm67y4yzC17wYKD9A0guwPkMs1gOsM__NOT", // SEND -> NOT
    "EQCl0S4xvoeGeFGijTzicSA8j6GiiugmJW5zxQbZTUntre-1" // RECEIVE -> CES
  ],
  otherConfig...
});
🚧 Warning — If you pass an invalid token address, the widget and pair will not render correctly.

​
limitedJettonLists

limitedJettonLists?: string[];
Provides a custom list of Jetton addresses that will be used to completely override the default token list in the widget. 
createSwapWidget("#test", {
  limitedJettonLists: [
    "EQC98_qAmNEptUtPc7W6xdHh_ZHrBUFpw5Ft_IzNU20QAJav", // tsTON
    "EQBa6Oofc4vQZ1XZLTYRkbX4qWUWBCf0sFBgo0kdxdlw6rqN", // M5
    "EQAvlWFDxGF2lXm67y4yzC17wYKD9A0guwPkMs1gOsM__NOT", // NOT
    "EQD0KpcRMh-sKO2z5-vOjgvFjTT58tO-2Nmvxqg5ocFQFtWz"  // FPIBANK
    // other token addresses ...
  ],
  otherConfig...
});
🛑 This setting completely replaces the default token list — use it when you want a hard limit on what’s shown.

​
Default Assets

By default, the widget always displays assets:
  • TON (Toncoin)
  • USDT (Tether USDT on TON)
  • CES (swap.coffee)
These are included automatically, even when no configuration is provided.

​
Search for Any Token

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.

​
enableCommunityTokens

enableCommunityTokens?: boolean;
Controls whether community tokens are included in the main token list. Defaults to true.
  • true (default): Community tokens are included in the main token list and mixed with whitelist tokens from swap.coffee
  • false: Only verified or imported tokens will be shown, excluding community tokens
createSwapWidget("#test", {
  enableCommunityTokens: false, // Only verified tokens
  otherConfig...
});
📝 Note — When disabled, users will only see tokens that have been officially verified or manually imported, providing a more curated token selection.