Skip to content

Latest commit

 

History

History
76 lines (52 loc) · 3.14 KB

README.md

File metadata and controls

76 lines (52 loc) · 3.14 KB
Raw

DEXTswap (aggregator widget)

(This is the public documentation repo for the DEXTSwap aggregator widget)

The DEXTswap Aggregator Widget allows websites to embed the DEXTswap aggregator for any blockchain where this feature is supported as in DEXTools.io app.

image

Quick Example

A simple IFrame integration example follows:

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>DEXTswap Aggregator Widget Template</title>
</head>

<body>

   <iframe id="dextswap-aggregator-widget"
    title="DEXTswap Aggregator"
    width="400"
    height="420" src="https://www.dextools.io/widget-aggregator/en/swap/eth/0xfb7b4564402e5500db5bb6d63ae671302777c75a"></iframe>

</body>
</html>

Common issues and testing

You can test if the IFrame integration works properly with the https://iframetester.com/ tool.

In case the widget does not display prices and/or balances in your website, please check your CSP policy for IFrame content https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options

Please be aware that USE OF THIS WIDGET IFRAME FROM localhost domain WON'T WORK, use a real domain instead.

Customization options

The widget is configured adjusting following parts and query parameters of this URL:

https://www.dextools.io/widget-aggregator/en/swap/<chainId>/<tokenAddress>?theme=<theme>
Parameter Values
chainId blockchain ID (see list below)
tokenAddress address of the token to be used as token-in (the token to buy).
The token-out is automatically set according to the chain's reference token, i.e. ETH for Ethereum, BNB for BNB Chain, Matic for Polygon and so on.
theme dark or light

Supported blockchains

This is the current list of blockchains supported:

Blockchain ID
ETHEREUM eth
BNB bnb
POLYGON polygon
FANTOM fantom
CRONOS cronos
ARBITRUM arbitrum
AURORA aurora
AVALANCHE avalanche
OPTIMISM optimism
ZKSYNC zksync
BASE base
OKTC oktc
SOLANA solana