Vị thế nắm giữ
curl --request GET \
--url https://openapi-uat.dnse.com.vn/accounts/{accountNo}/positions \
--header 'X-API-Key: <x-api-key>' \
--header 'X-Aux-Date: <x-aux-date>' \
--header 'X-Signature: <x-signature>'import requests
url = "https://openapi-uat.dnse.com.vn/accounts/{accountNo}/positions"
headers = {
"X-API-Key": "<x-api-key>",
"X-Aux-Date": "<x-aux-date>",
"X-Signature": "<x-signature>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-API-Key': '<x-api-key>',
'X-Aux-Date': '<x-aux-date>',
'X-Signature': '<x-signature>'
}
};
fetch('https://openapi-uat.dnse.com.vn/accounts/{accountNo}/positions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://openapi-uat.dnse.com.vn/accounts/{accountNo}/positions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <x-api-key>",
"X-Aux-Date: <x-aux-date>",
"X-Signature: <x-signature>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://openapi-uat.dnse.com.vn/accounts/{accountNo}/positions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<x-api-key>")
req.Header.Add("X-Aux-Date", "<x-aux-date>")
req.Header.Add("X-Signature", "<x-signature>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://openapi-uat.dnse.com.vn/accounts/{accountNo}/positions")
.header("X-API-Key", "<x-api-key>")
.header("X-Aux-Date", "<x-aux-date>")
.header("X-Signature", "<x-signature>")
.asString();require 'uri'
require 'net/http'
url = URI("https://openapi-uat.dnse.com.vn/accounts/{accountNo}/positions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<x-api-key>'
request["X-Aux-Date"] = '<x-aux-date>'
request["X-Signature"] = '<x-signature>'
response = http.request(request)
puts response.read_body{
"positions": [
{
"id": 177410795472387,
"symbol": "41I1G4000",
"accountNo": "0001179019",
"marketType": "DERIVATIVE",
"status": "OPEN",
"loanPackageId": 2278,
"side": "NB",
"accumulateQuantity": 6,
"tradeQuantity": 1,
"closedQuantity": 5,
"openQuantity": 1,
"overNightQuantity": 0,
"costPrice": 1834.5,
"marketPrice": 1706.1,
"breakEvenPrice": 1834.95691,
"createdDate": "2026-03-23T03:08:32.773651Z",
"modifiedDate": "2026-03-23T04:07:45.692156Z"
}
],
"pageIndex": 0,
"pageSize": 20,
"pageNumber": 1,
"total": 1
}{
"code": "OA-003",
"message": "Thông tin nhập không hợp lệ",
"status": 400
}{
"code": "OA-009",
"message": "Lỗi hệ thống",
"status": 500
}account
Vị thế nắm giữ
Lấy danh sách các vị thế đang nắm giữ trên tài khoản, bao gồm thông tin mã chứng khoán, khối lượng, giá vốn, và các thông tin khác.
GET
/
accounts
/
{accountNo}
/
positions
Vị thế nắm giữ
curl --request GET \
--url https://openapi-uat.dnse.com.vn/accounts/{accountNo}/positions \
--header 'X-API-Key: <x-api-key>' \
--header 'X-Aux-Date: <x-aux-date>' \
--header 'X-Signature: <x-signature>'import requests
url = "https://openapi-uat.dnse.com.vn/accounts/{accountNo}/positions"
headers = {
"X-API-Key": "<x-api-key>",
"X-Aux-Date": "<x-aux-date>",
"X-Signature": "<x-signature>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-API-Key': '<x-api-key>',
'X-Aux-Date': '<x-aux-date>',
'X-Signature': '<x-signature>'
}
};
fetch('https://openapi-uat.dnse.com.vn/accounts/{accountNo}/positions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://openapi-uat.dnse.com.vn/accounts/{accountNo}/positions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <x-api-key>",
"X-Aux-Date: <x-aux-date>",
"X-Signature: <x-signature>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://openapi-uat.dnse.com.vn/accounts/{accountNo}/positions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<x-api-key>")
req.Header.Add("X-Aux-Date", "<x-aux-date>")
req.Header.Add("X-Signature", "<x-signature>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://openapi-uat.dnse.com.vn/accounts/{accountNo}/positions")
.header("X-API-Key", "<x-api-key>")
.header("X-Aux-Date", "<x-aux-date>")
.header("X-Signature", "<x-signature>")
.asString();require 'uri'
require 'net/http'
url = URI("https://openapi-uat.dnse.com.vn/accounts/{accountNo}/positions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<x-api-key>'
request["X-Aux-Date"] = '<x-aux-date>'
request["X-Signature"] = '<x-signature>'
response = http.request(request)
puts response.read_body{
"positions": [
{
"id": 177410795472387,
"symbol": "41I1G4000",
"accountNo": "0001179019",
"marketType": "DERIVATIVE",
"status": "OPEN",
"loanPackageId": 2278,
"side": "NB",
"accumulateQuantity": 6,
"tradeQuantity": 1,
"closedQuantity": 5,
"openQuantity": 1,
"overNightQuantity": 0,
"costPrice": 1834.5,
"marketPrice": 1706.1,
"breakEvenPrice": 1834.95691,
"createdDate": "2026-03-23T03:08:32.773651Z",
"modifiedDate": "2026-03-23T04:07:45.692156Z"
}
],
"pageIndex": 0,
"pageSize": 20,
"pageNumber": 1,
"total": 1
}{
"code": "OA-003",
"message": "Thông tin nhập không hợp lệ",
"status": 400
}{
"code": "OA-009",
"message": "Lỗi hệ thống",
"status": 500
}Tiêu đề
API Key được cấp khi đăng ký dịch vụ
Thời gian thực hiện yêu cầu
Chữ ký xác thực yêu cầu
API version (YYYY-MM-DD)
Tham số đường dẫn
Số tiểu khoản
Tham số truy vấn
Loại thị trường
- STOCK: Danh sách vị thế cơ sở
- DERIVATIVE: Danh sách vị thế phái sinh
Kích thước trang dữ liệu (page size)
Phản hồi
OK
Show child attributes
Show child attributes
Ví dụ:
[
{
"id": 177410795472387,
"symbol": "41I1G4000",
"accountNo": "0001179019",
"status": "OPEN",
"loanPackageId": 2278,
"side": "NB",
"accumulateQuantity": 6,
"tradeQuantity": 1,
"closedQuantity": 5,
"openQuantity": 1,
"overNightQuantity": 0,
"costPrice": 1834.5,
"marketPrice": 1706.1,
"breakEvenPrice": 1834.95691,
"createdDate": "2026-03-23T03:08:32.773651Z",
"modifiedDate": "2026-03-23T04:07:45.692156Z"
}
]
Kích thước trang dữ liệu (dành cho phái sinh)
Ví dụ:
0
Số bản ghi trên 1 trang (dành cho phái sinh)
Ví dụ:
20
Số trang (chỉ dành cho phái sinh)
Ví dụ:
1
Tổng số vị thế (chỉ dành cho phái sinh)
Ví dụ:
1