# Lấy dữ liệu giá cổ phiếu lịch sử

**API:** Data API

**Endpoint:** `GET /v1/beta/financial/prices`

**Tags:** Financial Data

Các thanh OHLCV lịch sử cho một cổ phiếu. Cả bốn `ticker`, `interval`, `start_date` và `end_date` đều là bộ chọn — không có lối tắt cửa sổ trượt. `interval` là một trong day, week, month hoặc year. Mỗi thanh mang `open`, `close`, `high`, `low`, `volume` và `time`, được bọc trong mảng `prices` cùng `ticker` được trả về nguyên văn. Dùng để vẽ biểu đồ hoặc đo mức biến động trong một cửa sổ đã biết. Chỉ cần giá mới nhất thì dùng `get_financial_prices_snapshot`.

### Tham chiếu giá

- Đo lường: Cơ sở chi phí cố định theo yêu cầu thành công.
- Ước tính tham chiếu cho mỗi yêu cầu: USD 0.02.
- Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại cho số tiền khách hàng đã quyết toán.

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 |
| --- | --- | --- | --- | --- |
| `end_date` | query | no | string |  |
| `interval` | query | no | string |  |
| `interval_multiplier` | query | no | string |  |
| `start_date` | query | no | string |  |
| `ticker` | query | no | string |  |

## Responses

### 200 — Phản hồi dữ liệu giá

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: `ResponseE40Feb4D3D6B_PricesResponse` (`#/components/schemas/ResponseE40Feb4D3D6B_PricesResponse`)

### 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

### ResponseE40Feb4D3D6B_Price

`#/components/schemas/ResponseE40Feb4D3D6B_Price`

```json
{
  "type": "object",
  "properties": {
    "open": {
      "type": "number",
      "description": "Giá mở cửa của mã ticker trong khoảng thời gian đã cho."
    },
    "close": {
      "type": "number",
      "description": "Giá đóng cửa của mã ticker trong khoảng thời gian đã cho."
    },
    "high": {
      "type": "number",
      "description": "Giá cao nhất của mã ticker trong khoảng thời gian đã cho."
    },
    "low": {
      "type": "number",
      "description": "Giá thấp nhất của mã ticker trong khoảng thời gian đã cho."
    },
    "volume": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Khối lượng giao dịch của mã ticker trong khoảng thời gian đã cho."
    },
    "time": {
      "type": "string",
      "description": "Định dạng thời gian dễ đọc của giá theo UTC."
    }
  }
}
```

### ResponseE40Feb4D3D6B_PricesResponse

`#/components/schemas/ResponseE40Feb4D3D6B_PricesResponse`

```json
{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Mã ticker."
    },
    "prices": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_Price"
      }
    },
    "next_page_url": {
      "type": "string",
      "description": "URL tuyệt đối của trang kết quả tiếp theo. Chỉ xuất hiện khi còn kết quả; hãy yêu cầu nguyên văn để tiếp tục. Mỗi trang chứa tối đa 100 bản ghi."
    }
  }
}
```
