❓FAQ

Q: What is the rate limit for the GeckoTerminal API?

A: The current rate limit for the Public API is set at 30 calls per minute. Should you require a higher rate limit, please refer to the question below.

Q: Is there a paid plan to access higher rate limit for GeckoTerminal API?

A: Yes, you may subscribe to any CoinGecko API paid plan to access higher rate limit for GeckoTerminal endpoints (known as /onchain endpoints). Learn more on: https://www.coingecko.com/en/api/pricing

Q: I have a CoinGecko API subscription, can I use that subscription with the GeckoTerminal API?

A: Yes, you may now access all the endpoints directly with your CoinGecko API paid subscription. Here's the documentation: https://docs.coingecko.com/

Q: I am already using the CoinGecko API to get token prices, why do I need GeckoTerminal API?

A: Here are a few reasons why you would want to consider GeckoTerminal API :-

1. On-chain first. In GeckoTerminal everything is an address. You can query DEX and token data using contract addresses.

2. Tokens that are not listed on CoinGecko. Since GeckoTerminal ingests all trades on the network. You can get prices for any tokens that are not found on CoinGecko. However you need to know what you are doing since these tokens may be spams.

3. OHLCV based on on-chain trades.

Q: Can I get the historical price and volume of a token?

A: Yes you can. You will need to identify the pool that is trading the token you are interested in. Use the ohlcv endpoint and pass in the pool address. Specify the candle timeframe and aggregate. For example, if you are looking for daily data, pass day into the timeframe and 1 into the aggregate.

Q: For /networks/{network}/tokens/{token_address}/pool endpoint, how are the top 20 pools being ranked?

A: The top 20 pools are ranked based on their liquidity and trading activity, with the goal of identifying the most liquid pools. The ranking is determined by a combination of two key factors: liquidity ('reserve_in_usd') and 24-Hour Trading Volume ('volume_usd').

Q: For /networks/{network}/tokens/{address} endpoint, what does "price_usd" refer to?

A: "price_usd" refers to the USD price of the token in the first pool listed under "top_pools".

Q: What is the timestamp format used in the OHLCV endpoint?

A: Timestamp format is in epoch/unix timestamp seconds. For example use 1679414400 and not 1679414400000 which is in epoch/unix milliseconds. The OHLCV endpoint returns candlestick timestamp in this format, and you should also use this format when calling the query parameter.

Q: Why is `market_cap_usd` null?

market_cap_usd is null if the token returned on GeckoTerminal API is not listed on coingecko.com or do not have its supply verified (if listed on CoinGecko). fdv will always be returned as its a multiplier of onchain supply and current price.