(This is the public documentation repo of the DEXTools Chart Widget)
The Chart Widget allows websites to display an embedded trading chart for any pool supported by DEXTools.io app. Chart data is updated in real-time, including the current price in USD and trade history.
Chart display is provided by TradingView
- First search your favorite token or pool by address, name... using the DEXTools search bar.
- Then click the embed option of the DEXTools pair explorer, a pop-up will appear to configure the chart and copy the embed code.
An iframe based integration example follows:
<!DOCTYPE html><html><head><metacharset="UTF-8"><title>DEXTools Pair Explorer Widget Template</title></head><body><iframeid="dextools-widget"
title="DEXTools Trading Chart"
width="500"
height="400" src="https://www.dextools.io/widget-chart/en/ether/pe-light/0xa29fe6ef9592b5d408cca961d0fb9b1faf497d6d?theme=light&chartType=2&chartResolution=30&drawingToolbars=false"></iframe></body></html>You can test if the IFrame integration works properly with a tool like https://iframetester.com/.
In case of errors showing a Chart 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 CHART WIDGET IFRAME FROM localhost WON'T WORK, please use a real domain instead.
The widget is configured by using the embed wizard, but also manually adjusting the following parts and query parameters of this URL:
https://www.dextools.io/widget-chart/en/<chainId>/pe-light/<pairAddress>?theme=<theme>&chartType=<chartType>&chartResolution=<chartResolution>&drawingToolbars=<drawingToolbars>&tvPlatformColor=<color>&tvPaneColor=<color>&headerColor=<color>&chartInUsd=<chartInUsd>&showTradeHistory=<showTradeHistory>&tradeHistoryColor=<tradeHistoryColor>
| Parameter | Values |
|---|---|
| chainId | blockchain ID (see list below) |
| pairAddress | address of the pool to display |
| theme | dark or light |
| chartType | 0 = Bar 1 = Candle 2 = Line 3 = Area 8 = Heikin Ashi 9 = hollow candle 10 = Baseline |
| chartResolution | 1 (minute), 3, 5, 15, 30, 60, 120, 240, 720, 1D, 3D, 1W, 1M |
| drawingToolbars | false or true |
| showTradeHistory | false or true |
| headerColor | custom color for the widget header. IMPORTANT: should be in hexadecimal format without the # |
| tvPlatformColor | custom color for the chart background. IMPORTANT: should be in hexadecimal format without the # |
| tvPaneColor | custom color for the chart controls background. IMPORTANT: should be in hexadecimal format without the # |
| tradeHistoryColor | custom color for the trade history background. IMPORTANT: should be in hexadecimal format without the # |
| chartInUsd | false to show the "Token/<chain reference token>" chart, otherwise (also if this param is not passed) the chart is the "Token/USD" one by default |
We add support for new blockchains frequently. This is the current list of available blockchains:
| Blockchain | ID |
|---|---|
| SOLANA | solana |
| ETHEREUM | ether |
| BNB | bnb |
| BASE | base |
| POLYGON | polygon |
| PULSE | pulse |
| TON | ton |
| ARBITRUM | arbitrum |
| AVALANCHE | avalanche |
| MONAD | monad |
| RONIN | ronin |
| SUI | sui |
| SONIC | sonic |
| TRON | tron |
| CRONOS | cronos |
| XRPL | xrpl |
| WORLD CHAIN | worldchain |
| OSMOSIS | osmosis |
| ABSTRACT | abstract |
| VSC | vsc |
| SONEIUM | soneium |
| LINEA | linea |
| OPTIMISM | optimism |
| ICP | icp |
| HYPER EVM | hyperevm |
| BERA CHAIN | berachain |
| X LAYER | xlayer |
| CHILIZ | chiliz |
| SHIBARIUM | shib |
| HEDERA | hedera |
| APTOS | aptos |
| MANTLE | mantle |
| UNI CHAIN | unichain |
| SHIDO | shido |
| FLARE | flare |
| METIS | metis |
| DOGE CHAIN | dogechain |
| ZKSYNC | zksync |
| STORY | story |
| KAIA | kaia |
| NEAR | near |
| INK | ink |
| CELO | celo |
| PLASMA | plasma |
| SEI | sei |
| XDC | xdc |
| GNOSIS | gnosis |
| APE CHAIN | apechain |
| IOTA-EVM | iotaevm |
| BLAST | blast |
| INJECTIVE | injective |
| QUBIC | qubic |
| ETHERLINK | etherlink |
| PAW CHAIN | pawchain |
| FUSE | fuse |
| U2U | utwou |
| ODYSSEY | odyssey |
| SCROLL | scroll |
| CRONOS-ZKEVM | cronoszkevm |
| SUPERSEED | superseed |
| OKTC (FORMER OEC) | oktc |
| ARBITRUM NOVA | arbitrumnova |
| BITLAYER | bitlayer |
| ELYSIUM | elysium |
| GRAVITY ALPHA | gravityalpha |
| MODE | mode |
| MANTA | manta |
| KAVA | kava |
| KUJIRA | kujira |
| POLYGON-ZKEVM | polygonzkevm |
| UNIT ZERO | units |
| NIBIRU | nibiruevm |
| ANUBIS | anubis |
| TERRA | terra |
| ROBINHOOD | robinhood |
| STABLE | stable |