Get Token Price
Get current cryptocurrency prices by CoinGecko coin IDs (e.g., 'bitcoin', 'ethereum'). Returns real-time prices in multiple currencies (USD, EUR, BTC, ETH). Optionally includes market cap, 24h volume, 24h price change, and last updated timestamp. Supports up to 100 coins per request. Ideal for: multi-coin price lookups, portfolio valuations, price monitoring dashboards, trading signal triggers.
Catalog action Blockchain Data
Get current cryptocurrency prices by CoinGecko coin IDs (e.g., 'bitcoin', 'ethereum'). Returns real-time prices in multiple currencies (USD, EUR, BTC, ETH). Optionally includes market cap, 24h volume, 24h price change, and last updated timestamp. Supports up to 100 coins per request. Ideal for: multi-coin price lookups, portfolio valuations, price monitoring dashboards, trading signal triggers.
At a Glance
| Field | Value |
|---|---|
| Action ID | coingecko-get-token-price |
| Category | Blockchain Data |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | coingecko, price, cryptocurrency, market, valuation, bitcoin, ethereum, real-time, read |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
coinIds | array | Yes | Array of coin IDs to get prices for (e.g., ['bitcoin', 'ethereum']). Use CoinGecko coin IDs, not symbols. You can find coin IDs using the search action or coins list. |
vsCurrencies | array | Yes | Array of target currencies to get prices in (e.g., ['usd', 'eur', 'btc']). Common options: usd, eur, gbp, jpy, btc, eth. |
includeMarketCap | boolean | No | Include market cap data for each coin. Default: false |
include24hVol | boolean | No | Include 24-hour trading volume. Default: false |
include24hChange | boolean | No | Include 24-hour price change percentage. Default: false |
includeLastUpdatedAt | boolean | No | Include last updated timestamp for each coin. Default: false |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
prices | array | Yes | Array of coin prices. Each item contains: id (coin ID), prices (price in each currency), and optionally marketCaps, volumes24h, priceChange24h, lastUpdatedAt. |
Examples
json{ "type": "coingecko-get-token-price", "payload": { "coinIds": [], "vsCurrencies": [] }, "children": []}
bashcurl -X POST "https://api.b3os.org/v1/actions/coingecko-get-token-price/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "coinIds": [], "vsCurrencies": [] }}'
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.