👀 Common Use Cases

1. Get Coins Logo Images

• Use /coins/{id} endpoint
• This endpoint can be used to query other coin's metadata like: links, categories, contract address, community, description in different languages and many more

2. Best Endpoint for Latest Crypto Price

• Use /simple/price endpoint
• This endpoint can be used to query other market data like market cap, 24-hour trading volume and 24-hour price change percentage

3. Get All Trading Pairs (Tickers) of a Coin

• Use /coins/{id}/tickers endpoint

4. Get Trading Pairs of Specific Coins from a Specific Exchange

• Use /coins/{id}/tickers endpoint by supplying specific exchange id

5. Building Telegram Bot for Latest Coin Listings

• Use /coins/list/new endpoint

6. Get List of Coins Under Specific Category

• Use /coins/markets by supplying specific category

7. Identify DEX Decentralized Exchanges

• Use /exchanges/list endpoint to get full list of exchanges with id on CoinGecko

• Use /exchanges/{id} to find out whether the exchange is centralized or decentralized

• Example of responses (using Uniswap V3 as example) :

  Since Uniswap is a DEX, therefore it shows "centralized": false

  
  
  json

  {
    "name": "Uniswap V3 (Ethereum)",
    ......
    "centralized": false, 👈
    ......
    "tickers": [],
    "status_updates": []
  }
  

8. Get Bitcoin Dominance Data (BTC.D)

• Use /global endpoint

• Example of responses:

  
  
  json

  {
    "data": {
      "active_cryptocurrencies": 12414,
      ......
      "market_cap_percentage": { 👈
        "btc": 47.82057011844006,👈
        "eth": 16.943340351591583,
        ......
      },
      "market_cap_change_percentage_24h_usd": -5.032104325648996,
      "updated_at": 1706002730
    }
  }
  

9. Get Market Cap or Dominance of a Specific Ecosystem

• Use /coins/categories
• The endpoint also returns the 24-hour percentage change, offering insights into the traction of different categories or ecosystems

10. Get Token Lists of a Specific Blockchain Network

• Use /token_lists/{asset_platforms_id}/all.json endpoint
• Supply asset platform id to the endpoint

11. Get 7-Day Sparkline Price Data of a Coin

• Use /coins/{id} or /coins/markets endpoints by flagging sparkline = true

12. Get Link to Individual CoinGecko Coin Page

1. Use /coins/list endpoint to get the API ID of the coin

• Supply API ID in this URL path format: www.coingecko.com/en/coins/{API_ID}

2. If you wish to the obtain the URL slug of a specific CoinGecko Coin Page, e.g. www.coingecko.com/en/coins/{web_slug} you may use /coin/{id} endpoint and obtain the web_slug value.

13. Check Coin Status and Stale Price Updates

• Active: use /coins/list endpoint, only active coins will be shown by default. You may also flag status=inactive to get list of inactive coins.
• Price Stale: use /simple/price endpoint, flag include_last_updated_at = true to check latest update time

14. Get Real-Time and Historical Exchange of BTC in USD

• Current exchange rate: use /exchange_rates endpoint
• Historical exchange rate: use /coins/{id}/history or /coins/{id}/market_chart endpoints

15. Get Watchlist Portfolio Data of a Coin

• Use /coins/{id} endpoint by supplying coin id

• Example of responses:

  JSON

  {
    "id": "bitcoin",
    ......
    "watchlist_portfolio_users": 1487932, 👈
    "market_cap_rank": 1,
    ......
  }
  

16. Get Historical Data for Inactive Coins

Note: this is available for paid plan subscribers only.

• Use /coins/list endpoint, specifying the status param as inactive
• Example of endpoint request:
  https://pro-api.coingecko.com/api/v3/coins/list?include_platform=false&status=inactive&x_cg_pro_api_key=YOUR_API_KEY
• Retrieve the coin's ID from the endpoint mentioned above and use it to access historical data via the following endpoints
  • /coins/{id}/history
  • /coins/{id}/market_chart
  • /coins/{id}/market_chart/range
  • /coins/{id}/contract/{contract_address}/market_chart
  • /coins/{id}/contract/{contract_address}/market_chart/range

17. Get TVL (Total Value Locked) data of a Coin

• Use /coins/{id} endpoint by supplying coin id
• Example of responses:

 "total_value_locked":
 {
    "btc": 72324,
    "usd": 4591842314
 }

18. Query Search for Coins, Categories, NFTs, Exchanges, and Pools

We have 2 Search endpoints:

• /search endpoint allows you to search for coins, categories, exchanges (markets), and NFTs listed on CoinGecko.com. You may query by name or symbol.
• /search-pools endpoint allows you to search for pools listed on GeckoTerminal.com. You may query by pool contract address, token contract address, or token symbol.