Actions52
- Get Asset Platforms
- Get Asset Platforms List
- Get Categories
- Get Categories List
- Get Coin by Contract
- Get Coin Categories
- Get Coin Contract
- Get Coin Contract Market Chart
- Get Coin Contract Market Chart Range
- Get Coin History
- Get Coin Info
- Get Coin List
- Get Coin Market Chart
- Get Coin Market Chart Range
- Get Coin OHLC
- Get Coin Price
- Get Coin Status Updates
- Get Coin Tickers
- Get Companies
- Get Derivatives
- Get Derivatives Exchange Info
- Get Derivatives Exchanges
- Get Events
- Get Exchange Info
- Get Exchange List
- Get Exchange Rates
- Get Exchange Status Updates
- Get Exchange Tickers
- Get Exchange Volume Chart
- Get Exchanges List
- Get Finance
- Get Global Data
- Get Global DeFi Data
- Get Indexes
- Get Market Data
- Get Markets
- Get NFT by Contract
- Get NFT Collection Info
- Get NFT List
- Get NFT Market Chart
- Get Status Updates
- Get Supported Currencies
- Get Token Lists
- Get Token Price by Contract
- Get Trending Coins
- Get Trending Search
- Ping
- Search
- Search Coins
- Simple Price
- Simple Supported Currencies
- Simple Token Price
Get Market Data
AI-generatedOverview
This node operation fetches market data for cryptocurrencies from the CoinGecko API. It is useful for users who want to retrieve detailed market information such as prices, market caps, and volumes for various cryptocurrencies, with options to customize the currency, pagination, and sorting order. For example, a user can get the top 100 cryptocurrencies by market cap in USD or get market data sorted by volume in EUR.
Use Case Examples
- Retrieve the top 100 cryptocurrencies by market cap in USD.
- Get market data for cryptocurrencies sorted by volume in EUR, showing 50 results per page on page 2.
Properties
| Name | Meaning |
|---|---|
| VS Currency | The reference currency for the prices returned by the API. Options include AUD, BTC, CAD, ETH, EUR, GBP, JPY, and USD. |
| Per Page | Number of results to return per page, with a minimum of 1 and a maximum of 250. |
| Page | The page number of results to retrieve, starting from 1. |
| Order | The sorting order of the results, which can be by ID ascending or descending, market cap ascending or descending, or volume ascending or descending. |
Output
JSON
json- ``
*id- The unique identifier of the cryptocurrency.
*symbol- The symbol of the cryptocurrency.
*name- The name of the cryptocurrency.
*image- URL to the cryptocurrency's image or logo.
*current_price- The current price of the cryptocurrency in the specified vsCurrency.
*market_cap- The market capitalization of the cryptocurrency.
*market_cap_rank- The rank of the cryptocurrency by market capitalization.
*total_volume- The total trading volume of the cryptocurrency.
*high_24h- The highest price of the cryptocurrency in the last 24 hours.
*low_24h- The lowest price of the cryptocurrency in the last 24 hours.
*price_change_24h- The price change of the cryptocurrency in the last 24 hours.
*price_change_percentage_24h- The percentage price change of the cryptocurrency in the last 24 hours.
*market_cap_change_24h- The change in market capitalization in the last 24 hours.
*market_cap_change_percentage_24h- The percentage change in market capitalization in the last 24 hours.
*circulating_supply- The circulating supply of the cryptocurrency.
*total_supply- The total supply of the cryptocurrency.
*max_supply- The maximum supply of the cryptocurrency, if applicable.
*ath- The all-time high price of the cryptocurrency.
*ath_change_percentage- The percentage change from the all-time high price.
*ath_date- The date when the all-time high price was reached.
*atl- The all-time low price of the cryptocurrency.
*atl_change_percentage- The percentage change from the all-time low price.
*atl_date- The date when the all-time low price was reached.
*last_updated- The timestamp of the last update for the cryptocurrency data.
- ``
Dependencies
- CoinGecko public API
Troubleshooting
- Common issues include invalid or unsupported vsCurrency values, which can cause the API to return errors or empty results. Ensure the vsCurrency is one of the supported options (AUD, BTC, CAD, ETH, EUR, GBP, JPY, USD).
- Pagination parameters (perPage and page) must be within valid ranges; perPage must be between 1 and 250, and page must be at least 1.
- Network or API connectivity issues can cause request failures; verify internet connection and API availability.
- If the API returns an error about unsupported operations, verify that the operation parameter is correctly set to 'getMarketData'.
Links
- CoinGecko API Documentation - Official documentation for the CoinGecko API endpoints and parameters.