> ## Documentation Index
> Fetch the complete documentation index at: https://docs.data-hub.verolabs.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Tổng quan

> Vero Data Hub API cung cấp dữ liệu thị trường, dữ liệu cơ bản, tin tức và dữ liệu tham chiếu qua REST

<div style={{ width: '100%', height: 240, marginBottom: 32, borderRadius: 16, overflow: 'hidden', position: 'relative' }}>
  <video style={{ width: '100%', height: '100%', objectFit: 'cover', filter: 'sepia(0.3) saturate(1.5) hue-rotate(-14deg) brightness(0.72) contrast(1.12)' }} autoPlay loop muted playsInline>
    <source src="https://mintcdn.com/vero-fa5575b5/G_sL_RHXpWEXOwUp/images/bg_video.mp4?fit=max&auto=format&n=G_sL_RHXpWEXOwUp&q=85&s=f731a6a676fb99a2368193fbaf3281ee" type="video/mp4" data-path="images/bg_video.mp4" />
  </video>
</div>

<div style={{ width: '100%', height: 4, marginBottom: 24, borderRadius: 2, background: 'rgba(0,0,0,0.08)' }}>
  <div style={{ width: '12.5%', height: '100%', borderRadius: 2, background: 'linear-gradient(90deg, var(--accent-primary) 0%, var(--accent-light) 50%, var(--accent-dark) 100%)' }} />
</div>

Vero Data Hub API giúp ứng dụng truy cập dữ liệu tài chính qua REST/JSON. Tài liệu này dành cho frontend, backend, notebook, dashboard và các quy trình dữ liệu.

<CardGroup cols={4}>
  <Card title="Dữ liệu tham chiếu" icon="list">
    Tra cứu mã giao dịch và siêu dữ liệu trước khi gọi dữ liệu thị trường.
  </Card>

  <Card title="Dữ liệu thị trường" icon="chart-line">
    Lấy tick giao dịch và nến OHLCV theo mã giao dịch, độ phân giải và khoảng thời gian.
  </Card>

  <Card title="Dữ liệu cơ bản" icon="file-invoice-dollar">
    Truy cập báo cáo tài chính, báo cáo phân tích và dữ liệu quỹ.
  </Card>

  <Card title="Tin tức và trạng thái" icon="newspaper">
    Lấy tin tức đã chuẩn hóa và kiểm tra độ mới của dữ liệu.
  </Card>
</CardGroup>

## Dữ liệu có thể truy cập

| Nhóm                | Endpoint tiêu biểu                           | Dùng cho                                                  |
| ------------------- | -------------------------------------------- | --------------------------------------------------------- |
| Mã giao dịch        | `GET /v1/instruments`                        | Tìm kiếm mã, gợi ý tự động, lọc tập mã                    |
| Tick giao dịch      | `GET /v1/ticks`                              | Lịch sử giao dịch, tape view, phân tích giao dịch         |
| Nến OHLCV           | `GET /v1/candles`                            | Biểu đồ OHLCV, phân tích kỹ thuật, backtest               |
| FX và vĩ mô         | `GET /v1/fx/rates`, `GET /v1/macro/releases` | Dashboard vĩ mô, quy đổi tiền tệ, bối cảnh thị trường     |
| Quỹ                 | `GET /v1/funds`, `GET /v1/funds/{code}/nav`  | Danh sách quỹ, biểu đồ NAV, so sánh quỹ                   |
| Phân tích tài chính | `GET /v1/fa/{ticker}/statements`             | Dữ liệu cơ bản, chỉ số tài chính, quy trình nghiên cứu    |
| Tin tức             | `GET /v1/news`                               | Luồng tin tức, cập nhật doanh nghiệp, theo dõi thị trường |
| Trạng thái dữ liệu  | `GET /v1/sources`                            | Kiểm tra dữ liệu có đang cập nhật không                   |

## Cách đọc tài liệu

<Steps>
  <Step title="Bắt đầu với hướng dẫn nhanh">
    Xem cách dùng base URL, API key và yêu cầu đầu tiên.
  </Step>

  <Step title="Mở trang API">
    Dùng nhóm **API** trong sidebar để tìm endpoint cần tích hợp.
  </Step>

  <Step title="Dùng chức năng gọi thử">
    Nhập tham số trực tiếp trong docs để xem yêu cầu, phản hồi và mẫu mã.
  </Step>

  <Step title="Đối chiếu schema">
    Dùng trang OpenAPI khi cần tạo client hoặc kiểm tra cấu trúc phản hồi.
  </Step>
</Steps>