Thuộc tính của vị thế

Tất cả các thuộc tính của vị thế được chia thành ba nhóm theo loại giá trị: số nguyên và các giá trị tương thích với chúng, số thực, và chuỗi. Chúng được sử dụng để đọc các hàm PositionGet tương tự như các hàm OrderGet. Chúng ta sẽ mô tả chính các hàm trong phần tiếp theo, và ở đây chúng ta sẽ đưa ra các định danh của tất cả các thuộc tính có sẵn để chỉ định trong tham số đầu tiên của những hàm này.

Các thuộc tính số nguyên được cung cấp trong liệt kê ENUM_POSITION_PROPERTY_INTEGER.

Định danh	Mô tả	Kiểu dữ liệu
POSITION_TICKET	Vé của vị thế	ulong
POSITION_TIME	Thời gian mở vị thế	datetime
POSITION_TIME_MSC	Thời gian mở vị thế tính bằng mili giây	ulong
POSITION_TIME_UPDATE	Thời gian thay đổi (khối lượng) của vị thế	datetime
POSITION_TIME_UPDATE_MSC	Thời gian thay đổi (khối lượng) của vị thế tính bằng mili giây	ulong
POSITION_TYPE	Loại vị thế	ENUM_POSITION_TYPE
POSITION_MAGIC	Số ma thuật của vị thế (dựa trên ORDER_MAGIC)	ulong
POSITION_IDENTIFIER	Định danh vị thế; một số duy nhất được gán cho mỗi vị thế mới mở và không thay đổi trong suốt vòng đời của nó	ulong
POSITION_REASON	Lý do mở vị thế	ENUM_POSITION_REASON

Thông thường, POSITION_IDENTIFIER tương ứng với vé của lệnh đã mở vị thế. Định danh vị thế được chỉ định trong mỗi lệnh (ORDER_POSITION_ID) và giao dịch (DEAL_POSITION_ID) đã mở, thay đổi hoặc đóng nó. Do đó, việc sử dụng nó để tìm kiếm các lệnh và giao dịch liên quan đến một vị thế rất thuận tiện.

Nếu lệnh được thực hiện một phần, thì cả vị thế và lệnh chờ đang hoạt động cho khối lượng còn lại với các vé khớp có thể tồn tại đồng thời. Hơn nữa, vị thế như vậy có thể được đóng theo thời gian, và tại lần thực hiện tiếp theo của phần còn lại của lệnh chờ, một vị thế với cùng vé sẽ xuất hiện trở lại.

Trong chế độ netting, việc đảo ngược vị thế bằng một giao dịch được coi là thay đổi vị thế, không phải là một vị thế mới, do đó POSITION_IDENTIFIER được giữ nguyên. Một vị thế mới trên một ký hiệu chỉ có thể xảy ra sau khi đóng vị thế trước đó với khối lượng bằng không.

Thuộc tính POSITION_TIME_UPDATE chỉ phản ứng với các thay đổi khối lượng (ví dụ, do đóng một phần hoặc tăng vị thế), nhưng không phản ứng với các tham số khác như mức Stop Loss/Take Profit hoặc phí swap.

Chỉ có hai loại vị thế (ENUM_POSITION_TYPE).

Định danh	Mô tả
POSITION_TYPE_BUY	Mua
POSITION_TYPE_SELL	Bán

Các tùy chọn cho nguồn gốc của vị thế, tức là cách vị thế được mở, được cung cấp trong liệt kê ENUM_POSITION_REASON.

Định danh	Mô tả
POSITION_REASON_CLIENT	Kích hoạt lệnh được đặt từ terminal máy tính
POSITION_REASON_MOBILE	Kích hoạt lệnh được đặt từ ứng dụng di động
POSITION_REASON_WEB	Kích hoạt lệnh được đặt từ nền tảng web (trình duyệt)
POSITION_REASON_EXPERT	Kích hoạt lệnh được đặt bởi Expert Advisor hoặc kịch bản

Các thuộc tính số thực được thu thập trong ENUM_POSITION_PROPERTY_DOUBLE.

Định danh	Mô tả
POSITION_VOLUME	Khối lượng vị thế
POSITION_PRICE_OPEN	Giá mở vị thế
POSITION_SL	Giá Stop Loss
POSITION_TP	Giá Take Profit
POSITION_PRICE_CURRENT	Giá ký hiệu hiện tại
POSITION_SWAP	Phí swap tích lũy
POSITION_PROFIT	Lợi nhuận hiện tại

Loại giá hiện tại tương ứng với hoạt động đóng vị thế. Ví dụ, một vị thế mua phải được đóng bằng cách bán, và do đó giá Bid cho nó được theo dõi trong POSITION_PRICE_CURRENT.

Cuối cùng, các thuộc tính chuỗi sau (ENUM_POSITION_PROPERTY_STRING) được hỗ trợ cho các vị thế.

Định danh	Mô tả
POSITION_SYMBOL	Ký hiệu mà vị thế được mở
POSITION_COMMENT	Bình luận về vị thế
POSITION_EXTERNAL_ID	ID vị thế trong hệ thống bên ngoài (trên sàn giao dịch)

Sau khi xem xét danh sách các thuộc tính của vị thế, chúng ta đã sẵn sàng để tìm hiểu các hàm dùng để đọc các thuộc tính này.