List Markets
coingecko.list_markets
ActionBusiness appsconnection required
Calls the CoinGecko API with the connection's credentials.
List coins with their price, market cap, volume and price-change data, ordered and paged as asked.
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
11 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 |
|---|---|---|---|---|---|
vs_currency The currency prices are quoted in, as a supported vs_currency code. | string | No | usd | — | usd |
ids CoinGecko API ids to restrict the page to, comma-separated; up to 250. | string | No | — | — | bitcoin,ethereum |
names Coin names to restrict the page to, comma-separated. | string | No | — | — | — |
symbols Coin symbols to restrict the page to, comma-separated. | string | No | — | — | — |
category A CoinGecko category id to restrict the page to, such as layer-1. | string | No | — | — | layer-1 |
order How the rows are sorted before paging. | string | No | market_cap_desc | one of "market_cap_desc", "market_cap_asc", "volume_desc", "volume_asc", "id_asc", "id_desc" | — |
per_page How many rows one page holds; CoinGecko allows up to 250. | number | No | 100 | 1–250 | — |
page Which page of results to return, counting from one. | number | No | 1 | ≥ 1 | — |
sparkline Include the seven-day sparkline series alongside the other data. | boolean | No | false | — | — |
price_change_percentage Extra price-change windows to include, comma-separated, from 1h, 24h, 7d, 14d, 30d, 200d and 1y. | string | No | — | — | 24h,7d |
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.
{
"category": "layer-1",
"ids": "bitcoin,ethereum",
"order": "market_cap_desc",
"page": 1,
"per_page": 100,
"price_change_percentage": "24h,7d",
"sparkline": false,
"vs_currency": "usd"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
coins One row per coin, each with its price, market cap, volume and changes. | array | — |
count How many rows the page held. | number | — |
vs_currency The currency the market data is quoted in. | string | — |
{
"coins": [],
"count": 0,
"vs_currency": ""
}Related CoinGecko nodes
See List Markets 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.