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.

1. Query Parameter
ex: curl https://api.dev.dex.guru/v1/chain/?api-key=YOUR_API_KEY

2. Authorization Header
ex: curl https://api.dev.dex.guru/v1/chain/ -H 'api-key: YOUR_API_KEY'

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
Arbitrum Nova 42170
zkSync Era 324
zkEVM 1101
KCC 321

Examples of data we provide:

Token Current Price
Recent On-Chain Transactions
Mints and Burns, a.k.a Liquidity Pool Adds and Removes
Wallet Activity

We also provide convenient SDKs for Node and Python developers:
npm install dexguru-sdk
pip install dexguru-sdk

Github links to SDKs:
https://github.com/dex-guru/dg-sdk-node
https://github.com/dex-guru/dg-sdk-python

Rate limit is 5 concurrent requests per second.

While we are in Beta, API is free for personal use. After we are out of Beta, we’ll have a free tier and paid tiers based on API calls usage. Paid tier would require you to stake a certain amount of our upcoming token to get access to real-time data.

RPC Endpoints

RPC Endpoints are proxies to dex.guru hosted blockchain nodes, there are full nodes and archive nodes.
to call specific node call:

/chain_id/api-key FULL node
/chain_id/archive/api-key ARCHIVE node

RPC functions are limited to read only requests. Account limits applied, by default, free layer - 1M requests. You can use same key, generated at https://developers.dex.guru

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!

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 our API is in beta and 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.

200Successful Response

422Validation Error