Format: JmApi.swapWidget(elementId, options);

In this case iframe element must be created in HTML. You need to pass elementId to the function and it will attach to the correct element.

Format: JmApi.createSwapWidget(element, options);

This will create the iframe element. You need to pass "type" of the element in options object (see examples below). Type can be "SINGLECHAIN", "MULTICHAIN" or "CROSSCHAIN". If type is not passed "SINGLECHAIN" will be used as default.

Element can be ID of already existing element or an instance of an HTMLElement. It will be appended inside that element. If element does not exist it will be created with this given ID. If element is null, the element will be created with random ID.

Returns: ID of the iframe element.


  • type: type of the widget ("SINGLECHAIN", "MULTICHAIN" or "CROSSCHAIN")

  • network: the network that this widget is for. String if type is 'SINGLECHAIN', array if type is 'MULTICHAIN'

  • slippage: slippage setting for the swap

  • liquidityTab: can add or remove liquidity if set to true

  • shadow: draw shadow under the widget element

  • tokens: array of tokens to be visible on the swap widget UI. Empty array shows all tokens.

  • fromToken: default token selected for 'from' field

  • toToken: default token selected for 'to' field

  • backgroundColor: background color of the widget. Can also be set to 'transparent'

  • backgroundImage: background image of the widget

  • textColor: main text color

  • buttonStyle: large button style

  • maxButtonStyle: style of the "max" button which is shown after user has connected to the widget

  • inputContainerStyle: style of the input containers and dropdown elements

  • headingStyle: style of the main heading

  • lightBranding: JustMoney logo white when set to true, dark if set to false

Last updated