# 코인 시장 차트 범위

**API:** Data API

**Endpoint:** `GET /v1/beta/coingecko/coins/{id}/market_chart/range`

**Tags:** CoinGecko

한 코인의 두 명시적 시점 사이 이력 시계열입니다. `from`과 `to`는 초 단위 Unix 타임스탬프인 반면 응답 내부 타임스탬프는 밀리초 단위입니다. 두 값은 단위가 다르며, 이는 빈 결과나 잘못 정렬된 결과의 흔한 원인입니다. `prices`, `market_caps`, `total_volumes`를 타임스탬프-값 쌍으로 반환하며, CoinGecko가 기간 길이에 따라 세분성을 선택합니다. 알려진 이벤트 기간에 시계열을 맞출 때 사용하세요. 현재까지의 최근 기간은 `get_coingecko_coins_id_market_chart`가 `days` 개수를 받습니다.

### 가격 참고

- 과금 방식: 플랜 리소스 단위.
- 참조 요청 추정치: 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 |
| --- | --- | --- | --- | --- |
| `id` | path | yes | string, default: "bitcoin" | 코인 ID입니다. *참조: [`/coins/list`](/reference/coins-list). |
| `from` | query | yes | string, default: "2025-12-22" | ISO 날짜 문자열(`YYYY-MM-DD` 또는 `YYYY-MM-DDTHH:MM`) 또는 UNIX 타임스탬프로 된 시작 날짜입니다. **최상의 호환성을 위해 ISO 날짜 문자열을 사용하세요.** |
| `interval` | query | no | string, enum: "1m", "5m", "hourly", "daily" | 데이터 간격입니다. 비워 두면 자동 세분화가 적용됩니다. |
| `precision` | query | no | string, enum: "full", "0", "1", "2", "3", "4", … | 통화 가격 값의 소수 자릿수입니다. |
| `to` | query | yes | string, default: "2025-12-31" | ISO 날짜 문자열(`YYYY-MM-DD` 또는 `YYYY-MM-DDTHH:MM`) 또는 UNIX 타임스탬프로 된 종료 날짜입니다. **최상의 호환성을 위해 ISO 날짜 문자열을 사용하세요.** |
| `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_CoinsMarketChart` (`#/components/schemas/Response860C3Ae68Ea5_CoinsMarketChart`)

Example:

```json
{
  "prices": [
    [
      1779027899041,
      77953.82550382407
    ],
    [
      1779028199661,
      78052.87543398788
    ]
  ],
  "market_caps": [
    [
      1779027899041,
      1560631481361.8042
    ],
    [
      1779028199661,
      1562027330524.267
    ]
  ],
  "total_volumes": [
    [
      1779027899041,
      18688431751.857048
    ],
    [
      1779028199661,
      18974828816.446976
    ]
  ]
}
```

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

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

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

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

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

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

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

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

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

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response860C3Ae68Ea5_CoinsMarketChart

`#/components/schemas/Response860C3Ae68Ea5_CoinsMarketChart`

```json
{
  "type": "object",
  "required": [
    "prices",
    "market_caps",
    "total_volumes"
  ],
  "properties": {
    "prices": {
      "type": "array",
      "description": "[timestamp, price] 쌍으로 된 가격 데이터 포인트",
      "items": {
        "type": "array",
        "items": {
          "type": "number"
        }
      }
    },
    "market_caps": {
      "type": "array",
      "description": "[timestamp, market_cap] 쌍으로 된 시가총액 데이터 포인트",
      "items": {
        "type": "array",
        "items": {
          "type": "number"
        }
      }
    },
    "total_volumes": {
      "type": "array",
      "description": "[timestamp, volume] 쌍으로 된 총 거래량 데이터 포인트",
      "items": {
        "type": "array",
        "items": {
          "type": "number"
        }
      }
    }
  }
}
```