# Трендовый поиск

**API:** Data API

**Endpoint:** `GET /v1/beta/coingecko/search/trending`

**Tags:** CoinGecko

Получает трендовые криптоактивы. При необходимости используйте документированный вход show_max; возвращаемые категории смотрите в схеме ответа.

### Справочные данные о ценах

- Тарификация: единицы ресурсов плана.
- Ориентировочная стоимость запроса: 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 |
| --- | --- | --- | --- | --- |
| `show_max` | query | no | string | Показывает максимальное число доступных результатов для указанного типа. Доступные значения: `coins`, `nfts`, `categories` например, `coins` или `coins,nfts,categories` |

## Responses

### 200 — Трендовые монеты, NFT и категории поиска

Headers:
- `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo.

**application/json**

Schema: `Response860C3Ae68Ea5_TrendingSearch` (`#/components/schemas/Response860C3Ae68Ea5_TrendingSearch`)

Example:

```json
{
  "coins": [
    {
      "item": {
        "id": "bonk",
        "coin_id": 28600,
        "name": "Bonk",
        "symbol": "BONK",
        "market_cap_rank": 103,
        "thumb": "https://coin-images.coingecko.com/coins/images/28600/standard/bonk.jpg?1696527587",
        "small": "https://coin-images.coingecko.com/coins/images/28600/small/bonk.jpg?1696527587",
        "large": "https://coin-images.coingecko.com/coins/images/28600/large/bonk.jpg?1696527587",
        "slug": "bonk",
        "price_btc": 7.821066970851871e-11,
        "score": 0,
        "data": {
          "price": 0.000005938674704566297,
          "price_btc": "0.00000000007821066970851871",
          "price_change_percentage_24h": {
            "usd": -3.2712597351582655,
            "btc": -1.2567575303632434
          },
          "market_cap": "$521,967,819",
          "market_cap_btc": "6883.418982779206",
          "total_volume": "$31,701,707",
          "total_volume_btc": "417.50253280497",
          "sparkline": "https://www.coingecko.com/coins/28600/sparkline.svg",
          "content": null
        }
      }
    }
  ],
  "nfts": [
    {
      "id": "beeple-everydays-the-2020-collection",
      "name": "BEEPLE: EVERYDAYS - THE 2020 COLLECTION",
      "symbol": "BEEPLE2",
      "thumb": "https://coin-images.coingecko.com/nft_contracts/images/1327/standard/beeple-everydays-the-2020-collection.jpg?1707287783",
      "nft_contract_id": 1327,
      "native_currency_symbol": "eth",
      "floor_price_in_native_currency": 6.98,
      "floor_price_24h_percentage_change": 8.231790820932737,
      "data": {
        "floor_price": "6.98 ETH",
        "floor_price_in_usd_24h_percentage_change": "8.231790820932737",
        "h24_volume": "6.10 ETH",
        "h24_average_sale_price": "6.10 ETH",
        "sparkline": "https://www.coingecko.com/nft/1327/sparkline.svg",
        "content": null
      }
    }
  ],
  "categories": [
    {
      "id": 102120809,
      "name": "Base Native",
      "top_3_coins_images": [
        "https://assets.coingecko.com/coins/images/40008/small/USR_LOGO.png?1725222638",
        "https://assets.coingecko.com/coins/images/13187/small/7739.png?1696512969",
        "https://assets.coingecko.com/coins/images/70556/small/elizaOS_token_logo_high_quality.png?1763494093"
      ],
      "market_cap_1h_change": 0.1591461077485745,
      "slug": "base-native",
      "coins_count": "573",
      "data": {
        "market_cap": 117316549202.14426,
        "market_cap_btc": 1545658.5276991604,
        "total_volume": 16971131961.734743,
        "total_volume_btc": 223596.5430262045,
        "market_cap_change_percentage_24h": {
          "usd": 0.14714515711689605,
          "btc": 1.5918443786835867
        },
        "sparkline": "https://www.coingecko.com/categories/102120809/sparkline.svg"
      }
    }
  ]
}
```

### 400 — Запрос не удалось обработать. Проверьте параметры запроса.

### 401 — Требуется действительный API-ключ Felo.

### 402 — Запрос не может быть выполнен: не выполнено требование биллинга.

### 403 — Аккаунту не разрешено выполнять эту операцию.

### 429 — Достигнут лимит запросов или расходов.

### 502 — Сервис не смог выполнить запрос.

### 503 — API или сервис биллинга временно недоступны.

### 504 — Истекло время ожидания обработки запроса.

### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response860C3Ae68Ea5_TrendingSearch

`#/components/schemas/Response860C3Ae68Ea5_TrendingSearch`

```json
{
  "type": "object",
  "required": [
    "coins",
    "nfts",
    "categories"
  ],
  "properties": {
    "coins": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "item"
        ],
        "properties": {
          "item": {
            "type": "object",
            "required": [
              "id",
              "coin_id",
              "name",
              "symbol",
              "market_cap_rank",
              "thumb",
              "small",
              "large",
              "slug",
              "price_btc",
              "score",
              "data"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "ID монеты"
              },
              "coin_id": {
                "type": "integer",
                "description": "Внутренний ID монеты"
              },
              "name": {
                "type": "string",
                "description": "Название монеты"
              },
              "symbol": {
                "type": "string",
                "description": "Символ монеты"
              },
              "market_cap_rank": {
                "type": "integer",
                "description": "Ранг рыночной капитализации монеты"
              },
              "thumb": {
                "type": "string",
                "description": "URL миниатюры монеты"
              },
              "small": {
                "type": "string",
                "description": "URL маленького изображения монеты"
              },
              "large": {
                "type": "string",
                "description": "URL большого изображения монеты"
              },
              "slug": {
                "type": "string",
                "description": "Веб-слаг монеты"
              },
              "price_btc": {
                "type": "number",
                "description": "Цена монеты в BTC"
              },
              "score": {
                "type": "integer",
                "description": "Ранг тренда монеты (начиная с 0)"
              },
              "data": {
                "type": "object",
                "required": [
                  "price",
                  "price_btc",
                  "price_change_percentage_24h",
                  "market_cap",
                  "market_cap_btc",
                  "total_volume",
                  "total_volume_btc",
                  "sparkline",
                  "content"
                ],
                "properties": {
                  "price": {
                    "type": "number",
                    "description": "Цена монеты в USD"
                  },
                  "price_btc": {
                    "type": "string",
                    "description": "Цена монеты в BTC"
                  },
                  "price_change_percentage_24h": {
                    "type": "object",
                    "description": "Процент изменения цены монеты за 24 часа по каждой валюте",
                    "additionalProperties": {
                      "type": "number"
                    }
                  },
                  "market_cap": {
                    "type": "string",
                    "description": "Рыночная капитализация монеты в USD"
                  },
                  "market_cap_btc": {
                    "type": "string",
                    "description": "Рыночная капитализация монеты в BTC"
                  },
                  "total_volume": {
                    "type": "string",
                    "description": "Общий объём монеты в USD"
                  },
                  "total_volume_btc": {
                    "type": "string",
                    "description": "Общий объём монеты в BTC"
                  },
                  "sparkline": {
                    "type": "string",
                    "description": "URL изображения спарклайна монеты"
                  },
                  "content": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "properties": {
                      "title": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "nfts": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "name",
          "symbol",
          "thumb",
          "nft_contract_id",
          "native_currency_symbol",
          "floor_price_in_native_currency",
          "floor_price_24h_percentage_change",
          "data"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "ID коллекции NFT"
          },
          "name": {
            "type": "string",
            "description": "Название коллекции NFT"
          },
          "symbol": {
            "type": "string",
            "description": "Символ коллекции NFT"
          },
          "thumb": {
            "type": "string",
            "description": "URL миниатюры коллекции NFT"
          },
          "nft_contract_id": {
            "type": "integer",
            "description": "Внутренний ID контракта NFT"
          },
          "native_currency_symbol": {
            "type": "string",
            "description": "Символ нативной валюты коллекции NFT"
          },
          "floor_price_in_native_currency": {
            "type": "number",
            "description": "Минимальная цена коллекции NFT в нативной валюте"
          },
          "floor_price_24h_percentage_change": {
            "type": "number",
            "description": "Процент изменения минимальной цены коллекции NFT за 24 часа"
          },
          "data": {
            "type": "object",
            "required": [
              "floor_price",
              "floor_price_in_usd_24h_percentage_change",
              "h24_volume",
              "h24_average_sale_price",
              "sparkline",
              "content"
            ],
            "properties": {
              "floor_price": {
                "type": "string",
                "description": "Минимальная цена коллекции NFT"
              },
              "floor_price_in_usd_24h_percentage_change": {
                "type": "string",
                "description": "Процент изменения минимальной цены коллекции NFT в USD за 24 часа"
              },
              "h24_volume": {
                "type": "string",
                "description": "Объём коллекции NFT за 24 часа"
              },
              "h24_average_sale_price": {
                "type": "string",
                "description": "Средняя цена продажи коллекции NFT за 24 часа"
              },
              "sparkline": {
                "type": "string",
                "description": "URL изображения спарклайна коллекции NFT"
              },
              "content": {
                "type": [
                  "object",
                  "null"
                ],
                "properties": {
                  "title": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      }
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "name",
          "top_3_coins_images",
          "market_cap_1h_change",
          "slug",
          "coins_count",
          "data"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "description": "ID категории"
          },
          "name": {
            "type": "string",
            "description": "Название категории"
          },
          "top_3_coins_images": {
            "type": "array",
            "description": "URL изображений 3 лучших монет категории",
            "items": {
              "type": "string"
            }
          },
          "market_cap_1h_change": {
            "type": "number",
            "description": "Изменение рыночной капитализации категории за 1 час"
          },
          "slug": {
            "type": "string",
            "description": "Веб-слаг категории"
          },
          "coins_count": {
            "type": "string",
            "description": "Число монет в категории"
          },
          "data": {
            "type": "object",
            "required": [
              "market_cap",
              "market_cap_btc",
              "total_volume",
              "total_volume_btc",
              "market_cap_change_percentage_24h",
              "sparkline"
            ],
            "properties": {
              "market_cap": {
                "type": "number",
                "description": "Рыночная капитализация категории"
              },
              "market_cap_btc": {
                "type": "number",
                "description": "Рыночная капитализация категории в BTC"
              },
              "total_volume": {
                "type": "number",
                "description": "Общий объём категории"
              },
              "total_volume_btc": {
                "type": "number",
                "description": "Общий объём категории в BTC"
              },
              "market_cap_change_percentage_24h": {
                "type": "object",
                "description": "Процент изменения рыночной капитализации категории за 24 часа по каждой валюте",
                "additionalProperties": {
                  "type": "number"
                }
              },
              "sparkline": {
                "type": "string",
                "description": "URL изображения спарклайна категории"
              }
            }
          }
        }
      }
    }
  }
}
```