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_KEY

Authorization 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! 💙