Get Coins Markets
Get futures market performance metrics for cryptocurrencies including price, open interest, funding rates, and liquidations. Returns current price, OI, market cap ratio, price/OI/volume changes across timeframes (5m to 24h), long/short ratios, and liquidation data. Pass 'symbols' (e.g. 'SOL' or 'BTC,ETH') to get specific coins — without it, results are ranked by market cap, so coins[0] is BTC. Ideal for: market overview dashboards, futures market analysis, identifying high activity coins, momentum screening.
Catalog action Blockchain Data
Get futures market performance metrics for cryptocurrencies including price, open interest, funding rates, and liquidations. Returns current price, OI, market cap ratio, price/OI/volume changes across timeframes (5m to 24h), long/short ratios, and liquidation data. Pass 'symbols' (e.g. 'SOL' or 'BTC,ETH') to get specific coins — without it, results are ranked by market cap, so coins[0] is BTC. Ideal for: market overview dashboards, futures market analysis, identifying high activity coins, momentum screening.
At a Glance
| Field | Value |
|---|---|
| Action ID | coinglass-get-coins-markets |
| Category | Blockchain Data |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | coinglass, futures, market, open-interest, liquidation, read |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
symbols | string | No | Comma-separated coin symbols to return (e.g., 'SOL' or 'BTC,ETH,SOL'). Case-insensitive; coins are returned in the order requested. When provided, the action searches the top 500 coins by market cap and returns only these symbols — page/perPage are ignored. Always set this when the workflow is about specific coins; without it, results are ranked by market cap and coins[0] is BTC. |
exchangeList | string | No | Comma-separated exchange names to filter data (e.g., 'binance,okx,bybit'). If not provided, returns aggregated data from all exchanges. |
perPage | number | No | Number of results per page (default: 10). |
page | number | No | Page number for pagination (default: 1). |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
coins | array | Yes | Array of coin market data |
page | number | No | Current page number |
perPage | number | No | Results per page |
symbolsNotFound | array | No | When 'symbols' was requested and only some matched: the requested symbols that were not found in the top 500 by market cap. Absent when every requested symbol matched (or no symbols filter was used). |
Examples
json{ "type": "coinglass-get-coins-markets", "payload": { "symbols": "ETH", "exchangeList": "example-exchangeList", "perPage": 10, "page": 1 }, "children": []}
bashcurl -X POST "https://api.b3os.org/v1/actions/coinglass-get-coins-markets/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "symbols": "ETH", "exchangeList": "example-exchangeList", "perPage": 10, "page": 1 }}'
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.