Get Price
coingecko.simple_price
ActionBusiness appsconnection required
Calls the CoinGecko API with the connection's credentials.
Look up the current price of one or more coins in one or more currencies, optionally with market cap, volume and 24-hour change.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- CoinGecko
- Secret shape
- the CoinGecko API key, or {"api_key": "…"}
- Config it needs
- plan, base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
10 fields, none required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
ids CoinGecko API ids to price, comma-separated; up to 515 per request. | string | No | — | — | bitcoin,ethereum |
names Coin names to price, comma-separated; used when no ids are given. | string | No | — | — | Bitcoin |
symbols Coin symbols to price, comma-separated; used when no ids or names are given. | string | No | — | — | btc |
vs_currencies Currencies to quote the price in, comma-separated. | string | No | usd | — | usd,eur |
include_tokens For a symbols lookup only: 'all' returns every matching token, 'top' returns the top-ranked one. | string | No | — | one of "top", "all" | — |
include_market_cap Include each coin's market capitalisation. | boolean | No | false | — | — |
include_24hr_vol Include each coin's 24-hour trading volume. | boolean | No | false | — | — |
include_24hr_change Include each coin's 24-hour price change percentage. | boolean | No | false | — | — |
include_last_updated_at Include the UNIX timestamp of when the price was last updated. | boolean | No | false | — | — |
precision How many decimal places a price carries; 'full' returns CoinGecko's own precision. | string | No | — | one of "full", "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18" | — |
- At least one of ids, names, symbols must be set.
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"ids": "bitcoin,ethereum",
"include_24hr_change": false,
"include_24hr_vol": false,
"include_last_updated_at": false,
"include_market_cap": false,
"names": "Bitcoin",
"symbols": "btc",
"vs_currencies": "usd,eur"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
prices One entry per coin, keyed by its API id, holding a price per currency. | object | — |
count How many coins were priced. | number | — |
vs_currencies The currencies the prices are quoted in. | string | — |
{
"count": 0,
"prices": {},
"vs_currencies": ""
}Related CoinGecko nodes
See Get Price run in a workflow.
In a technical demo we add the CoinGecko connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.