A simple Python API wrapper for DEXTools. Supports Dextools API v1 and Dextools API v2
pip install dextools-python
To obtain an API key, head to the Developer Portal and choose your plan.
There are 2 versions of the Dextools API
To get started, import the package, and initiate a DextoolsAPI instance object by passing your API key:
from dextools_python import DextoolsAPI
dextools = DextoolsAPI(api_key)
You can also pass an optional user agent:
dextools = DextoolsAPI(api_key, useragent="User-Agent")
To get started, import the package, and initiate a DextoolsAPIV2 instance object by passing your API key:
from dextools_python import DextoolsAPIV2
dextools = DextoolsAPIV2(api_key)
You can also pass an optional user agent:
dextools = DextoolsAPIV2(api_key, useragent="User-Agent")
Below are a set of queries supported by the Dextools API v1. All data is returned as a Python dictionary for easy data handling.
To get the pairs of a token, pass a chain id and a pair address:
pair = dextools.get_pair("ether", "0xa29fe6ef9592b5d408cca961d0fb9b1faf497d6d")
print(pair)
To get token details, pass a chain id, and a token address:
token = dextools.get_token("ether", "0xfb7b4564402e5500db5bb6d63ae671302777c75a")
print(token)
You can also pass the page and pageSize parameters:
token = dextools.get_token("ether", "0xfb7b4564402e5500db5bb6d63ae671302777c75a", 1, 50)
print(token)
To get the chain list:
chain_list = dextools.get_chain_list()
print(chain_list)
You can also pass the page and pageSize parameters:
chain_list = dextools.get_chain_list(1, 50)
print(chain_list)
To get the exchange list, pass a chain id:
exchange_list = dextools.get_exchange_list("ether")
print(exchange_list)
You can also pass the page and pageSize parameters:
exchange_list = dextools.get_exchange_list("ether", 1, 50)
print(exchange_list)
Below are a set of queries supported by the Dextools API v2. All data is returned as a Python dictionary for easy data handling.
blockchain = dextools.get_blockchain("ether")
print(blockchain)
blockchains = dextools.get_blockchains()
print(blockchains)
blockchains = dextools.get_blockchains(sort="name", order="desc")
print(blockchains)
factory = dextools.get_dex_factory_info("ether", "0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f")
print(factory)
dexes = dextools.get_dexes("ether")
print(dexes)
dexes = dextools.get_dexes("ether", sort="creationBlock", order="desc")
print(dexes)
pool = dextools.get_pool("ether", "0xa29fe6ef9592b5d408cca961d0fb9b1faf497d6d")
print(pool)
pool_liquidity = dextools.get_pool_liquidity("ether", "0xa29fe6ef9592b5d408cca961d0fb9b1faf497d6d")
print(pool_liquidity)
pool_score = dextools.get_pool_score("ether", "0xa29fe6ef9592b5d408cca961d0fb9b1faf497d6d")
print(pool_score)
pool_price = dextools.get_pool_price("ether", "0xa29fe6ef9592b5d408cca961d0fb9b1faf497d6d")
print(pool_price)
pools = dextools.get_pools("ether", from_="2023-11-14T19:00:00", to="2023-11-14T23:00:00")
print(pools)
pools = dextools.get_pools("ether", from_="12755070", to="12755071", sort="creationBlock", order="desc")
print(pools)
token = dextools.get_token("ether", "0xfb7b4564402e5500db5bb6d63ae671302777c75a")
print(token)
token_locks = dextools.get_token_locks("ether", "0xfb7b4564402e5500db5bb6d63ae671302777c75a")
print(token_locks)
token_score = dextools.get_token_score("ether", "0xfb7b4564402e5500db5bb6d63ae671302777c75a")
print(token_score)
token_info = dextools.get_token_info("ether", "0xfb7b4564402e5500db5bb6d63ae671302777c75a")
print(token_info)
token_price = dextools.get_token_price("ether", "0xfb7b4564402e5500db5bb6d63ae671302777c75a")
print(token_price)
tokens = dextools.get_tokens("ether", from_="2023-11-14T19:00:00", to="2023-11-14T23:00:00")
print(tokens)
Get tokens sorted by creationBlock and descending order and providing block numbers instead in descending order
tokens = dextools.get_tokens("ether", from_="18570000", to="18570500", sort="creationBlock", order="desc")
print(tokens)
tokens = dextools.get_tokens("ether", from_="2023-11-14T19:00:00", to="2023-11-14T23:00:00", sort="socialsInfoUpdated", order="desc")
print(tokens)
token_pools = dextools.get_token_pools("ether", "0xfb7b4564402e5500db5bb6d63ae671302777c75a", from_="2023-11-14T19:00:00", to="2023-11-14T23:00:00")
print(token_pools)
Get token pools sorted by creationBlock and descending order and providing block numbers instead in descending order
token_pools = dextools.get_token_pools("ether", "0xfb7b4564402e5500db5bb6d63ae671302777c75a", from_="18570000", to="18570500", sort="creationBlock", order="desc")
print(token_pools)
hot_pools = dextools.get_ranking_hotpools("ether")
print(hot_pools)
gainers = dextools.get_ranking_gainers("ether")
print(gainers)
losers = dextools.get_ranking_losers("ether")
print(losers)
Some methods support the page and pageSize arguments. Check out the Dextools API v2 documentation for more information.
Check out the examples folder for some example scripts.
A set of tests have been included inside tests folder. You will need to set an environment variable as DextoolsAPIKey using your API key.
Dextools adds support for new blockchains from time to time. dextools.get_blockchains() to get a list of supported blockchains and their IDs