# PARTNER: CoinGecko price feed

### Overview

The CoinGecko integration allows you to fetch real-time cryptocurrency price data directly inside a Decimal workflow. It is commonly used for price monitoring, automation triggers, reporting, and downstream financial or Web3 actions.

This integration works as a node in the Decimal workflow editor and can be connected to any trigger or automation logic.

### Available Modules

#### Fetch Token Price

Fetches the current price of a selected cryptocurrency using CoinGecko data.

This module supports both free and paid CoinGecko API access, depending on your usage needs.

***

### Supported Modes

#### Free API (Demo)

* Uses CoinGecko’s free demo API
* Suitable for testing, prototyping, and low-frequency workflows
* Subject to strict rate limits
* Uses CoinGecko’s paid API
* Higher rate limits
* Recommended for production workflows and frequent executions<br>

***

### Adding CoinGecko to a Workflow

1. Open the Decimal workflow editor
2. Add a Trigger node
3. From the Web3 → CoinGecko section, select Fetch Token Price
4. Connect the CoinGecko node to your trigger\
   ![](/files/6c8wop5Loc1eBspW9QAT)

Once added, the configuration modal will open automatically.

***

### Module Configuration

#### Step 1: API Configuration

**API Plan**

Select the API plan you want to use:

* Free – Uses CoinGecko Demo API
* Pro – Uses CoinGecko Paid API\ <br>

**API Key**

* Go to the CoinGecko website and sign in or create an account:[ https://www.coingecko.com](https://www.coingecko.com)
* Navigate to the Developer Dashboard to generate your API key: <https://www.coingecko.com/en/developers/dashboard>
* Copy the API key and use it while configuring the CoinGecko integration in Decimal.

Decimal validates the API key before proceeding.

Click Validate & Continue to move to the next step.

![](/files/O7yHF9K99DIbrceRaNMR)

***

#### Step 2: Token & Currency Configuration

**VS Currency**

Select the currency in which the token price should be returned.\
Example: usd

**Token**

Choose the cryptocurrency whose price you want to fetch.\
Example: *bitcoin*

**Result Variable Name**

Define the variable name where the result will be stored.

Example:

*coingeckoResult*

This variable will be available to all downstream nodes in the workflow.

![](/files/EVfRcVrVMVqJw4IraT7S)

***

### Output & Variables

After execution, the module stores the fetched data under the specified result variable.

Typical data includes:

* Token price
* Currency used
* Last updated timestamp<br>

Example usage in downstream nodes:

*coingeckoResult.price*

*coingeckoResult.currency*

***

### Example Workflow

Use Case: Fetch Bitcoin price and use it in a downstream automation.

Workflow:

1. Trigger (manual or scheduled)
2. Fetch Token Price (CoinGecko)
3. Use the price in a notification, condition, or data store

This setup allows automated price-based workflows without external scripts.

<br>


---

# 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://wiki.decimal.at/technical/node-directory/partner-coingecko-price-feed.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.
