CoinGecko Integration

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


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

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

API Key

  • Go to the CoinGecko website and sign in or create an account: https://www.coingecko.comarrow-up-right

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


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.


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

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.

Last updated