> ## Documentation Index
> Fetch the complete documentation index at: https://hoalulab.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Thông tin tiền

> Truy vấn thông tin số dư tiểu khoản bao gồm tài sản cơ sở và phái sinh. Dữ liệu phục vụ cho việc theo dõi tài sản, kiểm tra sức mua và quản lý nghĩa vụ tài chính của tiểu khoản giao dịch.



## OpenAPI

````yaml https://cdn.entrade.com.vn/dnse-openapi/doc/dnse-openapi-2026-05-07.yaml get /accounts/{accountNo}/balances
openapi: 3.0.0
info:
  title: DNSE-OpenAPI-V2
  version: 1.0.0
  description: DNSE OpenAPI spec and tests
servers:
  - url: https://openapi-uat.dnse.com.vn
security: []
paths:
  /accounts/{accountNo}/balances:
    parameters:
      - name: accountNo
        in: path
        required: true
        description: Số tiểu khoản
        deprecated: false
        schema:
          type: string
        example: '0001179019'
    get:
      tags:
        - account
      summary: Thông tin tiền
      description: >-
        Truy vấn thông tin số dư tiểu khoản bao gồm tài sản cơ sở và phái sinh.
        Dữ liệu phục vụ cho việc theo dõi tài sản, kiểm tra sức mua và quản lý
        nghĩa vụ tài chính của tiểu khoản giao dịch.
      parameters:
        - name: X-API-Key
          in: header
          required: true
          description: API Key được cấp khi đăng ký dịch vụ
          deprecated: false
          schema:
            type: string
          example: '{{apiKey}}'
        - name: X-Aux-Date
          in: header
          required: true
          description: Thời gian thực hiện yêu cầu
          deprecated: false
          schema:
            type: string
          example: '{{date}}'
        - name: X-Signature
          in: header
          required: true
          description: Chữ ký xác thực yêu cầu
          deprecated: false
          schema:
            type: string
          example: '{{signature}}'
        - name: version
          in: header
          description: 'Phiên bản API '
          schema:
            type: string
            format: date
          example: '2026-05-07'
      responses:
        '200':
          description: OK
          headers:
            Access-Control-Allow-Credentials:
              schema:
                type: boolean
              example: true
            Access-Control-Allow-Headers:
              schema:
                type: string
              example: >-
                Content-Type, Authorization, X-Request-ID, Accept, Origin,
                X-Requested-With
            Access-Control-Allow-Methods:
              schema:
                type: string
              example: GET, POST, PUT, DELETE, OPTIONS, PATCH
            Access-Control-Allow-Origin:
              schema:
                type: string
              example: '*'
            Access-Control-Max-Age:
              schema:
                type: integer
              example: 86400
            Content-Length:
              schema:
                type: integer
              example: 547
            Date:
              schema:
                type: string
              example: Mon, 25 May 2026 04:22:26 GMT
            Vary:
              schema:
                type: string
              example: Origin
            X-Ratelimit-Limit:
              schema:
                type: integer
              example: -1
            X-Ratelimit-Remaining:
              schema:
                type: integer
              example: 0
            X-Ratelimit-Reset:
              schema:
                type: integer
              example: 0
            X-Request-Id:
              schema:
                type: string
              example: unknown
            X-Tyk-Api-Expires:
              schema:
                type: string
              example: Thu, 02 Jan 3000 15:04:00 UTC
          content:
            application/json:
              schema:
                type: object
                properties:
                  stock:
                    type: object
                    properties:
                      totalCash:
                        type: integer
                        format: int32
                        example: 844202971
                        description: >-
                          Tổng tiền (Tiền mặt + Lãi tiền gửi + Tiền bán chờ về +
                          Tiền cổ tức chờ về - Tiền mua trong ngày)
                      availableCash:
                        type: integer
                        format: int32
                        example: 929405163
                        description: Tiền mặt hiện có
                      depositInterest:
                        type: integer
                        format: int32
                        example: 108552
                        description: Lãi tiền gửi không kỳ hạn
                      totalDebt:
                        type: integer
                        format: int32
                        example: 29077926
                        description: Tổng nợ (Nợ margin tạm thu + Nợ margin còn lại)
                      depositFeeAmount:
                        type: integer
                        format: int32
                        example: 1208
                        description: Phí lưu ký
                      secureAmount:
                        type: integer
                        format: int32
                        example: 87310744
                        description: Giá trị lệnh mua đã khớp + phí mua
                      orderSecured:
                        type: integer
                        format: int32
                        example: 29597541
                        description: Giá trị lệnh mua chờ khớp + phí mua
                      withdrawableCash:
                        type: integer
                        format: int32
                        example: 812495669
                        description: Tiền có thể rút
                      cashDividendReceiving:
                        type: integer
                        format: int32
                        example: 2000000
                        description: Tiền cổ tức chờ về
                    example:
                      totalCash: 844202971
                      availableCash: 929405163
                      depositInterest: 108552
                      totalDebt: 29077926
                      depositFeeAmount: 1208
                      secureAmount: 87310744
                      orderSecured: 29597541
                      withdrawableCash: 812495669
                      cashDividendReceiving: 2000000
                    description: ''
                  derivative:
                    type: object
                    properties:
                      pendingDepositWithdraw:
                        type: integer
                        format: int32
                        example: 826996062
                        description: Tiền nộp/rút cọc chờ xử lý
                      remainSecure:
                        type: integer
                        format: int64
                        example: 115078776492
                        description: Cọc còn lại
                      usedSecure:
                        type: integer
                        format: int64
                        example: 6250423766
                        description: Cọc đã sử dụng
                      pendingSecure:
                        type: integer
                        format: int32
                        example: 826996062
                        description: Cọc chờ duyệt
                      holdTaxAndFee:
                        type: integer
                        format: int32
                        example: 0
                        description: Thuế và phí tạm giữ
                      totalLoanDebt:
                        type: integer
                        format: int32
                        example: 0
                        description: Khoản ứng chưa hoàn
                    example:
                      pendingDepositWithdraw: 826996062
                      remainSecure: 115078776492
                      usedSecure: 6250423766
                      pendingSecure: 826996062
                      holdTaxAndFee: 0
                      totalLoanDebt: 0
                    description: ''
              example:
                stock:
                  totalCash: 844202971
                  availableCash: 929405163
                  depositInterest: 108552
                  totalDebt: 29077926
                  depositFeeAmount: 1208
                  secureAmount: 87310744
                  orderSecured: 29597541
                  withdrawableCash: 812495669
                  cashDividendReceiving: 2000000
                derivative:
                  pendingDepositWithdraw: 826996062
                  remainSecure: 115078776492
                  usedSecure: 6250423766
                  pendingSecure: 826996062
                  holdTaxAndFee: 0
                  totalLoanDebt: 0
        '400':
          description: Yêu cầu không hợp lệ
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 400
                    description: Mã HTTP
                    format: int32
                  code:
                    type: string
                    example: OA-003
                    description: Mã lỗi
                  message:
                    type: string
                    example: Thông tin nhập không hợp lệ
                    description: Thông điệp lỗi
              example:
                code: OA-003
                message: Thông tin nhập không hợp lệ
                status: 400
        '500':
          description: Lỗi hệ thống
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 500
                    description: Mã HTTP
                    format: int32
                  code:
                    type: string
                    example: OA-009
                    description: Mã lỗi
                  message:
                    type: string
                    example: Lỗi hệ thống
                    description: Thông điệp lỗi
              example:
                code: OA-009
                message: Lỗi hệ thống
                status: 500

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.