---
updatedAt: 2025-09-23T23:11:11.000Z
agentTools:
  projectIndex: https://dexguru.readme.io/llms.txt
---

# Getting Started with DexGuru API

This page will help you get started with DexGuru API. You'll be up and running in a jiffy!

# :key: Authorization

To start using DexGuru API, all you need is an API key. Go to [developers.dex.guru](https://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](https://dexguru.readme.io/reference/get_all_chains_v1_chain_get) 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](https://developers.dex.guru/). Please [reach out here](https://webforms.pipedrive.com/f/6UNtc3FT5RJCM2xxVmKOrutNuMhk0BEhYeW8Xb3GtVlfueLi91sfoAXSYb70itWNPl) 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](https://discord.gg/dPW8fzwzz9) and head to **#api-questions** channel, where you can chat with fellow builders!

We're excited you're here! :blue\_heart: