# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://www.lumolabs.ai/tools/coingecko-global-crypto-data-tool.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.