Get Coin Markets
Get market data for cryptocurrencies with prices, market cap, volume, and supply metrics. Returns current price, 24h high/low/volume, price change percentages (24h, 7d, 14d, 30d, 1y), ATH/ATL, circulating/total/max supply, and optional 7-day sparkline. Sorted by market cap by default. Supports pagination (100/page, max 250), filtering by category (DeFi, Layer 1, Meme), and filtering by coin IDs. Ideal for: market overview dashboards, leaderboards, coin comparisons, category analysis, screeners.
Catalog action Blockchain Data
Get market data for cryptocurrencies with prices, market cap, volume, and supply metrics. Returns current price, 24h high/low/volume, price change percentages (24h, 7d, 14d, 30d, 1y), ATH/ATL, circulating/total/max supply, and optional 7-day sparkline. Sorted by market cap by default. Supports pagination (100/page, max 250), filtering by category (DeFi, Layer 1, Meme), and filtering by coin IDs. Ideal for: market overview dashboards, leaderboards, coin comparisons, category analysis, screeners.
At a Glance
| Field | Value |
|---|---|
| Action ID | coingecko-get-coin-markets |
| Category | Blockchain Data |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | coingecko, market, price, cryptocurrency, market-cap, volume, rankings, read |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
vsCurrency | string | Yes | Target currency for prices and market data (e.g., 'usd', 'eur', 'btc'). All prices will be in this currency. |
ids | array | No | Filter by specific coin IDs. If provided, only returns data for these coins. Max 250 IDs. |
category | string | No | Filter by category (e.g., 'decentralized-finance-defi', 'layer-1', 'meme-token'). Use get-categories action for full list. |
order | string | No | Sort order for results. Default: 'market_cap_desc' |
perPage | number | No | Number of results per page. Range: 1-250. Default: 100 |
page | number | No | Page number for pagination. Default: 1 |
sparkline | boolean | No | Include 7-day sparkline price data. Default: false |
priceChangePercentage | string | No | Include price change percentage for specific periods. Comma-separated: '1h,24h,7d,14d,30d,200d,1y'. Default: none |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
coins | array | Yes | Array of coin market data |
page | number | Yes | Current page number |
perPage | number | Yes | Results per page |
totalCount | number | No | Total number of results (if available) |
Examples
json{ "type": "coingecko-get-coin-markets", "payload": { "vsCurrency": "usd" }, "children": []}
bashcurl -X POST "https://api.b3os.org/v1/actions/coingecko-get-coin-markets/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "vsCurrency": "usd" }}'
Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.