# Biểu đồ thị trường đồng tiền theo khoảng thời gian

**API:** Data API

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

**Tags:** CoinGecko

Chuỗi dữ liệu lịch sử cho một đồng tiền giữa hai mốc thời gian rõ ràng. `from` và `to` là dấu thời gian Unix tính bằng giây, trong khi dấu thời gian trong phản hồi tính bằng mili giây — hai đơn vị không giống nhau, đây là nguyên nhân thường gặp của kết quả rỗng hoặc lệch. Trả về `prices`, `market_caps` và `total_volumes` dưới dạng cặp dấu thời gian và giá trị; CoinGecko chọn độ chi tiết theo độ dài cửa sổ. Dùng để căn chuỗi dữ liệu với một cửa sổ sự kiện đã biết. Với cửa sổ trượt kết thúc ở hiện tại, `get_coingecko_coins_id_market_chart` nhận số `days` thay thế.

### Tham chiếu giá

- Đo lường: Đơn vị tài nguyên theo gói.
- Ước tính tham chiếu cho mỗi yêu cầu: USD 0.008.
- Cơ sở chi phí đơn vị: USD 0.0.
- Đơn vị tài nguyên: `provider_credit`.
- Cơ sở chi phí không xác lập giá cuối cùng cho khách hàng, kể cả khi bằng 0.

Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của 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 đồng tiền. *tham chiếu [`/coins/list`](/reference/coins-list). |
| `from` | query | yes | string, default: "2025-12-22" | Ngày bắt đầu dưới dạng chuỗi ngày ISO (`YYYY-MM-DD` hoặc `YYYY-MM-DDTHH:MM`) hoặc dấu thời gian UNIX. **Dùng chuỗi ngày ISO để có khả năng tương thích tốt nhất.** |
| `interval` | query | no | string, enum: "1m", "5m", "hourly", "daily" | Khoảng dữ liệu, để trống để tự động chọn độ chi tiết. |
| `precision` | query | no | string, enum: "full", "0", "1", "2", "3", "4", … | Số chữ số thập phân cho giá trị giá tiền tệ. |
| `to` | query | yes | string, default: "2025-12-31" | Ngày kết thúc dưới dạng chuỗi ngày ISO (`YYYY-MM-DD` hoặc `YYYY-MM-DDTHH:MM`) hoặc dấu thời gian UNIX. **Dùng chuỗi ngày ISO để có khả năng tương thích tốt nhất.** |
| `vs_currency` | query | yes | string, default: "usd" | Đơn vị tiền tệ đích của dữ liệu thị trường. *tham chiếu [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies). |

## Responses

### 200 — Dữ liệu biểu đồ lịch sử đồng tiền trong khoảng thời gian

Headers:
- `X-Request-Id` (string) — Mã định danh yêu cầu cần bao gồm khi liên hệ bộ phận hỗ trợ 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 — Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.

### 401 — Cần có khóa API Felo hợp lệ.

### 402 — Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.

### 403 — Tài khoản không được phép thực hiện thao tác này.

### 429 — Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.

### 502 — Dịch vụ không thể hoàn tất yêu cầu.

### 503 — API hoặc dịch vụ thanh toán tạm thời không khả dụng.

### 504 — Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.

### default — Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp

**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": "Các điểm dữ liệu giá dưới dạng cặp [timestamp, price]",
      "items": {
        "type": "array",
        "items": {
          "type": "number"
        }
      }
    },
    "market_caps": {
      "type": "array",
      "description": "Các điểm dữ liệu vốn hóa thị trường dưới dạng cặp [timestamp, market_cap]",
      "items": {
        "type": "array",
        "items": {
          "type": "number"
        }
      }
    },
    "total_volumes": {
      "type": "array",
      "description": "Các điểm dữ liệu tổng khối lượng dưới dạng cặp [timestamp, volume]",
      "items": {
        "type": "array",
        "items": {
          "type": "number"
        }
      }
    }
  }
}
```
