# 간단 가격

**API:** Data API

**Endpoint:** `GET /v1/beta/coingecko/simple/price`

**Tags:** CoinGecko

필드 이름은 기준 통화에서 만들어집니다. `vs_currencies`를 usd로 설정하면 `usd`를 받고, 해당 `include_market_cap`, `include_24hr_vol`, `include_24hr_change`, `include_last_updated_at` 플래그가 설정되면 `usd_market_cap`, `usd_24h_vol`, `usd_24h_change`, `last_updated_at`도 받습니다. id를 이미 알고 현재 숫자만 필요할 때마다 사용하세요. 순위, 공급량, 사상 최고가 데이터는 `get_coingecko_coins_markets`, id 대신 컨트랙트 주소가 있다면 `get_coingecko_simple_token_price_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 |
| --- | --- | --- | --- | --- |
| `ids` | query | no | string, default: "bitcoin" | 코인 ID입니다. 코인을 2개 이상 조회할 때는 쉼표로 구분합니다. *참조: [`/coins/list`](/reference/coins-list) |
| `include_24hr_change` | query | no | boolean | 24시간 변동률을 포함합니다. 기본값: false |
| `include_24hr_vol` | query | no | boolean | 24시간 거래량을 포함합니다. 기본값: false |
| `include_last_updated_at` | query | no | boolean | 마지막 가격 업데이트 시간을 UNIX 타임스탬프로 포함합니다. 기본값: false |
| `include_market_cap` | query | no | boolean | 시가총액을 포함합니다. 기본값: false |
| `include_tokens` | query | no | string, enum: "top", "all" | `symbols` 조회에서는 `all`을 지정해 일치하는 모든 토큰을 포함할 수 있습니다. 기본값 `top`은 시가총액 또는 거래량 기준 상위 토큰을 반환합니다. |
| `names` | query | no | string, default: "Bitcoin" | 코인 이름입니다. 코인을 2개 이상 조회할 때는 쉼표로 구분합니다. |
| `precision` | query | no | string, enum: "full", "0", "1", "2", "3", "4", … | 통화 가격 값의 소수 자릿수 |
| `symbols` | query | no | string, default: "btc" | 코인 심볼입니다. 코인을 2개 이상 조회할 때는 쉼표로 구분합니다. |
| `vs_currencies` | query | yes | string, default: "usd" | 코인의 대상 통화이며, 통화가 2개 이상이면 쉼표로 구분합니다. *[`/simple/supported_vs_currencies`](/reference/simple-supported-currencies)를 참조하세요. |

## Responses

### 200 — 코인 가격

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

**application/json**

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

Example:

```json
{
  "bitcoin": {
    "usd": 76975,
    "usd_market_cap": 1542226908349.8406,
    "usd_24h_vol": 29096603418.89408,
    "usd_24h_change": -1.4093297098441402,
    "last_updated_at": 1779092258
  }
}
```

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

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

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

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

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

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

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

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

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

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response860C3Ae68Ea5_SimplePrice

`#/components/schemas/Response860C3Ae68Ea5_SimplePrice`

```json
{
  "type": "object",
  "additionalProperties": {
    "type": "object",
    "properties": {
      "usd": {
        "type": "number",
        "description": "대상 통화 기준 가격"
      },
      "usd_market_cap": {
        "type": "number",
        "description": "대상 통화 기준 시가총액"
      },
      "usd_24h_vol": {
        "type": "number",
        "description": "대상 통화 기준 24시간 거래량"
      },
      "usd_24h_change": {
        "type": "number",
        "description": "대상 통화 기준 24시간 가격 변동률"
      },
      "last_updated_at": {
        "type": "number",
        "description": "UNIX 초 단위 최근 업데이트 타임스탬프"
      }
    }
  }
}
```