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

# Hướng dẫn nhanh

> Gửi yêu cầu đầu tiên tới 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: '25%', height: '100%', borderRadius: 2, background: 'linear-gradient(90deg, var(--accent-primary) 0%, var(--accent-light) 50%, var(--accent-dark) 100%)' }} />
</div>

Trang này hướng dẫn cách gọi API cơ bản. Bạn cần base URL công khai và API key được cấp cho tài khoản.

## 1) Chuẩn bị thông tin xác thực

| Giá trị    | Mô tả                                  |
| ---------- | -------------------------------------- |
| `BASE_URL` | `https://api-gw.verolabs.co`           |
| `API_KEY`  | API key được cấp cho tài khoản của bạn |

<Info>
  Dùng `BASE_URL=https://api-gw.verolabs.co` và thay `API_KEY` bằng key của bạn.
</Info>

## 2) Gửi yêu cầu đầu tiên

```bash theme={null}
curl --request GET   --url "https://api-gw.verolabs.co/v1/instruments?limit=5"   --header "X-API-KEY: $API_KEY"
```

Phản hồi thành công trả JSON:

```json theme={null}
{
  "data": [
    {
      "symbol": "BTCUSDT",
      "asset_class": "crypto",
      "exchange": "BINANCE",
      "status": "active"
    }
  ]
}
```

## 3) Truy vấn dữ liệu theo thời gian

Các endpoint có `from` và `to` dùng ISO 8601 UTC với hậu tố `Z`.

```bash theme={null}
curl --request GET   --url "https://api-gw.verolabs.co/v1/candles?symbol=BTCUSDT&resolution=1m&from=2026-05-15T00:00:00Z&to=2026-05-15T01:00:00Z"   --header "X-API-KEY: $API_KEY"
```

## 4) Dùng API playground

Mỗi endpoint trong nhóm **API** có playground tương tác.

<CardGroup cols={3}>
  <Card title="Endpoint" icon="route">
    Phương thức, đường dẫn và tham số đầu vào.
  </Card>

  <Card title="Mẫu mã" icon="code">
    Đoạn mã cURL, JavaScript và Python được tạo tự động.
  </Card>

  <Card title="Phản hồi" icon="brackets-curly">
    Ví dụ phản hồi và schema theo từng mã trạng thái.
  </Card>
</CardGroup>

## Quy tắc quan trọng

| Quy tắc                | Ghi chú                                       |
| ---------------------- | --------------------------------------------- |
| Dùng UTC `Z`           | Ví dụ `2026-05-15T00:00:00Z`                  |
| Truyền `limit` hợp lý  | Phản hồi gọn và nhanh hơn                     |
| Dùng `next_cursor`     | Lấy trang kế tiếp của phản hồi dạng danh sách |
| Không phân tích cursor | Cursor là token opaque                        |