CoinGecko

Access live and historical cryptocurrency market data from the CoinGecko API v3: current prices, market charts, OHLC candles, trending coins, exchange and category data, and global market statistics.

17 actions available

A scheduled check fires for a tracked portfolio of coins

Agent fetches current prices with Get Price for the watchlist

Agent reads each coin's price against its stored baseline

Agent flags any coin that crossed its movement threshold

Agent confirms the move is real and not a single bad tick

Agent drafts a rebalance or alert recommendation with the numbers

Any action that moves real money waits for treasury approval

What This Integration Enables

The CoinGecko connector lets agents read the crypto market and act on it inside a workflow. Agents fetch current prices for coins or contract-addressed tokens, pull market data for leaderboards, retrieve historical prices, OHLC candles, and market charts for analysis, and surface trending coins and search results to enrich alerts. Global and DeFi statistics, exchange data, and categories round out the picture. Ping verifies connectivity and plan validity before a downstream automation runs. The connector supplies the reading; the surrounding flow decides what a price move should do.

Without FlowRunner

Prices checked manually Someone opens a market app and scans a watchlist by hand

Moves caught after the fact A threshold gets crossed hours before anyone notices

No consistent record Snapshots live in a spreadsheet someone updates when they remember

With FlowRunner

Continuous price watch The agent reads the watchlist on a schedule and compares to baselines

Threshold crossings surfaced A coin that moves past its band becomes an exception a person sees now

Every snapshot logged Readings are appended to a tracking record with a full history

Use Case Scenarios

Portfolio Threshold Watch

A finance team tracks a portfolio of coins with a movement band around each. On a schedule the agent calls Get Price for the full watchlist and compares each result to its stored baseline. Coins inside their band are logged and left alone. A coin that breaks its band becomes an exception: the agent drafts a summary with the price, the move, and the recent chart, and routes it to the person who owns the position. Nothing trades automatically.

Morning Market Digest

Each morning the agent calls Trending for the top trending coins and Coins Markets for the tracked set, then posts a digest to a team channel with rank, price, and market cap. Because the digest runs on a schedule, the team starts the day with the same picture instead of each person checking a different app. Global Data adds a one-line read on overall market conditions at the top.

Historical Analysis Pull

An analyst needs price history for a report. The agent calls Get Coin Market Chart and Get Coin OHLC over the requested range and writes the series to a spreadsheet or database. Get Token Price by Contract resolves any token given only its on-chain address, so the analyst does not have to hunt for a listing. The agent assembles the data; the analyst draws the conclusions.

Human-in-Loop Highlight

A price reading is information, not an instruction. The agent can watch the market all day, but the moment a number would trigger a real action, moving funds, rebalancing a position, alerting a client to trade, it stops and asks. When a tracked coin crosses its threshold, the agent does not execute anything downstream. It assembles the coin, the price move, the recent OHLC candles, and a sized recommendation, then routes to the treasury owner through their channel: "ETH is down 12 percent against its 30-day baseline and has crossed the rebalance trigger. Recommend trimming the position by the planned amount. Approve?" This is [human-in-the-loop](/concepts/human-in-the-loop/) placed exactly where the cost of being wrong is highest: the agent handles the watching and the math, and a person owns every decision that touches money.

Agent processes routinely

Detects exception requiring judgment

Clear match Continues automatically

Ambiguous Routes to human via preferred channel

Human decides

Agent resumes with decision

Agent Capabilities

17 actions

System

Ping Verify CoinGecko API connectivity and plan validity before running downstream automations.

Simple

Get Price Fetch current prices for one or more coins against selected vs currencies. Use it for watchlists and threshold checks.
Get Token Price by Contract Look up the current price of a token by its on-chain contract address. Use it when you have an address but no listing.
Supported VS Currencies List the quote currencies CoinGecko can price against.

Coins

List Coins Retrieve the full list of coins CoinGecko tracks.
Coins Markets Pull market data (rank, price, market cap, volume) for a set of coins. Use it for leaderboards and dashboards.
Get Coin Data Fetch full metadata and market data for a single coin.
Get Coin Market Chart Retrieve historical market chart data (price, market cap, volume) over a time range.
Get Coin OHLC Fetch open-high-low-close candles for a coin over a period.
Get Coin History Get a coin snapshot for a specific historical date.

Search & Trending

Search Search coins, categories, and exchanges by keyword.
Trending Return the current top trending coins on CoinGecko.

Global

Global Data Retrieve global cryptocurrency market statistics.
Global DeFi Data Retrieve global decentralized finance market statistics.

Exchanges

List Exchanges List the exchanges CoinGecko tracks.
Get Exchange Fetch detail for a single exchange.

Start building with CoinGecko

$100 in credits. No card required. Connect in minutes.

Start Building Free Talk to us