> For the complete documentation index, see [llms.txt](https://www.lumolabs.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.lumolabs.ai/tools/coingecko-global-crypto-data-tool.md).

# CoinGecko Global Crypto Data Tool

#### CoinGecko Global Crypto Data Tool (`coingecko_global_crypto_data_tool`)

Fetches an overview of the global cryptocurrency market from CoinGecko, including total market capitalization, trading volume, and dominance percentages for major coins.

***

{% hint style="info" %}
**Input:** This tool requires **no specific input**.
{% endhint %}

```python
class CoinGeckoGlobalCryptoDataInput(BaseModel):
    pass # No input needed
```

***

**Key Functionality:**

* Retrieves overall global cryptocurrency market statistics from the `api.coingecko.com`.
* Provides data such as:
  * Total market cap (USD) and its 24h change.
  * 24h trading volume (USD).
  * Market dominance of coins like BTC, ETH, etc.
  * Number of active cryptocurrencies and markets.
  * Last data update time.

***

**Sample Usage Queries (How an AI might use it):**

* "What's the current global crypto market cap according to CoinGecko?"
* "Show me the overall cryptocurrency market status."
* "Get global crypto data from CoinGecko."
* "What is Bitcoin's current market dominance?"
* "Fetch the total trading volume for the crypto market."
* "Give me a global cryptocurrency market overview from CoinGecko."
* "How many active cryptocurrencies are there globally?"
* "What's the 24-hour change in the total crypto market cap?"

***

```python
class CoinGeckoGlobalCryptoDataTool(BaseTool):
    name: ClassVar[str] = "coingecko_global_crypto_data_tool"
    description: ClassVar[str] = "Get global cryptocurrency market data including market cap, volume, and dominance percentages."
    args_schema: ClassVar[Type[BaseModel]] = CoinGeckoGlobalCryptoDataInput
```

***

**Important:**

* This tool operates **asynchronously** (`_arun`) only.
* Relies on the external CoinGecko API (`api.coingecko.com`); its functionality and data accuracy depend on this third-party service.