# 코인 시장

**API:** Data API

**Endpoint:** `GET /v1/beta/coingecko/coins/markets`

**Tags:** CoinGecko

한 번의 호출로 많은 코인을 다루는 순위 시장 표입니다. 코인당 한 행에 `current_price`, `market_cap`, `market_cap_rank`, `total_volume`, `high_24h`, `low_24h`, `price_change_percentage_24h`, `circulating_supply`, `total_supply`, `max_supply`, 날짜가 포함된 `ath`와 `atl`, `image`가 들어갑니다. `per_page`와 `page`로 페이지를 나누고, `order`(시가총액, 거래량 또는 id, 오름차순/내림차순)로 정렬하며, `ids` 또는 `category`로 좁히세요. `price_change_percentage`를 전달하면 해당하는 `price_change_percentage_24h_in_currency` 필드가 추가됩니다. 리더보드와 세그먼트 스캔에 사용하세요. 몇 개의 알려진 코인 가격은 `get_coingecko_simple_price`가 훨씬 가볍고, 한 코인의 전체 정보는 `get_coingecko_coins_id`를 사용하세요.

### 가격 참고

- 과금 방식: 플랜 리소스 단위.
- 참조 요청 추정치: 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 |
| --- | --- | --- | --- | --- |
| `category` | query | no | string | 코인 카테고리를 기준으로 필터링합니다. *참조: [`/coins/categories/list`](/reference/coins-categories-list) |
| `ids` | query | no | string, default: "bitcoin" | 코인 ID입니다. 코인을 2개 이상 조회할 때는 쉼표로 구분합니다. *참조: [`/coins/list`](/reference/coins-list) |
| `include_rehypothecated` | query | no | boolean | 결과에 재담보화된(rehypothecated) 토큰을 포함합니다. true이면 `market_cap_rank_with_rehypothecated` 필드를 반환합니다. 기본값: false |
| `include_tokens` | query | no | string, enum: "top", "all" | `symbols` 조회에서는 `all`을 지정해 일치하는 모든 토큰을 포함할 수 있습니다. 기본값 `top`은 시가총액 또는 거래량 기준 상위 토큰을 반환합니다. |
| `locale` | query | no | string, enum: "ar", "bg", "cs", "da", "de", "el", … | 언어 배경입니다. 기본값: en |
| `names` | query | no | string, default: "Bitcoin" | 코인 이름입니다. 코인을 2개 이상 조회할 때는 쉼표로 구분합니다. |
| `order` | query | no | string, enum: "market_cap_asc", "market_cap_desc", "volume_asc", "volume_desc", "id_asc", "id_desc" | 필드별로 결과를 정렬합니다. 기본값: market_cap_desc |
| `page` | query | no | integer | 결과를 페이지 단위로 조회합니다. 기본값: 1 |
| `per_page` | query | no | integer | 페이지당 총 결과 수입니다. 기본값: 100 유효한 값: 1...250 |
| `precision` | query | no | string, enum: "full", "0", "1", "2", "3", "4", … | 통화 가격 값의 소수 자릿수 |
| `price_change_percentage` | query | no | string | 가격 변동률 기간을 포함합니다. 기간을 2개 이상 조회할 때는 쉼표로 구분합니다. 유효한 값: `1h`, `24h`, `7d`, `14d`, `30d`, `200d`, `1y` |
| `sparkline` | query | no | boolean | 7일 스파크라인 데이터를 포함합니다. 기본값: false |
| `symbols` | query | no | string, default: "btc" | 코인 심볼입니다. 코인을 2개 이상 조회할 때는 쉼표로 구분합니다. |
| `vs_currency` | query | yes | string, default: "usd" | 코인 및 시장 데이터의 대상 통화입니다. *참조: [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies) |

## Responses

### 200 — 시장 데이터가 포함된 코인 목록

Headers:
- `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다.

**application/json**

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

Example:

```json
[
  {
    "id": "bitcoin",
    "symbol": "btc",
    "name": "Bitcoin",
    "image": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
    "current_price": 77671,
    "market_cap": 1555886872303,
    "market_cap_rank": 1,
    "fully_diluted_valuation": 1555914058873,
    "total_volume": 33235034316,
    "high_24h": 78419,
    "low_24h": 76696,
    "price_change_24h": -747.3360347281705,
    "price_change_percentage_24h": -0.95302,
    "market_cap_change_24h": -15184401491.513184,
    "market_cap_change_percentage_24h": -0.9665,
    "circulating_supply": 20030493,
    "total_supply": 20030843,
    "max_supply": 21000000,
    "ath": 126080,
    "ath_change_percentage": -38.39571,
    "ath_date": "2025-10-06T18:57:42.558Z",
    "atl": 67.81,
    "atl_change_percentage": 114443.23093,
    "atl_date": "2013-07-06T00:00:00.000Z",
    "roi": null,
    "last_updated": "2026-05-18T12:49:21.599Z",
    "market_cap_rank_with_rehypothecated": 1,
    "sparkline_in_7d": {
      "price": [
        81045.84776489827,
        81001.73089268175,
        80898.20817826076
      ]
    },
    "price_change_percentage_1h_in_currency": 0.5823392426906319,
    "price_change_percentage_24h_in_currency": -0.9530164743774191,
    "price_change_percentage_7d_in_currency": -4.042267423689584,
    "price_change_percentage_14d_in_currency": -1.5720857443461431,
    "price_change_percentage_30d_in_currency": 1.9453890367549207,
    "price_change_percentage_200d_in_currency": -29.452371850925864,
    "price_change_percentage_1y_in_currency": -25.214612207475373
  }
]
```

### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.

### 401 — 유효한 Felo API 키가 필요합니다.

### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.

### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다.

### 429 — 요청 또는 지출 한도에 도달했습니다.

### 502 — 서비스가 요청을 완료할 수 없습니다.

### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.

### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다.

### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response860C3Ae68Ea5_CoinsMarkets

`#/components/schemas/Response860C3Ae68Ea5_CoinsMarkets`

```json
{
  "type": "array",
  "items": {
    "type": "object",
    "required": [
      "id",
      "symbol",
      "name",
      "image",
      "current_price",
      "market_cap",
      "market_cap_rank",
      "fully_diluted_valuation",
      "total_volume",
      "high_24h",
      "low_24h",
      "price_change_24h",
      "price_change_percentage_24h",
      "market_cap_change_24h",
      "market_cap_change_percentage_24h",
      "circulating_supply",
      "total_supply",
      "max_supply",
      "ath",
      "ath_change_percentage",
      "ath_date",
      "atl",
      "atl_change_percentage",
      "atl_date",
      "roi",
      "last_updated"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "코인 ID"
      },
      "symbol": {
        "type": "string",
        "description": "코인 심볼"
      },
      "name": {
        "type": "string",
        "description": "코인 이름"
      },
      "image": {
        "type": "string",
        "description": "코인 이미지 URL"
      },
      "current_price": {
        "type": [
          "number",
          "null"
        ],
        "description": "대상 통화 기준 현재 가격"
      },
      "market_cap": {
        "type": [
          "number",
          "null"
        ],
        "description": "대상 통화 기준 시가총액"
      },
      "market_cap_rank": {
        "type": [
          "integer",
          "null"
        ],
        "description": "시가총액 순위"
      },
      "fully_diluted_valuation": {
        "type": [
          "number",
          "null"
        ],
        "description": "대상 통화 기준 완전 희석 가치"
      },
      "total_volume": {
        "type": [
          "number",
          "null"
        ],
        "description": "대상 통화 기준 총 거래량"
      },
      "high_24h": {
        "type": [
          "number",
          "null"
        ],
        "description": "대상 통화 기준 24시간 최고가"
      },
      "low_24h": {
        "type": [
          "number",
          "null"
        ],
        "description": "대상 통화 기준 24시간 최저가"
      },
      "price_change_24h": {
        "type": [
          "number",
          "null"
        ],
        "description": "대상 통화 기준 24시간 가격 변동"
      },
      "price_change_percentage_24h": {
        "type": [
          "number",
          "null"
        ],
        "description": "24시간 가격 변동률"
      },
      "market_cap_change_24h": {
        "type": [
          "number",
          "null"
        ],
        "description": "대상 통화 기준 24시간 시가총액 변동"
      },
      "market_cap_change_percentage_24h": {
        "type": [
          "number",
          "null"
        ],
        "description": "24시간 시가총액 변동률"
      },
      "circulating_supply": {
        "type": [
          "number",
          "null"
        ],
        "description": "유통 공급량"
      },
      "total_supply": {
        "type": [
          "number",
          "null"
        ],
        "description": "총 공급량"
      },
      "max_supply": {
        "type": [
          "number",
          "null"
        ],
        "description": "최대 공급량"
      },
      "ath": {
        "type": [
          "number",
          "null"
        ],
        "description": "대상 통화 기준 사상 최고가"
      },
      "ath_change_percentage": {
        "type": [
          "number",
          "null"
        ],
        "description": "사상 최고가 대비 변화율"
      },
      "ath_date": {
        "type": [
          "string",
          "null"
        ],
        "format": "date-time",
        "description": "사상 최고가 날짜"
      },
      "atl": {
        "type": [
          "number",
          "null"
        ],
        "description": "대상 통화 기준 사상 최저가"
      },
      "atl_change_percentage": {
        "type": [
          "number",
          "null"
        ],
        "description": "사상 최저가 대비 변화율"
      },
      "atl_date": {
        "type": [
          "string",
          "null"
        ],
        "format": "date-time",
        "description": "사상 최저가 날짜"
      },
      "roi": {
        "type": [
          "object",
          "null"
        ],
        "description": "투자 수익률 데이터",
        "properties": {
          "times": {
            "type": "number",
            "description": "ROI 배수"
          },
          "currency": {
            "type": "string",
            "description": "ROI 통화"
          },
          "percentage": {
            "type": "number",
            "description": "ROI 비율"
          }
        }
      },
      "last_updated": {
        "type": "string",
        "format": "date-time",
        "description": "마지막 업데이트 타임스탬프"
      },
      "market_cap_rank_with_rehypothecated": {
        "type": [
          "integer",
          "null"
        ],
        "description": "재담보 토큰을 포함한 시가총액 순위"
      },
      "sparkline_in_7d": {
        "type": "object",
        "description": "최근 7일 스파크라인 가격 데이터",
        "properties": {
          "price": {
            "type": "array",
            "items": {
              "type": "number"
            },
            "description": "가격 값 배열"
          }
        }
      },
      "price_change_percentage_1h_in_currency": {
        "type": [
          "number",
          "null"
        ],
        "description": "대상 통화 기준 1시간 가격 변동률"
      },
      "price_change_percentage_24h_in_currency": {
        "type": [
          "number",
          "null"
        ],
        "description": "대상 통화 기준 24시간 가격 변동률"
      },
      "price_change_percentage_7d_in_currency": {
        "type": [
          "number",
          "null"
        ],
        "description": "대상 통화 기준 7일 가격 변동률"
      },
      "price_change_percentage_14d_in_currency": {
        "type": [
          "number",
          "null"
        ],
        "description": "대상 통화 기준 14일 가격 변동률"
      },
      "price_change_percentage_30d_in_currency": {
        "type": [
          "number",
          "null"
        ],
        "description": "대상 통화 기준 30일 가격 변동률"
      },
      "price_change_percentage_200d_in_currency": {
        "type": [
          "number",
          "null"
        ],
        "description": "대상 통화 기준 200일 가격 변동률"
      },
      "price_change_percentage_1y_in_currency": {
        "type": [
          "number",
          "null"
        ],
        "description": "대상 통화 기준 1년 가격 변동률"
      }
    }
  }
}
```