# 热门搜索

**API:** Data API

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

**Tags:** CoinGecko

获取热门加密资产。需要时使用文档中说明的 show_max 输入；返回的分类请查看响应 schema。

### 计费参考

- 计量方式：套餐资源单位。
- 参考请求估算：0.008 美元。
- 单位成本基准：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 — 需要有效的 Felo API 密钥。

### 402 — 由于未满足计费要求，请求无法继续。

### 403 — 该账户无权执行此操作。

### 429 — 已达到请求或支出限额。

### 502 — 服务无法完成该请求。

### 503 — API 或计费服务暂时不可用。

### 504 — 服务在处理请求时超时。

### default — 错误响应；上游透传响应可能采用提供方格式

**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": "代币网页 slug"
              },
              "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": "代币价格（美元）"
                  },
                  "price_btc": {
                    "type": "string",
                    "description": "代币价格（BTC）"
                  },
                  "price_change_percentage_24h": {
                    "type": "object",
                    "description": "按货币统计的代币 24 小时价格涨跌幅",
                    "additionalProperties": {
                      "type": "number"
                    }
                  },
                  "market_cap": {
                    "type": "string",
                    "description": "代币市值（美元）"
                  },
                  "market_cap_btc": {
                    "type": "string",
                    "description": "代币市值（BTC）"
                  },
                  "total_volume": {
                    "type": "string",
                    "description": "代币总交易量（美元）"
                  },
                  "total_volume_btc": {
                    "type": "string",
                    "description": "代币总交易量（BTC）"
                  },
                  "sparkline": {
                    "type": "string",
                    "description": "代币 sparkline 图片 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": "NFT 合集 ID"
          },
          "name": {
            "type": "string",
            "description": "NFT 合集名称"
          },
          "symbol": {
            "type": "string",
            "description": "NFT 合集符号"
          },
          "thumb": {
            "type": "string",
            "description": "NFT 合集缩略图 URL"
          },
          "nft_contract_id": {
            "type": "integer",
            "description": "NFT 合约内部 ID"
          },
          "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 合集地板价（美元）的 24 小时涨跌幅"
              },
              "h24_volume": {
                "type": "string",
                "description": "NFT 合集 24 小时交易量"
              },
              "h24_average_sale_price": {
                "type": "string",
                "description": "NFT 合集 24 小时平均售价"
              },
              "sparkline": {
                "type": "string",
                "description": "NFT 合集 sparkline 图片 URL"
              },
              "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",
            "items": {
              "type": "string"
            }
          },
          "market_cap_1h_change": {
            "type": "number",
            "description": "分类市值 1 小时变动"
          },
          "slug": {
            "type": "string",
            "description": "分类网页 slug"
          },
          "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": "分类 sparkline 图片 URL"
              }
            }
          }
        }
      }
    }
  }
}
```