Market Data

data-ohlc

Lấy dữ liệu nến OHLCV theo khoảng thời gian. Thời gian cung cấp 1 năm gần nhất cho dữ liệu intraday, dữ liệu daily cung cấp từ khi mã chứng khoán được giao dịch.

GET
/api/v3/data/ohlc

Authorization

Bearer
AuthorizationBearer <token>

Nhập JWT token theo định dạng Bearer <token>.

In: header

Header Parameters

Content-Typestringrequired

Định dạng nội dung request body, sử dụng "application/json".

User-Agentstringoptional

Thông tin client gửi request.

Accept-Languagestringoptional

Ngôn ngữ phản hồi mong muốn. Nếu không có header này, hệ thống sẽ mặc định là en

Query Parameters

symbolstringrequired

Mã chứng khoán cần lấy dữ liệu OHLCV.

fromstringrequired

Mốc thời gian bắt đầu. Định dạng `YYYY-MM-DD` cho dữ liệu daily và `YYYY-MM-DD HH:mm:ss` cho dữ liệu intraday.

tostringrequired

Mốc thời gian kết thúc. Định dạng `YYYY-MM-DD` cho dữ liệu daily và `YYYY-MM-DD HH:mm:ss` cho dữ liệu intraday.

timeFramestringoptional

Khung thời gian của dữ liệu OHLCV. Giá trị có thể là `1m`, `3m`, `5m`, `15m`, `30m`, `1h`, hoặc `1d`. Nếu không cung cấp thì hệ thống sẽ sử dụng giá trị mặc định là `1d`.

pageIndexstringoptional

Chỉ số trang khi phân trang kết quả, bắt đầu từ 1. Nếu không cung cấp thì hệ thống sẽ sử dụng giá trị mặc định là 1. Giá trị này kết hợp với `pageSize` giúp khách hàng truy xuất các phần khác nhau của dữ liệu lịch sử sổ lệnh khi có nhiều bản ghi.

pageSizestringoptional

Số lượng bản ghi trên mỗi trang khi phân trang kết quả. Nếu không cung cấp thì hệ thống sẽ sử dụng giá trị mặc định là 10. Giá trị này kết hợp với `pageIndex` giúp khách hàng truy xuất các phần khác nhau của dữ liệu lịch sử sổ lệnh khi có nhiều bản ghi.

Response Headers

X-RATELIMIT-LIMITstringoptional

Giới hạn số request trong chu kỳ.

X-RATELIMIT-REMAININGstringoptional

Số request còn lại trong chu kỳ hiện tại.

X-RATELIMIT-RESETstringoptional

Thời điểm reset giới hạn request.

Response Body

application/json

application/json

curl -X GET "https://api.ssi.com.vn/api/v3/data/ohlc?symbol=string&from=string&to=string" \  -H "Content-Type: application/json"

Success

{
  "pageSize": 0,
  "pageNumber": 0,
  "itemsCount": 0,
  "pageCount": 0,
  "data": [
    {
      "symbol": "string",
      "tradingDate": "string",
      "open": "string",
      "high": "string",
      "low": "string",
      "close": "string",
      "volume": "string",
      "value": "string"
    }
  ]
}

Yêu cầu không hợp lệ.

{
  "code": "400",
  "msg": "Invalid request"
}