(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.
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>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.
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 |
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 |