7.7. Lệnh

Mô tả cách sử dụng thư viện sau khi người dùng đã đăng nhập. Chi tiết được nêu ra ở cuối chương này.

Được sử dụng cho các hàm đặt lệnh, xem chi tiết lệnh, sửa lệnh, hủy lệnh, danh sách lệnh.

Mô tả các loại lệnh:

Giá trị
Tên lệnh
Mô tả

LO

Limit Order (Lệnh giới hạn)

Lệnh mua/bán tại mức giá cụ thể hoặc tốt hơn. Hết ngày không khớp sẽ bị hủy.

MP

Market Order (Lệnh thị trường)

Lệnh mua/bán ngay tại giá thị trường tốt nhất hiện có.

MTL

Market To Limit

Lệnh thị trường nhưng nếu không khớp hết, phần còn lại chuyển thành lệnh giới hạn tại giá khớp cuối cùng.

ATO

At The Open

Lệnh mua/bán tại mức giá mở cửa; chỉ có hiệu lực trong phiên khớp lệnh định kỳ mở cửa.

ATC

At The Close

Lệnh mua/bán tại mức giá đóng cửa; chỉ có hiệu lực trong phiên khớp lệnh định kỳ đóng cửa.

MOK

Match Or Kill

Lệnh thị trường, phải khớp toàn bộ ngay lập tức, nếu không khớp hết thì bị hủy toàn bộ.

MAK

Match And Kill

Lệnh thị trường, khớp phần nào được phần đó, phần còn lại bị hủy.

PLO

Post Limit Order

Lệnh giới hạn được đặt sau phiên ATC, chỉ được khớp nếu có lệnh đối ứng trong sổ lệnh. Áp dụng cho phiên sau giờ (PLO).

7.7.1. Đặt lệnh

  • Cơ sở

username_dnse = 'REPLACE_WITH_YOUR_DNSE_USERNAME'
password_dnse = 'REPLACE_WITH_YOUR_DNSE_PASSWORD'

client_order = client.FiinQuantConnector(
    broker='DNSE',
    username=username_dnse,
    password=password_dnse,
    smart_otp=True
).login()

orderbook = client_order.get_orderbook(
    account_id='0001009212',
    loan_id='13720'
)

order = orderbook.place_order(
    ticker='HPG',
    side='buy',
    order_type='LO',
    quantity=1000,
    price=27000
)

print(order.summary())

Tham số:

Tham số
Kiểu dữ liệu
Bắt buộc
Mô tả

ticker

str

Có

Mã chứng khoán cần đặt lệnh (ví dụ: 'SSI').

side

str

Có

Loại giao dịch: 'buy' (mua, long) hoặc 'sell' (bán, short).

order_type

str

Có

Loại lệnh đặt: 'LO', 'MP', 'MTL', 'ATO', 'ATC', 'MOK', 'MAK', 'PLO'. Phái sinh sẽ không có PLO và MP.

quantity

int

Có

Khối lượng đặt lệnh.

price

float

Không

Giá đặt lệnh (chỉ bắt buộc khi order_type='LO').

Mẫu kết quả trả ra là một dictionary chứa các thông tin sau:

{
    'id': 131,
    'ticker': 'HPG',
    'side': 'Buy',
    'order_type': 'LO',
    'price': 27000.0,
    'quantity': 1000,
    'filled': 0,
    'avg_price': 0.0,
    'modified': '29/10/2025 10:57:02',
    'created': '29/10/2025 10:57:02',
    'status': 'Pending',
    'error': None,
    'status_code': 200
}

Dữ liệu có các thuộc tính:

Tên thuộc tính
Kiểu dữ liệu
Mô tả

id

str

Mã định danh của lệnh đặt.

side

str

Hướng giao dịch: NB = Mua, NS = Bán.

ticker

str

Mã chứng khoán/phái sinh.

price

float

Giá đặt lệnh.

quantity

int

Khối lượng đặt lệnh.

order_type

str

Loại lệnh (ví dụ: LO, MP, ATC, ...).

status

str

Trạng thái lệnh (new, filled, canceled, ...).

filled

int

Tổng khối lượng đã khớp.

avg_price

float

Giá khớp trung bình của lệnh.

error

str hoặc None

Thông tin lỗi (nếu có).

created

datetime

Thời điểm tạo lệnh.

modified

datetime

Thời điểm sửa đổi hoặc cập nhật lệnh.

status_code

int

Mã code, nếu thành công là 200

  • Phái sinh

username_dnse = 'REPLACE_WITH_YOUR_DNSE_USERNAME'
password_dnse = 'REPLACE_WITH_YOUR_DNSE_PASSWORD'

client_order = client.FiinQuantConnector(
    broker='DNSE',
    username=username_dnse,
    password=password_dnse,
    smart_otp=True
).login()

orderbook_der = client_order.get_derivative_orderbook(
    account_id='0001009212',
    loan_id='2278'
)

derivative_order = orderbook_der.place_order(
    ticker='41I1FB000',
    side='buy',
    order_type='MTL',
    quantity=10
)

print(derivative_order.summary())

Tham số:

Tham số
Kiểu dữ liệu
Bắt buộc
Mô tả

ticker

str

Có

Mã phái sinh cần đặt lệnh (ví dụ: '41I1FB000').

side

str

Có

Loại giao dịch: 'buy' (mua, long) hoặc 'sell' (bán, short).

order_type

str

Có

Loại lệnh đặt: 'LO', 'MP', 'MTL', 'ATO', 'ATC', 'MOK', 'MAK', 'PLO'. Phái sinh sẽ không có PLO và MP.

quantity

int

Có

Khối lượng đặt lệnh.

price

float

Không

Giá đặt lệnh (chỉ bắt buộc khi order_type='LO').

take_profit_rate

float

Không (mặc định = 0.0)

Tỷ lệ chốt lời (%), tính trên giá vốn. Khi giá tăng đến mức tương ứng, hệ thống sẽ đặt lệnh chốt lời.

Yêu cầu nếu có: x>0

stop_loss_rate

float

Không (mặc định = 0.0)

Tỷ lệ cắt lỗ (%), tính trên giá vốn. Khi giá giảm đến mức tương ứng, hệ thống sẽ đặt lệnh cắt lỗ.

Yêu cầu nếu có: -1<=x<0

take_profit_delta_price

float

Không (mặc định bằng 0.0)

Khoảng chênh lệch giá tuyệt đối (theo điểm giá) dùng để xác định mức chốt lời. Ưu tiên sử dụng nếu không dùng take_profit_rate.

Yêu cầu nếu có: x>0

stop_loss_delta_price

float

Không (mặc định bằng 0.0)

Khoảng chênh lệch giá tuyệt đối (theo điểm giá) dùng để xác định mức cắt lỗ. Ưu tiên sử dụng nếu không dùng stop_loss_rate.

Yêu cầu nếu có: x>0

take_profit_order_delta_price

float

Không (mặc định bằng 0.0)

Khoảng điểm tuỳ chỉnh của giá đặt so với giá kích hoạt, có thể âm hoặc dương.

stop_loss_order_delta_price

float

Không (mặc định bằng 0.0)

Khoảng điểm tuỳ chỉnh của giá đặt so với giá kích hoạt, có thể âm hoặc dương.

Mẫu kết quả trả ra là một dictionary chứa các thông tin sau:

{
    'id': 132,
    'ticker': '41I1FB000',
    'side': 'Buy',
    'order_type': 'MTL',
    'price': 27000.0,
    'quantity': 10,
    'filled': 0,
    'avg_price': 0.0,
    'modified': '29/10/2025 10:57:02',
    'created': '29/10/2025 10:57:02',
    'status': 'Pending',
    'error': None,
    'status_code': 200
}

Dữ liệu có các thuộc tính:

Tên thuộc tính
Kiểu dữ liệu
Mô tả

id

str

Mã định danh của lệnh đặt.

side

str

Hướng giao dịch: NB = Mua, NS = Bán.

ticker

str

Mã chứng khoán/phái sinh.

price

float

Giá đặt lệnh.

quantity

int

Khối lượng đặt lệnh.

order_type

str

Loại lệnh (ví dụ: LO, MP, ATC, ...).

status

str

Trạng thái lệnh (new, filled, canceled, ...).

filled

int

Tổng khối lượng đã khớp.

avg_price

float

Giá khớp trung bình của lệnh.

error

str hoặc None

Thông tin lỗi (nếu có).

created

datetime

Thời điểm tạo lệnh.

modified

datetime

Thời điểm sửa đổi hoặc cập nhật lệnh.

status_code

int

Mã code, nếu thành công là 200

7.7.2. Chi tiết lệnh

  • Cơ sở

username_dnse = 'REPLACE_WITH_YOUR_DNSE_USERNAME'
password_dnse = 'REPLACE_WITH_YOUR_DNSE_PASSWORD'

client_order = client.FiinQuantConnector(
    broker='DNSE',
    username=username_dnse,
    password=password_dnse,
    smart_otp=True
).login()

orderbook = client_order.get_orderbook(
    account_id='0001009212',
    loan_id='13720'
)

order_detail = orderbook.get_order_detail(order_id=161)
print(order_detail.summary())

Mẫu kết quả trả ra là một dictionary chứa các thông tin sau:

{
    'id': 161,
    'ticker': 'HPG',
    'side': 'Buy',
    'order_type': 'LO',
    'price': 27000.0, 
    'quantity': 1000, 
    'filled': 0, 
    'avg_price': 0.0, 
    'modified': '29/10/2025 11:14:12', 
    'created': '29/10/2025 11:14:12', 
    'status': 'New', 
    'error': '', 
    'status_code': 200
}

  • Phái sinh

username_dnse = 'REPLACE_WITH_YOUR_DNSE_USERNAME'
password_dnse = 'REPLACE_WITH_YOUR_DNSE_PASSWORD'

client_order = client.FiinQuantConnector(
    broker='DNSE',
    username=username_dnse,
    password=password_dnse,
    smart_otp=True
).login()

orderbook_der = client_order.get_derivative_orderbook(
    account_id='0001009212',
    loan_id='2278'
)

order_detail_der = orderbook_der.get_order_detail(order_id=86)
print(order_detail_der.summary())

Mẫu kết quả trả ra là một dictionary chứa các thông tin sau:

{
    'id': 86, 
    'ticker': '41I1FB000', 
    'side': 'Buy', 
    'order_type': 'MTL', 
    'price': 0.0, 
    'quantity': 10, 
    'filled': 0, 
    'avg_price': 0.0, 
    'modified': '29/10/2025 11:18:45', 
    'created': '29/10/2025 11:18:45', 
    'status': 'Canceled', 
    'error': None, 
    'status_code': 200
}

7.7.3. Sửa lệnh (Chỉ sửa được với lệnh đặt là LO)

  • Cơ sở

username_dnse = 'REPLACE_WITH_YOUR_DNSE_USERNAME'
password_dnse = 'REPLACE_WITH_YOUR_DNSE_PASSWORD'

client_order = client.FiinQuantConnector(
    broker='DNSE',
    username=username_dnse,
    password=password_dnse,
    smart_otp=True
).login()

orderbook = client_order.get_orderbook(
    account_id='0001009212',
    loan_id='13720'
)

modify_order = orderbook.modify_order(
    order_id=191,
    new_price = 26900,
    new_quantity=1000
)

print(modify_order.summary())

Tham số:

Tên tham số
Kiểu dữ liệu
Bắt buộc
Mô tả

order_id

int

Có

Mã định danh của lệnh cần sửa đổi.

new_price

float

Có

Giá mới muốn chỉnh sửa (chỉ áp dụng nếu là lệnh 'LO').

new_quantity

int

Có

Khối lượng mới muốn sửa của lệnh (chỉ áp dụng nếu là lệnh 'LO').

Mẫu kết quả trả ra là một dictionary chứa các thông tin sau:

{
    'id': 191, 
    'ticker': 'HPG', 
    'side': 'Buy', 
    'order_type': 'LO', 
    'price': 26900.0, 
    'quantity': 1000, 
    'filled': 0,
    'avg_price': 0.0,
    'modified': '29/10/2025 11:23:54',
    'created': '29/10/2025 11:23:54',
    'status': 'Pending',
    'error': None,
    'status_code': 200
}

  • Phái sinh

username_dnse = 'REPLACE_WITH_YOUR_DNSE_USERNAME'
password_dnse = 'REPLACE_WITH_YOUR_DNSE_PASSWORD'

client_order = client.FiinQuantConnector(
    broker='DNSE',
    username=username_dnse,
    password=password_dnse,
    smart_otp=True
).login()

orderbook_der = client_order.get_derivative_orderbook(
    account_id='0001009212',
    loan_id='2278'
)

derivative_modify = orderbook_der.modify_order(
    order_id=91,
    new_price=1945,
    new_quantity=5
)

print(derivative_modify.summary())

Tham số:

Tên tham số
Kiểu dữ liệu
Bắt buộc
Mô tả

order_id

int

Có

Mã định danh của lệnh cần sửa đổi.

new_price

float

Có

Giá mới muốn chỉnh sửa (chỉ áp dụng nếu là lệnh 'LO').

new_quantity

int

Có

Khối lượng mới muốn sửa của lệnh (chỉ áp dụng nếu là lệnh 'LO').

Ví dụ 1 hàm bị lỗi:

  • Lỗi đặt lệnh hoặc sửa lệnh LO với mức giá đặt mua, bán lớn hơn mức giá trần

{
    'id': None, 
    'ticker': None, 
    'side': 'Unknown', 
    'order_type': None, 
    'price': 0.0, 
    'quantity': 0, 
    'filled': 0, 
    'avg_price': 0.0, 
    'modified': None, 
    'created': None, 
    'status': None, 
    'error': '{
                    "status":400,
                    "code":"PRICE_MUST_LESS_THAN_OR_EQUAL_TO_CEILING_PRICE",
                    "message":"Price must be less than or equal to ceiling price"
               }',
     'status_code': 400
}

7.7.4. Hủy lệnh

  • Cơ sở

username_dnse = 'REPLACE_WITH_YOUR_DNSE_USERNAME'
password_dnse = 'REPLACE_WITH_YOUR_DNSE_PASSWORD'

client_order = client.FiinQuantConnector(
    broker='DNSE',
    username=username_dnse,
    password=password_dnse,
    smart_otp=True
).login()

orderbook = client_order.get_orderbook(
    account_id='0001009212',
    loan_id='13720'
)

cancel_order = orderbook.cancel_order(order_id=661)
print(cancel_order.summary())

Mẫu kết quả trả ra là một dictionary chứa các thông tin sau:

{
    'id': 661, 
    'ticker': 'SSI', 
    'side': 'Buy', 
    'order_type': 'LO', 
    'price': 36500.0, 
    'quantity': 500, 
    'filled': 0, 
    'avg_price': 0.0, 
    'modified': '29/10/2025 13:57:17', 
    'created': '29/10/2025 13:57:17', 
    'status': 'PendingCancel', 
    'error': None, 
    'status_code': 200
}

  • Phái sinh

username_dnse = 'REPLACE_WITH_YOUR_DNSE_USERNAME'
password_dnse = 'REPLACE_WITH_YOUR_DNSE_PASSWORD'

client_order = client.FiinQuantConnector(
    broker='DNSE',
    username=username_dnse,
    password=password_dnse,
    smart_otp=True
).login()

orderbook_der = client_order.get_derivative_orderbook(
    account_id='0001009212',
    loan_id='2278'
)

cancel_order_derivative = orderbook_der.cancel_order(order_id=91)
print(cancel_order_derivative.summary())
Previous7.6. Sức mua/bánNext7.8. Danh sách lệnh

Last updated