Getting Started with DexGuru API
This page will help you get started with DexGuru API. You'll be up and running in a jiffy!
🔑 Authorization
To start using DexGuru API, all you need is an API key. Go to developers.dex.guru, connect your web3 wallet, create a project, and copy your API key. This API key is all you need to start receiving reliable on-chain trading data on multiple EVM-compatible networks.
There are two ways to authorize your API request. Instead of YOUR_API_KEY, use the key you got at developers.dex.guru:
Query Parameter
ex: curl https://api.dev.dex.guru/v1/chain/?api-key=YOUR_API_KEYAuthorization Header
ex: curl https://api.dev.dex.guru/v1/chain/ -H 'api-key: YOUR_API_KEY'
📝 Supported Chains
List of supported networks with the corresponding ChainID:
- Ethereum 1
- BSC 56
- Polygon 137
- Avalanche 43114
- Arbitrum 42161
- Fantom 250
- CELO 42220
- Optimism 10
- Gnosis 100
- Canto 7000
- Arbitrum Nova 42170
For a full list of chains supported, please use Get All Chains endpoint. For list of Chain_IDs you can refer to https://chainlist.org/.
🚦 Free Tier Plan Limitations
Our API is free for personal use, with a few limitations listed below:
- 200,000 calls per month.
- 5 RPS
- 300 sec. delay for data updates
Premium API plan for commercial usage is $199 per month, which includes 1 million API calls. Any additional 1 million API calls will cost an extra $25. We accept payments via credit card, including Visa, Mastercard, and American Express. You can start a free trial at our developers console. Please reach out here if you have any questions about the Premium API plan.
📈 FAQ
Q: Why can I not access all historical data about a certain token?
A: For the time being, for every DEX/AMM that is added onto DexGuru, we currently index and display transaction data only from the date/time they are implemented. This means for all transactions (and their TX data) that have occurred before the date of the DEX/AMM implementation date, will not be included in transaction lists, aggregates/counts, and charts that involve the pre-implementation time period. You can find the list of DEXs and when they were added at https://docs.dex.guru/data/supported-dexs-amms
Q: How often data is updated?
A: Currently for Free Tier Plan there is a 300 seconds delay on all on-chain data.
Q: Am I sending too many requests?
A: The rate limit is 5 concurrent requests per second.
Q: I only receive 20 transactions in the response. How can I look at older transactions?
A: Use "limit" and "offset" query parameters to use pagination. Using the "offset" parameter you can specify where to start a page. Using the "limit" parameter you can specify the page size.
Some parameters can be unclear. Below are their descriptions.
chain_id - You can look up chainID for any EVM powered network by going to https://chainlist.org/.
verified - We use Token Lists to identify verified tokens. A token is considered verified if present in at least one Token List. For ERC-20 tokens we use https://tokenlists.org/. For more info go to https://docs.dex.guru/data/off-chain-data-usage#usage-of-token-lists.
limit - This is a parameter used for pagination. Use it to specify the page size. Learn more about pagination here
offset - This is a parameter used for pagination. Use it to specify where to start a page. Learn more about pagination here.
wallet category:
heavy - Heavy Trader with $500k+ of a trading volume in the last 30 days.
medium - Active Trader with $100k-$500k of a trading volume in the last 30 days.
casual - Casual Trader with $10k-$100k of a trading volume in the last 30 days.
bot - Trader with 1000+ TXs in the last 30 days. Most likely a bot.
noob - All other wallet addresses.
💬 Support!
Need help with our API or want to provide some feedback? Join our Community Discord Server and head to #api-questions channel, where you can chat with fellow builders!
We're excited you're here! 💙
Updated 8 months ago