Comment on page


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.

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

A: Early Beta access is currently available for paid CoinGecko API subscribers only. If you're interested, please submit your request to [email protected]

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

A: No. At the moment the GeckoTerminal API is operating as a separate service. Making calls to GeckoTerminal API will not affect or utilise the call quota on CoinGecko API subscription. However, we do have plans to integrate the service at a later point.
The GeckoTerminal API is currently free to use and you will be required to add an attribution back to the GeckoTerminal website.

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. 1.
    On-chain first. In GeckoTerminal everything is an address. You can query DEX and token data using contract addresses.
  2. 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. 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.