Danh sách khoản vay

Lấy danh sách các khoản vay trên tiểu khoản theo bộ lọc. Hiện tại chỉ hỗ trợ các khoản vay cơ sở.

GET /accounts/{accountNo}/loans

Danh sách khoản vay

cURL

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

200

{
  "loans": [
    {
      "id": 8117,
      "accountNo": "0001179019",
      "positionId": 8426,
      "symbol": "ACB",
      "disbursementDate": "2026-09-10",
      "dueDate": "2026-12-09",
      "initialRate": 1,
      "interestRate": 0.115,
      "overdueInterestRate": 0.18,
      "preferentialPeriod": 0,
      "preferentialInterestRate": 0,
      "principal": 1191245,
      "remainPrincipal": 1191245,
      "remainInterest": 1501
    }
  ],
  "pagination": {
    "pageIndex": 0,
    "pageSize": 20,
    "totalRecords": 2,
    "totalPages": 1
  }
}

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"

version · string

API version (YYYY-MM-DD)

Tham số đường dẫn

accountNo · string · bắt buộc

Số tiểu khoản

Tham số truy vấn

marketType · enum<string>

Loại thị trường

• STOCK: Danh sách vị thế cơ sở

• DERIVATIVE: Danh sách vị thế phái sinh 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"

disbursementFrom · string<date>

Ngày giải ngân bắt đầu (YYYY-MM-DD)

disbursementTo · string<date>

Ngày giải ngân kết thúc (YYYY-MM-DD)

dueDateFrom · string<date>

Ngày đến hạn bắt đầu (YYYY-MM-DD)

dueDateTo · string<date>

Ngày đến hạn kết thúc (YYYY-MM-DD)

pageSize · integer<int32>

Số bản ghi trên mỗi trang

pageIndex · integer<int32>

Vị trí của trang hiện tại

positionId · integer<int32>

Id vị thế

Phản hồi

200

application/json

OK

loans · object[]

Danh sách các khoản vay

Show child attributes

Ví dụ:

[
  {
    "id": 8117,
    "accountNo": "0001179019",
    "positionId": 8426,
    "symbol": "ACB",
    "disbursementDate": "2026-09-10",
    "dueDate": "2026-12-09",
    "initialRate": 1,
    "interestRate": 0.115,
    "overdueInterestRate": 0.18,
    "preferentialPeriod": 0,
    "preferentialInterestRate": 0,
    "principal": 1191245,
    "remainPrincipal": 1191245,
    "remainInterest": 1501
  }
]

pagination · object

Thông tin phân trang của danh sách kết quả.

Show child attributes