> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3os.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

![Get Coin Markets logo](https://ai-icon.b3.fun/logo/coingecko)
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

**Workflow node**

```json
{
  "type": "coingecko-get-coin-markets",
  "payload": {
    "vsCurrency": "usd"
  },
  "children": []
}
```
  **Test with API**

```bash
curl -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"
  }
}'
```

**Use expressions for dynamic values**

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.