Trading

trade-orderBook

Lấy lịch sử sổ lệnh theo tài khoản và bộ lọc.

GET
/api/v3/trading/orderBook

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. Chủ yếu là 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

accountNostringrequired

Tài khoản giao dịch cần lấy lịch sử sổ lệnh.

fromstringoptional

Thời gian bắt đầu để lọc lịch sử sổ lệnh, định dạng ISO 8601 (ví dụ 2024-01-01T00:00:00Z).

tostringoptional

Thời gian kết thúc để lọc lịch sử sổ lệnh, định dạng ISO 8601 (ví dụ 2024-01-01T00:00:00Z).

symbolstringoptional

Mã chứng khoán cần lọc lịch sử sổ lệnh.

orderStatusstringoptional

Trạng thái lệnh cần lọc. Tham khảo danh sách trạng thái tại phụ lục Trạng thái lệnh & luồng trạng thái.

pageSizeintegeroptional

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 (ví dụ 20). Giá trị này giúp khách hàng kiểm soát lượng dữ liệu trả về trong mỗi phản hồi, đặc biệt khi lịch sử sổ lệnh có nhiều bản ghi.

pageIndexintegeroptional

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.

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

Success

{
  "data": {
    "accountNo": "string",
    "totalRecord": 0,
    "orderList": [
      {
        "clientRequestId": "string",
        "orderId": "string",
        "symbol": "string",
        "side": "B",
        "orderType": "LO",
        "quantity": "string",
        "price": "string",
        "filledQty": "string",
        "cancelQty": "string",
        "avgPrice": "string",
        "inputTime": "string",
        "modifiedTime": "string",
        "orderStatus": "PD",
        "message": "string"
      }
    ]
  }
}

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

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