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

# OpenAPI và API Playground

> Dùng hợp đồng OpenAPI và playground tương tác để tích hợp Vero Data Hub API

<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: '75%', height: '100%', borderRadius: 2, background: 'linear-gradient(90deg, var(--accent-primary) 0%, var(--accent-light) 50%, var(--accent-dark) 100%)' }} />
</div>

Tài liệu được tạo từ OpenAPI nên mỗi endpoint có mẫu mã, schema và nút gọi thử.

<CardGroup cols={3}>
  <Card title="Gọi thử" icon="play" href="/vi/apis/reference/list-instruments">
    Gọi API trực tiếp trong docs bằng playground.
  </Card>

  <Card title="Mẫu mã" icon="code">
    Xem đoạn mã cURL, JavaScript và Python cho từng endpoint.
  </Card>

  <Card title="Schema" icon="brackets-curly">
    Kiểm tra tham số yêu cầu, trường phản hồi và mã trạng thái.
  </Card>
</CardGroup>

## Trang API

| Nhóm                | Trang                                                                                                                                                                                                                                                                                                                                                                      |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Dữ liệu tham chiếu  | <a href="/vi/apis/reference/list-instruments">Danh sách mã giao dịch</a>, <a href="/vi/apis/reference/get-instrument">Chi tiết mã giao dịch</a>                                                                                                                                                                                                                            |
| Dữ liệu thị trường  | <a href="/vi/apis/market/list-ticks">Danh sách tick giao dịch</a>, <a href="/vi/apis/market/list-candles">Danh sách nến OHLCV</a>                                                                                                                                                                                                                                          |
| Dữ liệu toàn cầu    | <a href="/vi/apis/global/list-fx-rates">Danh sách tỷ giá FX</a>, <a href="/vi/apis/global/list-bond-yields">Danh sách lợi suất trái phiếu</a>, <a href="/vi/apis/global/list-macro-releases">Danh sách số liệu vĩ mô</a>, <a href="/vi/apis/global/list-sentiment">Danh sách chỉ số tâm lý</a>, <a href="/vi/apis/global/list-calendar">Danh sách sự kiện lịch kinh tế</a> |
| Quỹ                 | <a href="/vi/apis/funds/list-funds">Danh sách quỹ</a>, <a href="/vi/apis/funds/get-fund">Chi tiết quỹ</a>, <a href="/vi/apis/funds/list-fund-nav">Lịch sử NAV của quỹ</a>                                                                                                                                                                                                  |
| Phân tích tài chính | <a href="/vi/apis/fa/list-statements">Danh sách báo cáo tài chính</a>, <a href="/vi/apis/fa/list-reports">Danh sách báo cáo phân tích</a>, <a href="/vi/apis/fa/get-report">Chi tiết báo cáo phân tích</a>                                                                                                                                                                 |
| Tin tức             | <a href="/vi/apis/news/list-news">Danh sách tin tức</a>, <a href="/vi/apis/news/get-news">Chi tiết tin tức</a>                                                                                                                                                                                                                                                             |
| Trạng thái dữ liệu  | <a href="/vi/apis/ops/source-freshness">Độ mới dữ liệu</a>                                                                                                                                                                                                                                                                                                                 |

## Khi nào dùng OpenAPI

* Tạo API client
* Kiểm tra tham số bắt buộc trước khi tích hợp
* Ánh xạ schema phản hồi vào giao diện
* Rà soát mã trạng thái và định dạng lỗi