query.orderBook

Lấy lịch sử sổ lệnh theo tài khoản và bộ lọc, có phân trang. Không yêu cầu chữ ký.

Scope bắt buộc: tradingws:orderBook:get.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

bodyobjectrequired

idstringrequired

methodstringrequired

paramsobjectrequired

accountNostringrequired

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

fromstringrequired

Thời gian bắt đầu để lọc lịch sử sổ lệnh, định dạng `yyyy/MM/dd`.

tostringrequired

Thời gian kết thúc để lọc lịch sử sổ lệnh, định dạng `yyyy/MM/dd`. Phải >= `from`.

symbolstring | nulloptional

Mã chứng khoán cần lọc.

orderStatusstring | nulloptional

Trạng thái lệnh cần lọc. Tham khảo 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.

pageIndexintegeroptional

Chỉ số trang, bắt đầu từ 1.

timestampintegerrequired

Response Body

`application/json`

Sample Request

wscat -c wss://api.ssi.com.vn/ws/v3/trading -x '{
  "id": "req-0013",
  "method": "query.orderBook",
  "params": {
    "accountNo": "0901351",
    "from": "2026/09/01",
    "to": "2026/09/10",
    "pageIndex": 1,
    "pageSize": 10
  },
  "timestamp": 1755000012000
}'

Sample Response

{
  "id": "req-0013",
  "method": "query.orderBook",
  "status": 200,
  "result": {
    "accountNo": "0901351",
    "totalRecord": 1,
    "orderList": [
      {
        "clientRequestId": "req-0001",
        "orderId": "ORD123456",
        "symbol": "SSI",
        "side": "B",
        "orderType": "LO",
        "quantity": "1000",
        "price": "45.50",
        "filledQty": "1000",
        "cancelQty": "0",
        "avgPrice": "45.48",
        "inputTime": "2026/09/09 09:15:32",
        "modifiedTime": "2026/09/09 09:16:01",
        "orderStatus": "FF",
        "message": ""
      }
    ]
  },
  "rateLimit": {
    "limit": 100,
    "remaining": 92,
    "resetMs": 760
  }
}

Request Body

Response Body

200application/json

defaultapplication/json

`application/json`

`application/json`