Chi tiết vị thế theo ID

GET /positions/{positionId}

Chi tiết vị thế theo ID

cURL

curl --request GET \
  --url https://openapi.dnse.com.vn/positions/{positionId} \
  --header 'X-Api-Key: <x-api-key>' \
  --header 'X-Aux-Date: <x-aux-date>' \
  --header 'X-Signature: <x-signature>'

200

{
  "data": {
    "id": 177410795472387,
    "symbol": "41I1G4000",
    "marketType": "DERIVATIVE",
    "accountNo": "0001179019",
    "status": "OPEN",
    "loanPackageId": 2278,
    "side": "NB",
    "accumulateQuantity": 6,
    "tradeQuantity": 1,
    "closedQuantity": 5,
    "openQuantity": 1,
    "overNightQuantity": 0,
    "costPrice": 1834.5,
    "averageCostPrice": 1834.5,
    "averageClosePrice": 1750.96,
    "marketPrice": 1706.1,
    "breakEvenPrice": 1834.95691,
    "createdDate": "2026-03-23T03:08:32.773651Z",
    "modifiedDate": "2026-03-23T04:07:45.692156Z"
  }
}

Tiêu đề

X-Api-Key · string · bắt buộc

API key được cấp khi đăng ký dịch vụ DNSE OpenAPI. Ví dụ: b3JnOmRuc2UgaWQ6MjdlZTc1MzcxZGFkNTY0NmYzYTM2NDk1ZGE3OGNiOGQgaDptdXJtdXIxMjg=

X-Aux-Date · string · bắt buộc

Thời gian thực hiện request, dùng trong cơ chế ký request của DNSE. Ví dụ: Sat, 01 May 2026 14:24:23 +0000

X-Signature · string · bắt buộc

Chữ ký xác thực request được tạo từ API key secret và X-Aux-Date. Ví dụ: Signature keyId="b3JnOmRuc2UgaWQ6MjdlZTc1MzcxZGFkNTY0NmYzYTM2NDk1ZGE3OGNiOGQgaDptdXJtdXIxMjg=",algorithm="hmac-sha256",headers="(request-target) x-aux-date",signature="rfbVXHDUi%2B%2FsOkLXle7O17Qm%2F05cbISSR%2BDcFrBHfqQ%3D",nonce="4add8c3264e4492b9f8ecde0cf26b523"

Tham số đường dẫn

positionId · string · bắt buộc

Id vị thế

Tham số truy vấn

marketType · enum<string> · bắt buộc

Loại thị trường

• STOCK: Danh sách Deal cơ sở

• DERIVATIVE: Danh sách Deal phái sinh

• BOND: Danh sách Deal trái phiếu Loại thị trường.

• STOCK: Giao dịch cơ sở

• DERIVATIVE: Giao dịch phái sinh

• BOND: Giao dịch trái phiếu

Tùy chọn có sẵn: STOCK, DERIVATIVE, BOND

Ví dụ:

"STOCK"

Phản hồi

200

application/json

OK

data · object

Show child attributes

Ví dụ:

{
  "id": 177410795472387,
  "symbol": "41I1G4000",
  "marketType": "DERIVATIVE",
  "accountNo": "0001179019",
  "status": "OPEN",
  "loanPackageId": 2278,
  "side": "NB",
  "accumulateQuantity": 6,
  "tradeQuantity": 1,
  "closedQuantity": 5,
  "openQuantity": 1,
  "overNightQuantity": 0,
  "costPrice": 1834.5,
  "averageCostPrice": 1834.5,
  "averageClosePrice": 1750.96,
  "marketPrice": 1706.1,
  "breakEvenPrice": 1834.95691,
  "createdDate": "2026-03-23T03:08:32.773651Z",
  "modifiedDate": "2026-03-23T04:07:45.692156Z"
}

id · integer<int32>

ID vị thế

Ví dụ:

9589

symbol · string

Mã chứng khoán

Ví dụ:

"BVS"

accountNo · string

Số tiểu khoản

Ví dụ:

"0001179019"

status · enum<string>

Trạng thái của vị thế

• OPEN: Đang mở
• PENDING_CLOSE: Chờ đóng
• CLOSED: Đã đóng
• ODD_LOT: Lô lẻ (cơ sở)

Tùy chọn có sẵn: OPEN, PENDING_CLOSE, CLOSED, ODD_LOT

Ví dụ:

"OPEN"

loanPackageId · integer<int32>

Gói vay cơ sở hoặc phái sinh

Ví dụ:

5757

side · enum<string>

Loại vị thế

• NB: Mua
• NS: Bán

Tùy chọn có sẵn: NB, NS

Ví dụ:

"NB"

accumulateQuantity · integer<int32>

Khối lượng cộng dồn

Ví dụ:

3400

tradeQuantity · integer<int32>

Khối lượng được giao dịch

Ví dụ:

3400

closedQuantity · integer<int32>

Khối lượng đã đóng

Ví dụ:

0

openQuantity · integer<int32>

Khối lượng mở

Ví dụ:

3400

costPrice · integer<int32>

Giá vốn trung bình của khối lượng mở

Ví dụ:

28000

averageCostPrice · integer<int32>

Giá vốn trung bình

Ví dụ:

28000

averageClosePrice · integer<int32>

Giá đóng trung bình

Ví dụ:

0

marketPrice · integer<int32>

Giá thị trường

Ví dụ:

25200

breakEvenPrice · number<double>

Giá hòa vốn

Ví dụ:

28043.4752

createdDate · string<date-time>

Thời điểm mở

Ví dụ:

"2026-07-20T04:22:38.904283Z"

modifiedDate · string<date-time>

Thời điểm cập nhật

Ví dụ:

"2026-07-30T11:20:44.65933Z"