# 인기 검색

**API:** Data API

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

**Tags:** CoinGecko

인기 암호화폐 자산을 조회합니다. 필요할 때 문서화된 show_max 입력을 사용하고, 반환되는 카테고리는 응답 스키마를 확인하세요.

### 가격 참고

- 과금 방식: 플랜 리소스 단위.
- 참조 요청 추정치: USD 0.008.
- 단위 원가 기준: USD 0.0.
- 리소스 단위: `provider_credit`.
- 원가 기준은 0인 경우를 포함해 최종 고객 가격을 확정하지 않습니다.

참조 메타데이터일 뿐이며 계정 견적이나 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 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": "코인 스파크라인 이미지 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 컬렉션 스파크라인 이미지 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": "카테고리 스파크라인 이미지 URL"
              }
            }
          }
        }
      }
    }
  }
}
```