Market Data

data-securitiesByBoard

Lấy danh sách chứng khoán theo điều kiện lọc. Khách chỉ được phép cung cấp một trong ba tham số symbol, board hoặc index để lọc danh sách chứng khoán.

GET
/api/v3/data/securitiesByBoard

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 truy vấn.

boardstringoptional

Mã sàn cần lấy danh sách chứng khoán. Giá trị có thể là `HOSE`, `HNX`, hoặc `UPCOM`.

indexstringoptional

Mã chỉ số cần lấy danh sách chứng khoán.

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

Success

[
  {
    "symbol": "string",
    "symboNameVi": "string",
    "symbolNameEn": "string",
    "board": "HOSE",
    "lotSize": "string",
    "maturityDate": "string",
    "firstTradingDate": "string",
    "lastTradingDate": "string",
    "cwUnderlyingSymbol": "string",
    "cwExercisePrice": "string",
    "cwExecutionRatio": "string",
    "listedShare": "string",
    "icbCode": "string",
    "icbName": "string",
    "iIndex": "string",
    "iNav": "string"
  }
]

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

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