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.
Действие каталога Данные блокчейна
Получайте рыночные данные для криптовалют с ценами, рыночной капитализацией, объемом торгов и метриками предложения. Возвращает текущую цену, максимум/минимум/объем за 24 ч, проценты изменения цены (24 ч, 7 д, 14 д, 30 д, 1 г), ATH/ATL, циркулирующее/общее/максимальное предложение, а также опциональный спарклайн за 7 дней. Сортировка по рыночной капитализации по умолчанию. Поддерживает пагинацию (100/страница, макс. 250), фильтрацию по категории (DeFi, Layer 1, Meme) и фильтрацию по ID монет. Идеально подходит для: дашбордов обзора рынка, лидербордов, сравнения монет, анализа категорий, скринеров.
Вкратце
| Поле | Значение |
|---|---|
| ID действия | coingecko-get-coin-markets |
| Категория | Данные блокчейна |
| Коннектор | Не требуется |
| Требует газа | Нет |
| Движение средств | Не указано |
| Теги | coingecko, market, price, cryptocurrency, market-cap, volume, rankings, read |
Схема полезной нагрузки
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
vsCurrency | string | Да | Целевая валюта для цен и рыночных данных (например, 'usd', 'eur', 'btc'). Все цены будут в этой валюте. |
ids | array | Нет | Фильтрация по конкретным ID монет. Если указано, возвращает данные только для этих монет. Макс. 250 ID. |
category | string | Нет | Фильтрация по категории (например, 'decentralized-finance-defi', 'layer-1', 'meme-token'). Используйте действие get-categories для полного списка. |
order | string | Нет | Порядок сортировки результатов. По умолчанию: 'market_cap_desc' |
perPage | number | Нет | Количество результатов на страницу. Диапазон: 1-250. По умолчанию: 100 |
page | number | Нет | Номер страницы для пагинации. По умолчанию: 1 |
sparkline | boolean | Нет | Включить данные спарклайна цен за 7 дней. По умолчанию: false |
priceChangePercentage | string | Нет | Включить процент изменения цены для конкретных периодов. Через запятую: '1h,24h,7d,14d,30d,200d,1y'. По умолчанию: нет |
Схема результата
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
coins | array | Да | Массив рыночных данных монет |
page | number | Да | Текущий номер страницы |
perPage | number | Да | Результатов на страницу |
totalCount | number | Нет | Общее количество результатов (если доступно) |
Примеры
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" }}'
Поля полезной нагрузки могут использовать выражения рабочего процесса, такие как {{$trigger.body.amount}}, {{$nodes.fetch.result.price}} и {{$props.asset}}, когда значение должно поступать из триггера, предыдущего узла или свойства повторно используемого рабочего процесса.