# Рынки монет **API:** Data API **Endpoint:** `GET /v1/beta/coingecko/coins/markets` **Tags:** CoinGecko Ранжированная рыночная таблица по многим монетам за один вызов: одна строка на монету с `current_price`, `market_cap`, `market_cap_rank`, `total_volume`, `high_24h`, `low_24h`, `price_change_percentage_24h`, `circulating_supply`, `total_supply`, `max_supply`, `ath` и `atl` с датами и `image`. Листайте с помощью `per_page` и `page`, сортируйте с помощью `order` (капитализация, объём или id, по возрастанию или убыванию), сужайте с помощью `ids` или `category`. Передача `price_change_percentage` добавляет соответствующее поле `price_change_percentage_24h_in_currency`. Используйте для рейтингов и сканирования сегментов. Для цен нескольких известных монет `get_coingecko_simple_price` намного легче; для одной монеты целиком — `get_coingecko_coins_id`. ### Справочные данные о ценах - Тарификация: единицы ресурсов плана. - Ориентировочная стоимость запроса: USD 0.008. - Базовая стоимость единицы: USD 0.0. - Единица ресурса: `provider_credit`. - Базовые стоимости не определяют итоговую цену для клиента, в том числе когда они равны нулю. Справочные метаданные, а не коммерческое предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo. ## Base URL - `https://openapi.felo.ai` ## Authentication - `FeloBearerAuth` (http bearer, bearer format Felo API Key) - `FeloApiKey` (apiKey in header `X-API-Key`) ## Parameters | Name | In | Required | Type | Description | | --- | --- | --- | --- | --- | | `category` | query | no | string | Фильтр по категории монет. *См. [`/coins/categories/list`](/reference/coins-categories-list) | | `ids` | query | no | string, default: "bitcoin" | ID монет; через запятую, если запрашивается больше одной монеты. *См. [`/coins/list`](/reference/coins-list) | | `include_rehypothecated` | query | no | boolean | Включать перезаложенные токены (rehypothecated) в результаты. При значении true возвращается поле `market_cap_rank_with_rehypothecated`. По умолчанию: false | | `include_tokens` | query | no | string, enum: "top", "all" | Для запросов `symbols` укажите `all`, чтобы включить все подходящие токены. По умолчанию `top` возвращает токены с самым высоким рейтингом по рыночной капитализации или объёму. | | `locale` | query | no | string, enum: "ar", "bg", "cs", "da", "de", "el", … | Языковой контекст. По умолчанию: en | | `names` | query | no | string, default: "Bitcoin" | Названия монет; через запятую, если запрашивается больше одной монеты. | | `order` | query | no | string, enum: "market_cap_asc", "market_cap_desc", "volume_asc", "volume_desc", "id_asc", "id_desc" | Сортировать результат по полю. По умолчанию: market_cap_desc | | `page` | query | no | integer | Постраничный просмотр результатов. По умолчанию: 1 | | `per_page` | query | no | integer | Всего результатов на страницу. По умолчанию: 100 Допустимые значения: 1...250 | | `precision` | query | no | string, enum: "full", "0", "1", "2", "3", "4", … | Количество десятичных знаков для значения цены в валюте | | `price_change_percentage` | query | no | string | Включать период изменения цены в процентах; через запятую, если запрашивается больше одного периода. Допустимые значения: `1h`, `24h`, `7d`, `14d`, `30d`, `200d`, `1y` | | `sparkline` | query | no | boolean | Включать 7-дневные данные спарклайна. По умолчанию: false | | `symbols` | query | no | string, default: "btc" | Символы монет; через запятую, если запрашивается больше одной монеты. | | `vs_currency` | query | yes | string, default: "usd" | Целевая валюта монет и рыночных данных. *См. [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies) | ## Responses ### 200 — Список монет с рыночными данными Headers: - `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo. **application/json** Schema: `Response860C3Ae68Ea5_CoinsMarkets` (`#/components/schemas/Response860C3Ae68Ea5_CoinsMarkets`) Example: ```json [ { "id": "bitcoin", "symbol": "btc", "name": "Bitcoin", "image": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400", "current_price": 77671, "market_cap": 1555886872303, "market_cap_rank": 1, "fully_diluted_valuation": 1555914058873, "total_volume": 33235034316, "high_24h": 78419, "low_24h": 76696, "price_change_24h": -747.3360347281705, "price_change_percentage_24h": -0.95302, "market_cap_change_24h": -15184401491.513184, "market_cap_change_percentage_24h": -0.9665, "circulating_supply": 20030493, "total_supply": 20030843, "max_supply": 21000000, "ath": 126080, "ath_change_percentage": -38.39571, "ath_date": "2025-10-06T18:57:42.558Z", "atl": 67.81, "atl_change_percentage": 114443.23093, "atl_date": "2013-07-06T00:00:00.000Z", "roi": null, "last_updated": "2026-05-18T12:49:21.599Z", "market_cap_rank_with_rehypothecated": 1, "sparkline_in_7d": { "price": [ 81045.84776489827, 81001.73089268175, 80898.20817826076 ] }, "price_change_percentage_1h_in_currency": 0.5823392426906319, "price_change_percentage_24h_in_currency": -0.9530164743774191, "price_change_percentage_7d_in_currency": -4.042267423689584, "price_change_percentage_14d_in_currency": -1.5720857443461431, "price_change_percentage_30d_in_currency": 1.9453890367549207, "price_change_percentage_200d_in_currency": -29.452371850925864, "price_change_percentage_1y_in_currency": -25.214612207475373 } ] ``` ### 400 — Запрос не удалось обработать. Проверьте параметры запроса. ### 401 — Требуется действительный API-ключ Felo. ### 402 — Запрос не может быть выполнен: не выполнено требование биллинга. ### 403 — Аккаунту не разрешено выполнять эту операцию. ### 429 — Достигнут лимит запросов или расходов. ### 502 — Сервис не смог выполнить запрос. ### 503 — API или сервис биллинга временно недоступны. ### 504 — Истекло время ожидания обработки запроса. ### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера **application/json** Schema: ```json {} ``` ## Schema definitions ### Response860C3Ae68Ea5_CoinsMarkets `#/components/schemas/Response860C3Ae68Ea5_CoinsMarkets` ```json { "type": "array", "items": { "type": "object", "required": [ "id", "symbol", "name", "image", "current_price", "market_cap", "market_cap_rank", "fully_diluted_valuation", "total_volume", "high_24h", "low_24h", "price_change_24h", "price_change_percentage_24h", "market_cap_change_24h", "market_cap_change_percentage_24h", "circulating_supply", "total_supply", "max_supply", "ath", "ath_change_percentage", "ath_date", "atl", "atl_change_percentage", "atl_date", "roi", "last_updated" ], "properties": { "id": { "type": "string", "description": "ID монеты" }, "symbol": { "type": "string", "description": "Символ монеты" }, "name": { "type": "string", "description": "Название монеты" }, "image": { "type": "string", "description": "URL изображения монеты" }, "current_price": { "type": [ "number", "null" ], "description": "Текущая цена в целевой валюте" }, "market_cap": { "type": [ "number", "null" ], "description": "Рыночная капитализация в целевой валюте" }, "market_cap_rank": { "type": [ "integer", "null" ], "description": "Рейтинг рыночной капитализации" }, "fully_diluted_valuation": { "type": [ "number", "null" ], "description": "Полностью разводнённая стоимость в целевой валюте" }, "total_volume": { "type": [ "number", "null" ], "description": "Общий объём торгов в целевой валюте" }, "high_24h": { "type": [ "number", "null" ], "description": "Максимальная цена за 24 часа в целевой валюте" }, "low_24h": { "type": [ "number", "null" ], "description": "Минимальная цена за 24 часа в целевой валюте" }, "price_change_24h": { "type": [ "number", "null" ], "description": "Изменение цены за 24 часа в целевой валюте" }, "price_change_percentage_24h": { "type": [ "number", "null" ], "description": "Процент изменения цены за 24 часа" }, "market_cap_change_24h": { "type": [ "number", "null" ], "description": "Изменение рыночной капитализации за 24 часа в целевой валюте" }, "market_cap_change_percentage_24h": { "type": [ "number", "null" ], "description": "Процент изменения рыночной капитализации за 24 часа" }, "circulating_supply": { "type": [ "number", "null" ], "description": "Циркулирующее предложение" }, "total_supply": { "type": [ "number", "null" ], "description": "Общее предложение" }, "max_supply": { "type": [ "number", "null" ], "description": "Максимальное предложение" }, "ath": { "type": [ "number", "null" ], "description": "Исторический максимум цены в целевой валюте" }, "ath_change_percentage": { "type": [ "number", "null" ], "description": "Процентное изменение исторического максимума" }, "ath_date": { "type": [ "string", "null" ], "format": "date-time", "description": "Дата исторического максимума" }, "atl": { "type": [ "number", "null" ], "description": "Исторический минимум цены в целевой валюте" }, "atl_change_percentage": { "type": [ "number", "null" ], "description": "Процентное изменение исторического минимума" }, "atl_date": { "type": [ "string", "null" ], "format": "date-time", "description": "Дата исторического минимума" }, "roi": { "type": [ "object", "null" ], "description": "Данные рентабельности инвестиций", "properties": { "times": { "type": "number", "description": "Множитель ROI" }, "currency": { "type": "string", "description": "Валюта ROI" }, "percentage": { "type": "number", "description": "Процент ROI" } } }, "last_updated": { "type": "string", "format": "date-time", "description": "Метка времени последнего обновления" }, "market_cap_rank_with_rehypothecated": { "type": [ "integer", "null" ], "description": "Рейтинг рыночной капитализации с учётом регипотецированных токенов" }, "sparkline_in_7d": { "type": "object", "description": "Данные спарклайна цены за последние 7 дней", "properties": { "price": { "type": "array", "items": { "type": "number" }, "description": "Массив значений цены" } } }, "price_change_percentage_1h_in_currency": { "type": [ "number", "null" ], "description": "Процент изменения цены за 1 час в целевой валюте" }, "price_change_percentage_24h_in_currency": { "type": [ "number", "null" ], "description": "Процент изменения цены за 24 часа в целевой валюте" }, "price_change_percentage_7d_in_currency": { "type": [ "number", "null" ], "description": "Процент изменения цены за 7 дней в целевой валюте" }, "price_change_percentage_14d_in_currency": { "type": [ "number", "null" ], "description": "Процент изменения цены за 14 дней в целевой валюте" }, "price_change_percentage_30d_in_currency": { "type": [ "number", "null" ], "description": "Процент изменения цены за 30 дней в целевой валюте" }, "price_change_percentage_200d_in_currency": { "type": [ "number", "null" ], "description": "Процент изменения цены за 200 дней в целевой валюте" }, "price_change_percentage_1y_in_currency": { "type": [ "number", "null" ], "description": "Процент изменения цены за 1 год в целевой валюте" } } } } ```