# 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\
   ![](https://1786796420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPrg38tsZBv433URqRSSf%2Fuploads%2FnrlJE8wSzHnnmA1aB6RM%2Funknown.png?alt=media\&token=00c69731-0a0f-4516-9156-fcbbb982f705)

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.

![](https://1786796420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPrg38tsZBv433URqRSSf%2Fuploads%2FcP3Vj2EUJ8acHYIYpJ33%2Funknown.png?alt=media\&token=08ec9ee2-0123-4605-b4ce-c9114fed7a48)

***

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

![](https://1786796420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPrg38tsZBv433URqRSSf%2Fuploads%2FcyKCtsmLL0oEBAWtBEiV%2Funknown.png?alt=media\&token=a09f9c08-296d-4935-a881-4435d62e103f)

***

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