# CoinGecko Exchange Rates Tool

#### CoinGecko Exchange Rates Tool (`coingecko_exchange_rates_tool`)

Fetches current exchange rates for 1 Bitcoin (BTC) against a list of major cryptocurrencies, fiat currencies, and commodities, as provided by CoinGecko.

***

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

***

**Key Functionality:**

* Retrieves Bitcoin's exchange rates against other assets from `api.coingecko.com`.
* Displays how many units of selected major cryptocurrencies (e.g., ETH, SOL), fiat currencies (e.g., USD, EUR), and commodities (e.g., Gold) are equivalent to 1 BTC.

***

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

* "What are the current Bitcoin exchange rates from CoinGecko?"
* "Show me BTC's value against major currencies and cryptos."
* "Get the CoinGecko exchange rates for Bitcoin."
* "How much ETH or USD is 1 Bitcoin worth right now?"
* "Fetch current BTC exchange rates."
* "What are the Bitcoin rates against fiat and other top coins on CoinGecko?"
* "Provide a summary of Bitcoin's exchange rates."

***

```python
class CoinGeckoExchangeRatesTool(BaseTool):
    name: ClassVar[str] = "coingecko_exchange_rates_tool"
    description: ClassVar[str] = "Get Bitcoin-to-currency exchange rates for major cryptocurrencies, fiat currencies, and commodities."
    args_schema: ClassVar[Type[BaseModel]] = CoinGeckoExchangeRatesInput
```

***

**Important:**

* This tool operates **asynchronously** (`_arun`) only.
* Relies on the external CoinGecko API (`api.coingecko.com`); 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-exchange-rates-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.