> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3os.org/llms.txt
> Use this file to discover all available pages before exploring further.

# CoinGecko Integration

Automate your crypto workflows with seamless integration to CoinGecko Pro API, turning real‑time market data into actionable triggers and custom actions...

![CoinGecko logo](https://ai-icon.b3.fun/logo/coingecko) Integration available

Automate your crypto workflows with seamless integration to CoinGecko Pro API, turning real‑time market data into actionable triggers and custom actions without writing code. Boost efficiency, reduce latency, and unlock advanced analytics across DeFi and token markets.


**[Public page](https://b3os.org/integrations/app/coingecko)**

Open the user-facing integration overview for examples, templates, and sharing.
  **[Action reference](/actions/reference)**

Schema-level references for executable actions and test payloads.
  **[Trigger reference](/actions/trigger-reference)**

Event and schedule triggers that can start B3OS workflows.

## Build With CoinGecko

Use CoinGecko when a workflow needs to call Get Coin by Contract Address, Get Coin Info, Get Coin Markets or related CoinGecko operations from a typed B3OS action. Start in the visual editor to connect an account, then use the references below for payload shape, required fields, and API testing.

## Available Actions

| Action | ID | Connector | Required fields |
| --- | --- | --- | --- |
| ![Get Coin by Contract Address logo](https://ai-icon.b3.fun/logo/coingecko) [Get Coin by Contract Address](/actions/reference/generated/coingecko-get-coin-by-contract) | `coingecko-get-coin-by-contract` | `-` | `platform`, `contractAddress` |
| ![Get Coin Info logo](https://ai-icon.b3.fun/logo/coingecko) [Get Coin Info](/actions/reference/generated/coingecko-get-coin-info) | `coingecko-get-coin-info` | `-` | `coinId` |
| ![Get Coin Markets logo](https://ai-icon.b3.fun/logo/coingecko) [Get Coin Markets](/actions/reference/generated/coingecko-get-coin-markets) | `coingecko-get-coin-markets` | `-` | `vsCurrency` |
| ![Get Coin Tickers logo](https://ai-icon.b3.fun/logo/coingecko) [Get Coin Tickers](/actions/reference/generated/coingecko-get-coin-tickers) | `coingecko-get-coin-tickers` | `-` | `coinId` |
| ![Get Contract Market Chart logo](https://ai-icon.b3.fun/logo/coingecko) [Get Contract Market Chart](/actions/reference/generated/coingecko-get-contract-market-chart) | `coingecko-get-contract-market-chart` | `-` | `platform`, `contractAddress`, `vsCurrency`, `days` |
| ![Get Contract Market Chart by Date Range logo](https://ai-icon.b3.fun/logo/coingecko) [Get Contract Market Chart by Date Range](/actions/reference/generated/coingecko-get-contract-market-chart-range) | `coingecko-get-contract-market-chart-range` | `-` | `platform`, `contractAddress`, `vsCurrency`, `from`, `to` |
| ![Get Derivatives Exchange Info logo](https://ai-icon.b3.fun/logo/coingecko) [Get Derivatives Exchange Info](/actions/reference/generated/coingecko-get-derivatives-exchange-info) | `coingecko-get-derivatives-exchange-info` | `-` | `exchangeId` |
| ![Get Derivatives Exchanges logo](https://ai-icon.b3.fun/logo/coingecko) [Get Derivatives Exchanges](/actions/reference/generated/coingecko-get-derivatives-exchanges) | `coingecko-get-derivatives-exchanges` | `-` | - |
| ![Get Derivatives Exchanges List logo](https://ai-icon.b3.fun/logo/coingecko) [Get Derivatives Exchanges List](/actions/reference/generated/coingecko-get-derivatives-exchanges-list) | `coingecko-get-derivatives-exchanges-list` | `-` | - |
| ![Get Derivatives Tickers logo](https://ai-icon.b3.fun/logo/coingecko) [Get Derivatives Tickers](/actions/reference/generated/coingecko-get-derivatives-tickers) | `coingecko-get-derivatives-tickers` | `-` | - |
| ![Get Exchange Info logo](https://ai-icon.b3.fun/logo/coingecko) [Get Exchange Info](/actions/reference/generated/coingecko-get-exchange-info) | `coingecko-get-exchange-info` | `-` | `exchangeId` |
| ![Get Exchange Tickers logo](https://ai-icon.b3.fun/logo/coingecko) [Get Exchange Tickers](/actions/reference/generated/coingecko-get-exchange-tickers) | `coingecko-get-exchange-tickers` | `-` | `exchangeId` |


34 more actions are listed in the full action reference.

## Available Triggers

No trigger references are published for this integration yet.


## Common Use Cases

**Real‑time price alerts for portfolio rebalancing**

Trigger automated buys or sells when a token crosses a defined price threshold, using CoinGecko price feeds.
  **On‑chain token holder monitoring**

Get holder chart data and receive notifications when top holders increase or decrease their positions.
  **DeFi pool performance tracking**

Fetch pool OHLCV and trade data to generate weekly performance reports or trigger re‑allocation strategies.
  **Trending token discovery for investment scouting**

Leverage trending and top gainer/loser APIs to surface emerging tokens for further research.

## Connector Notes

- Create the connector from a trusted B3OS organization before publishing workflows that call external accounts.
- Keep OAuth tokens, API keys, bot tokens, channel IDs, and account IDs in connector settings or workflow props, not in reusable public template text.
- Test with the visual editor or `POST /v1/actions/{type}/test` before routing production traffic.

## Related Templates

| Template | Description | Tags |
| --- | --- | --- |
| [Clanker: Auto-take profit or stop loss on positions](https://b3os.org/templates/clanker-auto-take-profit-stop-loss) | Watches your open Clanker snipe positions and auto-sells the moment your take-profit or stop-... | defi, trading, wallet |

## FAQ

**Do I need an API key to use CoinGecko Pro?**

Yes, you must obtain a CoinGecko Pro API key and enter it in the integration settings.
  **Can I schedule data pulls at specific intervals?**

Absolutely—set recurring triggers to fetch market data every few minutes, hours, or days.
  **Is the data refreshed in real time?**

The Pro API provides near‑real‑time updates, typically within seconds of market changes.
  **Can I combine CoinGecko data with other apps in B3OS?**

Yes, you can chain actions to push data to wallets, alerts, or other blockchain services.
  **What happens if my API key expires?**

The integration will pause until a valid key is re‑entered, preventing data loss.