# トレンド検索

**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": "トークンのウェブスラッグ"
              },
              "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": "トークンの 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 コレクションのフロア価格（USD）の 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": "カテゴリ内の上位 3 トークンの画像 URL",
            "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": "カテゴリの sparkline 画像 URL"
              }
            }
          }
        }
      }
    }
  }
}
```