Market Data

data-securitiesSummary

Lấy thông tin tổng hợp giao dịch của một mã chứng khoán hoặc chỉ số theo từng ngày giao dịch. Chỉ truyền một trong hai tham số là Symbol hoặc Index.

GET
/api/v3/data/securitiesSummary

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.

indexstringoptional

Mã chỉ số cần lấy thông tin tổng hợp giao dịch (ví dụ VNINDEX, VN30, VN100 etc...)

fromDatestringrequired

Ngày bắt đầu theo định dạng `YYYY-MM-DD`.

toDatestringrequired

Ngày kết thúc theo định dạng `YYYY-MM-DD`. Bắt buộc phải lớn hơn hoặc bằng fromDate.

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/securitiesSummary?symbol=string&fromDate=string&toDate=string" \  -H "Content-Type: application/json"

Success

{
  "pageSize": 0,
  "pageNumber": 0,
  "itemsCount": 0,
  "pageCount": 0,
  "data": [
    {
      "symbol": "string",
      "tradingDate": "string",
      "priceChange": "string",
      "priceChangePercentage": "string",
      "open": "string",
      "high": "string",
      "low": "string",
      "close": "string",
      "average": "string",
      "totalMatch": "string",
      "totalMatchValue": "string",
      "totalBuy": "string",
      "totalTradeBuy": "string",
      "totalSell": "string",
      "totalTradeSell": "string"
    }
  ]
}

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

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