Get OHLC Candles
coingecko.ohlc
ActionBusiness appsconnection required
Calls the CoinGecko API with the connection's credentials.
Retrieve a coin's open, high, low and close candles over one of CoinGecko's fixed windows.
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
5 fields, 1 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 |
|---|---|---|---|---|---|
coin_id The coin's CoinGecko API id, as listed by the Coins List node (not its symbol). | string | Yes | — | — | bitcoin |
vs_currency The currency prices are quoted in, as a supported vs_currency code. | string | No | usd | — | usd |
days The window the candles cover; CoinGecko accepts only these values. | string | No | 1 | one of "1", "7", "14", "30", "90", "180", "365", "max" | — |
interval The candle size; leave unset to let CoinGecko choose it. | string | No | — | one of "daily", "hourly" | — |
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" | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"coin_id": "bitcoin",
"days": "1",
"vs_currency": "usd"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
candles One [unix_ms, open, high, low, close] row per candle. | array | — |
count How many candles were returned. | number | — |
coin_id The coin the candles belong to. | string | — |
days The window the candles cover. | string | — |
{
"candles": [],
"coin_id": "",
"count": 0,
"days": ""
}Related CoinGecko nodes
See Get OHLC Candles 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.