# 熱門搜尋

**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 — 需要有效的 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"
              }
            }
          }
        }
      }
    }
  }
}
```