Vero Data Hub API

Base URL và xác thực

Dùng base URL công khai và gửi API key trong header được cung cấp khi cấp quyền truy cập.

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

Các endpoint dạng danh sách trả đối tượng có data. Endpoint hỗ trợ phân trang bằng cursor có thể trả thêm next_cursor.

{
  "data": [
    { "symbol": "BTCUSDT" }
  ],
  "next_cursor": "..."
}

Endpoint chi tiết trả một đối tượng tài nguyên.

Param	Ý nghĩa
`limit`	Số item tối đa trả về trong một yêu cầu
`cursor`	Token lấy từ `next_cursor` của phản hồi trước

Cursor là token không nên tự diễn giải. Client không nên giải mã hoặc tự tạo cursor.

from và to phải dùng ISO 8601 UTC.

Hợp lệ	Không hợp lệ
`2026-05-15T00:00:00Z`	`2026-05-15 00:00:00`
`2026-05-15T00:00:00.123Z`	`2026-05-15T07:00:00+07:00`

Lỗi được trả theo định dạng JSON problem.

{
  "type": "invalid-param",
  "title": "Invalid query parameter",
  "status": 400,
  "detail": "param 'from' is required"
}

Status	Ý nghĩa
`400`	Thiếu hoặc sai tham số yêu cầu
`401`	Thiếu hoặc sai thông tin xác thực
`404`	Tài nguyên không tồn tại
`422`	Đúng định dạng nhưng giá trị không được hỗ trợ
`429`	Vượt giới hạn yêu cầu của tài khoản
`503`	API tạm thời không sẵn sàng