🔗

Link to plugin page: https://zeroqode.com/plugin/coingecko-1649937961627x991210715316323800

Demo to preview the plugin:

🔗

Live Demo: https://zeroqode-demo-27.bubbleapps.io/coingecko

🔗

Bubble Editor: https://bubble.io/page?id=zeroqode-demo-27&name=coingecko&tab=tabs-1

Introduction

Power your applications with CoinGecko’s independently sourced crypto data such as live prices, trading volume, exchange volumes, trading pairs, historical data, contract address data, crypto categories, crypto derivatives, images and more.

How to setup

CoinGecko provides a fundamental analysis of the crypto market. In addition to tracking price, volume and market capitalisation, CoinGecko tracks community growth, open-source code development, major events and on-chain metrics. This plugin does not require any API keys, you just need to install the plugin.

CoinGecko API Call

1. Get the current price of any cryptocurrencies in any other supported currencies that you need.

Parameters:

ids - id of coins, comma-separated if querying more than 1 coin refers to `coins/list`

vs_currencies - vs_currency of coins, comma-separated if querying more than 1 vs_currency refers to `simple/supported_vs_currencies`

include_market_cap - true/false to include market_cap, default: false

include_24hr_vol - true/false to include 24hr_vol, default: false

include_24hr_change - true/false to include 24hr_change, default: false

include_last_updated_at - true/false to include last_updated_at of price, default: false

Response:

Code (200): price(s) of cryptocurrency

2. Get current price of tokens (using contract addresses) for a given platform in any other currency that you need.

Parameters:

id - The id of the platform issuing tokens (See asset_platforms endpoint for list of options)

contract_addresses - The contract address of tokens, comma separated

vs_currencies - vs_currency of coins, comma-separated if querying more than 1 vs_currency refers to `simple/supported_vs_currencies`

include_market_cap - true/false to include market_cap, default: false

include_24hr_vol - true/false to include 24hr_vol, default: false

include_24hr_change - true/false to include 24hr_change, default: false

include_last_updated_at - true/false to include last_updated_at of price, default: false

Response:

Code (200): price(s) of cryptocurrency

3. Get list of supported_vs_currencies.

Parameters:

none

Response:

Code (200): list of supported_vs_currencies

4. List all supported coins id, name and symbol (no pagination required)

Use this to obtain all the coins' id in order to make API calls

Parameters:

include_platform - flag to include platform contract addresses (eg. 0x.... for Ethereum based tokens). valid values: true, false

Response:

Code (200): List all coins with id, name, and symbol

5. List all supported coins price, market cap, volume, and market related data

Use this to obtain all the coins market data (price, market cap, volume)

Parameters:

vs_currency - The target currency of market data (usd, eur, jpy, etc.)

ids - The ids of the coin, comma separated crytocurrency symbols (base). refers to `/coins/list`. When left empty, returns numbers the coins observing the params `limit` and `start`

category - filter by coin category. Refer to /coin/categories/list

order - valid values: market_cap_desc, gecko_desc, gecko_asc, market_cap_asc, market_cap_desc, volume_asc, volume_desc, id_asc, id_desc sort results by field.

per_page - valid values: 1..250 Total results per page

page - Page through results

sparkline - Include sparkline 7 days data (eg. true, false)

price_change_percentage - Include price change percentage in 1h, 24h, 7d, 14d, 30d, 200d, 1y (eg. '`1h,24h,7d`' comma-separated, invalid values will be discarded)

Response:

Code (200): List all coins with market data

6. List all supported coins price, market cap, volume, and market related data

Get current data (name, price, market, ... including exchange tickers) for a coin.

⚠️

IMPORTANT: Ticker object is limited to 100 items, to get more tickers, use `/coins/{id}/tickers` Ticker `is_stale` is true when ticker that has not been updated/unchanged from the exchange for a while. Ticker `is_anomaly` is true if ticker's price is outlined by our system.

You are responsible for managing how you want to display this information (e.g. footnote, different background, change opacity, hide)\n

Parameters:

id - pass the coin id (can be obtained from /coins) eg. bitcoin

localization - Include all localized languages in response (true/false) [default: true]

tickers - Include tickers data (true/false) [default: true]

market_data - Include market_data (true/false) [default: true]

community_data - Include community_data data (true/false) [default: true]

developer_data - Include developer_data data (true/false) [default: true]

sparkline - Include sparkline 7 days data (eg. true, false) [default: false]

Response:

Code (200): Get current data for a coin

7. Get coin tickers (paginated to 100 items)

Get coin tickers (paginated to 100 items)

⚠️

IMPORTANT: Ticker `is_stale` is true when the ticker has not been updated/unchanged from the exchange for a while. Ticker `is_anomaly` is true if ticker's price is outliered by our system. You are responsible for managing how you want to display these information (e.g. footnote, different background, change opacity, hide)

Parameters:

id - pass the coin id (can be obtained from /coins/list) eg. bitcoin

exchange_ids - filter results by exchange_ids (ref: v3/exchanges/list)

include_exchange_logo - flag to show exchange_logo

page - Page through results

order - valid values: trust_score_desc (default), trust_score_asc and volume_desc

depth - flag to show 2% orderbook depth. valid values: true, false

Response:

Code (200): Get coin tickers

8. Get historical data (name, price, market, stats) at a given date for a coin

Get historical data (name, price, market, stats) at a given date for a coin\n

Parameters:

id - pass the coin id (can be obtained from /coins) eg. bitcoin

date - The date of data snapshot in dd-mm-yyyy eg. 30-12-2017

localization - Set to false to exclude localized languages in response

Response:

Code (200): Get historical data at a given date for a coin

9. Get historical market data include price, market cap, and 24h volume (granularity auto)

Get historical market data include price, market cap, and 24h volume (granularity auto)

Minutely data will be used for the duration within 1 day, Hourly data will be used for duration between 1 day and 90 days, Daily data will be used for duration above 90 days.

Parameters:

id - pass the coin id (can be obtained from /coins) eg. bitcoin

vs_currency - The target currency of market data (usd, eur, jpy, etc.)

days - Data up to number of days ago (eg. 1,14,30,max)

interval - Data interval. Possible value: daily

Response:

Code (200): Get historical market data include price, market cap, and 24h volume

10. Get historical market data include price, market cap, and 24h volume within a range of timestamp (granularity auto)

Get historical market data include price, market cap, and 24h volume within a range of timestamp (granularity auto)

Data granularity is automatic (cannot be adjusted) 1 day from query time = 5 minute interval data 1 - 90 days from query time = hourly data above 90 days from query time = daily data (00:00 UTC)

Parameters:

id - pass the coin id (can be obtained from /coins) eg. bitcoin

vs_currency - The target currency of market data (usd, eur, jpy, etc.)

from - From date in UNIX Timestamp (eg. 1392577232)

to - To date in UNIX Timestamp (eg. 1422577232)

Response:

Code (200): Get historical market data include price, market cap, and 24h volume

11. Get coin info from contract address

Get coin info from contract address

Parameters:

id - Asset platform (See asset_platforms endpoint for list of options)

contract_address - Token's contract address

Response:

Code (200): Get current data for a coin

12. Get historical market data include price, market cap, and 24h volume (granularity auto) from a contract address

Get historical market data including price, market cap, and 24h volume (granularity auto)

Parameters:

id - The id of the platform issuing tokens (See asset_platforms endpoint for list of options)

contract_address - Token's contract address

vs_currency - The target currency of market data (usd, eur, jpy, etc.)

days - Data up to number of days ago (eg. 1,14,30,max)

Response:

Code (200): Get historical market data include price, market cap, and 24h volume

13. Get historical market data include price, market cap, and 24h volume within a range of timestamp (granularity auto) from a contract address

Get historical market data include price, market cap, and 24h volume within a range of timestamp (granularity auto)

Parameters:

id - The id of the platform issuing tokens (See asset_platforms endpoint for list of options)

contract_address - Token's contract address

vs_currency - The target currency of market data (usd, eur, jpy, etc.)

from - From date in UNIX Timestamp (eg. 1392577232)

to - To date in UNIX Timestamp (eg. 1422577232)

Response:

Code (200): Get historical market data include price, market cap, and 24h volume

14. Get coin's OHLC

Candle's body: 1 - 2 days: 30 minutes 3 - 30 days: 4 hours 31 and before: 4 days

Parameters:

id - pass the coin id (can be obtained from /coins/list) eg. bitcoin

vs_currency - The target currency of market data (usd, eur, jpy, etc.)

days - Data up to number of days ago (1/7/14/30/90/180/365/max)

Response:

Code (200) - successful operation\n\n[\n1594382400000 (time),\n1.1 (open),\n 2.2 (high),\n 3.3 (low),\n 4.4 (close)\n]

json
"schema": {
              "type": "array",
              "items": {
                "type": "number",
                "example": [
                  1594382400000,
                  1.1,
                  2.2,
                  3.3,
                  4.4
                ]
              }
            }

15. List all asset platforms (Blockchain networks)

List all asset platforms

Parameters:

none

Response:

Code (200): List all asset_platforms

16. List all categories

Parameters:

none

Response:

Code (200): List all categories

17. List all categories with market data

Parameters:

order - valid values:

market_cap_desc (default),

market_cap_asc,

name_desc, name_asc,

market_cap_change_24h_desc

and market_cap_change_24h_asc

Response:

Code (200): List all categories with market data

18. List all exchanges

Parameters:

per_page - Valid values: 1...250 Total results per page Default value:: 100

page - page through results

Response:

Code (200): List all exchanges

19. List all supported markets id and name (no pagination required)

Use this to obtain all the markets' id in order to make API calls

Parameters:

none

Response:

Code (200): List all coins with id and name

20. Get exchange volume in BTC and top 100 tickers only

Get exchange volume in BTC and tickers

⚠️

IMPORTANT: Ticker object is limited to 100 items, to get more tickers, use `/exchanges/{id}/tickers` Ticker `is_stale` is true when ticker that has not been updated/unchanged from the exchange for a while. Ticker `is_anomaly` is true if ticker's price is outliered by our system. You are responsible for managing how you want to display these information (e.g. footnote, different background, change opacity, hide).

Parameters:

id - pass the exchange id (can be obtained from /exchanges/list) eg. binance

Response:

Code (200): Get exchange volume in BTC and top 100 tickers

21. Get exchange tickers (paginated, 100 tickers per page)

Get exchange tickers (paginated)

⚠️

IMPORTANT: Ticker `is_stale` is true when ticker that has not been updated/unchanged from the exchange for a while. Ticker `is_anomaly` is true if ticker's price is outliered by our system. You are responsible for managing how you want to display this information (e.g. footnote, different background, change opacity, hide)

Parameters:

id - pass the exchange id (can be obtained from /exchanges/list) eg. binance

coin_ids - filter tickers by coin_ids (ref: v3/coins/list)

include_exchange_logo - flag to show exchange_logo

page - Page through results

depth - flag to show 2% orderbook depth i.e., cost_to_move_up_usd and cost_to_move_down_usd

order - valid values: trust_score_desc (default), trust_score_asc and volume_desc

Response:

Code (200): Get exchange tickers

22. List all market indexes

Parameters:

per_page - Total results per page

page - Page through results

Response:

Code (200): List all market indexes

23. get market index by market id and index id

Parameters:

market_id - pass the market id (can be obtained from /exchanges/list)

id - pass the index id (can be obtained from /indexes/list)

Response:

Code (200): get market index by market id and index id

24. list market indexes id and name

Parameters:

none

Response:

Code (200): list market indexes id and name

25. List all derivative tickers

Parameters:

include_tickers - ['all', 'unexpired'] - expired to show unexpired tickers, all to list all tickers, defaults to unexpired

Response:

Code (200): List all derivative tickers

26. List all derivative exchanges

Parameters:

order - order results using following params name_ascï¼Œname_descï¼Œopen_interest_btc_ascï¼Œopen_interest_btc_descï¼Œtrade_volume_24h_btc_ascï¼Œtrade_volume_24h_btc_desc

per_page - Total results per page

page - Page through results

Response:

Code (200): List all derivative exchanges

27. show derivative exchange data

Parameters:

id - pass the exchange id (can be obtained from derivatives/exchanges/list) eg. bitmex

include_tickers - ['all', 'unexpired'] - expired to show unexpired tickers, all to list all tickers, leave blank to omit tickers data in response

Response:

Code (200): show derivative exchange data

28. List all derivative exchanges name and identifier

Parameters:

none

Response:

Code (200): List all derivative exchanges name and identifier

29. Get volume_chart data for a given exchange

Parameters:

id - pass the exchange id (can be obtained from /exchanges/list) eg. binance

days - Data up to number of days ago (eg. 1,14,30)

Response:

Code (200): Get exchange volume_chart data

30. Get BTC-to-Currency exchange rates

Parameters:

none

Response:

Code (200): List rates

31. Search for coins, categories and markets on CoinGecko

Search for coins, categories and markets listed on CoinGecko ordered by largest Market Cap first

Parameters:

query - Search string

Response:

Code (200): List of coins, categories and markets matching search term ordered by market cap

json
"schema": {
                  "type": "object",
                  "properties":{
                    "coins": {
                      "type": "array",
                      "properties": {
                        "item": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "name": {
                              "type": "string"
                            },
                            "symbol": {
                              "type": "string"
                            },
                            "market_cap_rank": {
                              "type": "integer"
                            }
                          }
                        }
                      }
                    },
                    "exchanges": {
                      "type": "array",
                      "properties": {
                        "item": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "name": {
                              "type": "string"
                            },
                            "market_type": {
                              "type": "string"
                            }
                          }
                        }
                      }
                    },
                    "categories": {
                      "type": "array",
                      "properties": {
                        "item": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "integer"
                            },
                            "name": {
                              "type": "string"
                            }
                          }
                        }
                      }
                    }
                  }
                }

32. Get trending search coins (Top-7) on CoinGecko in the last 24 hours

Top-7 trending coins on CoinGecko as searched by users in the last 24 hours (Ordered by most popular first)

Parameters:

none

Response:

Code (200): List trending coins by most popular first

33. Get cryptocurrency global data

Parameters:

none

Response:

Code (200): Get global data - total_volume, total_market_cap, ongoing icos etc

34. Get cryptocurrency global decentralized finance (defi) data

Get Top 100 Cryptocurrency Global Decentralized Finance(defi) data

Parameters:

none

Response:

defi_market_cap - Defi Market Capitalization in USD

eth_market_cap - Ethereum Market Capitalization in USD

defi_to_eth_ratio - defi_market_cap to eth_market_cap ratio

trading_volume_24h - defi trading volume in 24h in USD

defi_dominance - defi_market_cap to total_market_cap ratio

top_coin_name - defi coin with largest market_cap

top_coin_dominance - top defi coin market dominance

35. Get public companies data

Get public companies bitcoin or ethereum holdings (Ordered by total holdings descending)

Parameters:

coin_id - bitcoin or ethereum

Response:

Code (200): Get public companies bitcoin or ethereum holdings

Errors

The CoinGecko API uses the following error codes:

Changelogs

In changelogs will be logged all the updates for the given plugin. With the date of publishing the update by admin and plugin Version, things that were changed/fixed/improved