> ## 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.

# PP/MMR tài khoản

> Lấy thông tin PP/MMR của tài khoản.



## OpenAPI

````yaml /vi/openapi/ssi.2026-08-21.openapi.yaml get /api/v3/trading/ppmmrAccount
openapi: 3.1.2
info:
  title: SSI FastConnect Open API
  version: 3.0.0
servers:
  - url: https://api.ssi.com.vn
    description: Production
security:
  - SsiBearerAuth: []
tags:
  - name: authentication
    description: Xác thực và quản lý token.
    x-group: Xác thực
  - name: account
    description: Thông tin tài khoản giao dịch.
    x-group: Tài khoản
  - name: market-data
    description: Dữ liệu thị trường.
    x-group: Dữ liệu thị trường
  - name: trading
    description: Giao dịch và quản lý lệnh.
    x-group: Giao dịch
  - name: conditional-orders
    description: Lệnh điều kiện.
    x-group: Lệnh điều kiện
paths:
  /api/v3/trading/ppmmrAccount:
    get:
      tags:
        - trading
      summary: PP/MMR tài khoản
      description: Lấy thông tin PP/MMR của tài khoản.
      operationId: getPpmmrAccount
      parameters:
        - name: clientId
          in: query
          description: >-
            Tài khoản 6 số định danh khách hàng tại SSI. Nếu số tài khoản là
            003C123888 thì clientId = 123888
          required: false
          schema:
            type: string
        - name: accountNo
          in: query
          description: Tài khoản giao dịch cần lấy thông tin PP/MMR.
          required: true
          schema:
            type: string
        - $ref: '#/components/parameters/ContentType'
        - $ref: '#/components/parameters/UserAgent'
        - $ref: '#/components/parameters/AcceptLanguage'
      responses:
        '200':
          description: Thành công.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PpmmrAccountResponse'
              examples:
                EQUITY:
                  summary: Tài khoản cơ sở
                  value:
                    equity:
                      accountNo: F987654
                      dividend: '0'
                      loanValue: '3200'
                      totalDebt: '0'
                      debt: '0'
                      liability: '0'
                      liabilitySSI: '0'
                      netLiability: '0'
                      fees: '0'
                      interestSSI: '0'
                      interestSPV: '0'
                      withdrawable: '12345000'
                      ee: '12358839'
                      ee50: '24717678'
                      ee60: '20598065'
                      ee70: '17655484'
                      ee80: '15448549'
                      ee90: '13732043'
                      action: Normal
                      actionSSI: Normal
                      equity: '12363039'
                      equitySSI: '12363039'
                      eeCash: '12345000'
                      holdSubscription: '0'
                      bankBalance: '0'
                      onHoldCash: '0'
                      doverdue: '0'
                      doverdue_ssi: null
                      accountBalance: '12345000'
                      d: '0'
                      dspv: '0'
                      dssi: '0'
                      cia: '0'
                      collateralAsset: '12363039'
                      collateralAssetSSI: '12363039'
                      totalAssets: '12363039'
                      totalEquity: '12363039'
                      totalEquitySSI: '12363039'
                      callLMV: '0'
                      forceLMV: '0'
                      callLMVSSI: '0'
                      forceLMVSSI: '0'
                      lmv: '8400'
                      lmvMargin: '8400'
                      lmvMarginSSI: '8400'
                      lmvNonMarginable: '0'
                      lmvNonMarginableSSI: '0'
                      preLoan: '0'
                      marginRatio: '1'
                      marginRatioSSI: '1'
                      purchasingPower: '24717678'
                      eeOrigin: '12358839'
                      buyUnmatched: '0'
                      sellUnmatched: '0'
                      buyT0: '0'
                      sellT0: '5432'
                      sellT1: '0'
                      sellT2: '0'
                      buyT1: '0'
                      buyT2: '0'
                      creditLimit: '0'
                      marginCallLMVSold: '0'
                      marginCallLMVSoldSSI: '0'
                      marginCall: '0'
                      marginCallSSI: '0'
                      collateralA: '0'
                      collateralNon: '0'
                      collateralASSI: '0'
                      collateralNonSSI: '0'
                      callMargin: '2940'
                      callForcesell: '2100'
                      callMarginSSI: '2940'
                      callForcesellSSI: '2100'
                      ar: '5432'
                    derivative: null
                DERIVATIVE:
                  summary: Tài khoản phái sinh
                  value:
                    equity: null
                    derivative:
                      accountNo: F384271
                      accountBalance: '15003750'
                      fee: '0'
                      commission: '0'
                      interest: '720'
                      loan: '0'
                      deliveryAmount: '0'
                      floatingPL: '0'
                      tradingPL: '0'
                      totalPL: '0'
                      marginable: '14837750'
                      depositable: '14837750'
                      rcCall: '0'
                      withdrawable: '15003750'
                      nonCashDrawableRCCall: '0'
                      cashSSI: '15003750'
                      validNonCashSSI: '0'
                      totalAssetSSI: '15003750'
                      withdrawableSSI: '15003750'
                      eeSSI: '9902480'
                      cashVSDC: '0'
                      validNonCashVSDC: '0'
                      totalAssetVSDC: '0'
                      withdrawableVSDC: '0'
                      eeVSDC: '0'
                      spreadMarginSSI: '0'
                      deliveryMarginSSI: '0'
                      marginReqSSI: '0'
                      accountRatioSSI: '0'
                      usedLimitWarningLevel1SSI: '66'
                      usedLimitWarningLevel2SSI: '80'
                      usedLimitWarningLevel3SSI: '100'
                      marginCallSSI: '0'
                      spreadMarginVSDC: '0'
                      deliveryMarginVSDC: '0'
                      marginReqVSDC: '0'
                      accountRatioVSDC: '0'
                      usedLimitWarningLevel1VSDC: '85'
                      usedLimitWarningLevel2VSDC: '90'
                      usedLimitWarningLevel3VSDC: '95'
                      marginCallVSDC: '0'
                      totalEquity: '15003750'
                      extInterest: '0'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalError'
      security:
        - SsiBearerAuth: []
components:
  parameters:
    ContentType:
      name: Content-Type
      in: header
      required: true
      description: Định dạng nội dung request body. Chủ yếu là application/json.
      schema:
        type: string
        default: application/json
    UserAgent:
      name: User-Agent
      in: header
      required: false
      description: Thông tin client gửi request.
      schema:
        type: string
    AcceptLanguage:
      name: Accept-Language
      in: header
      required: false
      description: >-
        Ngôn ngữ phản hồi mong muốn. Nếu không có header này, hệ thống sẽ mặc
        định là en
      schema:
        type: string
        default: en
  schemas:
    PpmmrAccountResponse:
      type: object
      required:
        - equity
        - derivative
      properties:
        equity:
          description: Thông tin PP/MMR của tài khoản cơ sở.
          type:
            - object
            - 'null'
          properties:
            accountNo:
              description: Số tài khoản giao dịch.
              type: string
            dividend:
              description: Cổ tức.
              type: string
            loanValue:
              description: Giá trị khoản vay.
              type: string
            totalDebt:
              description: Tổng dư nợ.
              type: string
            debt:
              description: Dư nợ.
              type: string
            liability:
              description: Dư nợ phải trả.
              type: string
            liabilitySSI:
              description: Dư nợ phải trả tại SSI.
              type: string
            netLiability:
              description: Tổng dư nợ ròng.
              type: string
            fees:
              description: Phí giao dịch.
              type: string
            interestSSI:
              description: Lãi suất vay tại SSI.
              type: string
            interestSPV:
              description: Lãi suất vay tại SPV.
              type: string
            withdrawable:
              description: Số tiền có thể rút.
              type: string
            ee:
              description: Equity Excess.
              type: string
            ee50:
              description: EE tại tỷ lệ 50%.
              type: string
            ee60:
              description: EE tại tỷ lệ 60%.
              type: string
            ee70:
              description: EE tại tỷ lệ 70%.
              type: string
            ee80:
              description: EE tại tỷ lệ 80%.
              type: string
            ee90:
              description: EE tại tỷ lệ 90%.
              type: string
            action:
              description: Hành động hiện tại.
              type: string
            actionSSI:
              description: Hành động hiện tại tại SSI.
              type: string
            equity:
              description: Vốn chủ sở hữu.
              type: string
            equitySSI:
              description: Vốn chủ sở hữu tại SSI.
              type: string
            eeCash:
              description: EE mặt bằng tiền mặt.
              type: string
            holdSubscription:
              description: Số tiền giữ lại cho đăng ký phát hành.
              type: string
            bankBalance:
              description: Số dư ngân hàng.
              type: string
            onHoldCash:
              description: Tiền mặt đang bị giữ.
              type: string
            doverdue:
              description: Quá hạn.
              type: string
            doverdue_ssi:
              description: Quá hạn tại SSI.
              type:
                - string
                - 'null'
            accountBalance:
              description: Số dư tài khoản.
              type: string
            d:
              description: Dư nợ chính.
              type: string
            dspv:
              description: Dư nợ SPV.
              type: string
            dssi:
              description: Dư nợ SSI.
              type: string
            cia:
              description: CIA - Current Investment Account.
              type: string
            collateralAsset:
              description: Tài sản thế chấp.
              type: string
            collateralAssetSSI:
              description: Tài sản thế chấp tại SSI.
              type: string
            totalAssets:
              description: Tổng tài sản.
              type: string
            totalEquity:
              description: Tổng vốn chủ sở hữu.
              type: string
            totalEquitySSI:
              description: Tổng vốn chủ sở hữu tại SSI.
              type: string
            callLMV:
              description: LMV trong trạng thái Margin Call.
              type: string
            forceLMV:
              description: LMV trong trạng thái bắt buộc bán.
              type: string
            callLMVSSI:
              description: LMV Margin Call tại SSI.
              type: string
            forceLMVSSI:
              description: LMV bắt buộc bán tại SSI.
              type: string
            lmv:
              description: Long Market Value - Giá trị thị trường của vị thế dài.
              type: string
            lmvMargin:
              description: LMV áp dụng ký quỹ.
              type: string
            lmvMarginSSI:
              description: LMV ký quỹ tại SSI.
              type: string
            lmvNonMarginable:
              description: LMV không áp dụng ký quỹ.
              type: string
            lmvNonMarginableSSI:
              description: LMV không ký quỹ tại SSI.
              type: string
            preLoan:
              description: Khoản vay trước.
              type: string
            marginRatio:
              description: Tỷ lệ ký quỹ.
              type: string
            marginRatioSSI:
              description: Tỷ lệ ký quỹ tại SSI.
              type: string
            purchasingPower:
              description: Sức mua.
              type: string
            eeOrigin:
              description: EE gốc.
              type: string
            buyUnmatched:
              description: Khối lượng mua chưa khớp.
              type: string
            sellUnmatched:
              description: Khối lượng bán chưa khớp.
              type: string
            buyT0:
              description: Khối lượng mua T+0 chưa thanh toán.
              type: string
            sellT0:
              description: Khối lượng bán T+0 chưa thanh toán.
              type: string
            sellT1:
              description: Khối lượng bán T+1 chưa thanh toán.
              type: string
            sellT2:
              description: Khối lượng bán T+2 chưa thanh toán.
              type: string
            buyT1:
              description: Khối lượng mua T+1 chưa thanh toán.
              type: string
            buyT2:
              description: Khối lượng mua T+2 chưa thanh toán.
              type: string
            creditLimit:
              description: Hạn mức tín dụng.
              type: string
            marginCallLMVSold:
              description: LMV bán trong Margin Call.
              type: string
            marginCallLMVSoldSSI:
              description: LMV bán Margin Call tại SSI.
              type: string
            marginCall:
              description: Margin Call.
              type: string
            marginCallSSI:
              description: Margin Call tại SSI.
              type: string
            collateralA:
              description: Tài sản thế chấp A (loại A).
              type: string
            collateralNon:
              description: Tài sản thế chấp không phải A.
              type: string
            collateralASSI:
              description: Tài sản thế chấp A tại SSI.
              type: string
            collateralNonSSI:
              description: Tài sản thế chấp không A tại SSI.
              type: string
            callMargin:
              description: Margin Call.
              type: string
            callForcesell:
              description: Bắt buộc bán.
              type: string
            callMarginSSI:
              description: Margin Call tại SSI.
              type: string
            callForcesellSSI:
              description: Bắt buộc bán tại SSI.
              type: string
            ar:
              description: Account Ratio.
              type: string
        derivative:
          description: Thông tin PP/MMR của tài khoản phái sinh.
          type:
            - object
            - 'null'
          properties:
            accountNo:
              description: Số tài khoản giao dịch phái sinh.
              type: string
            accountBalance:
              description: Số dư tài khoản phái sinh.
              type: string
            fee:
              description: Phí giao dịch phái sinh.
              type: string
            commission:
              description: Hoa hồng giao dịch phái sinh.
              type: string
            interest:
              description: Lãi suất vay phái sinh.
              type: string
            loan:
              description: Dư nợ vay phái sinh.
              type: string
            deliveryAmount:
              description: Số tiền giao hàng phái sinh.
              type: string
            floatingPL:
              description: Lãi/lỗ chưa thực hiện phái sinh.
              type: string
            tradingPL:
              description: Lãi/lỗ đã thực hiện phái sinh.
              type: string
            totalPL:
              description: Tổng lãi/lỗ phái sinh.
              type: string
            marginable:
              description: Khối lượng áp dụng ký quỹ.
              type: string
            depositable:
              description: Khối lượng có thể ký quỹ.
              type: string
            rcCall:
              description: RC Call - Margin Call.
              type: string
            withdrawable:
              description: Số tiền có thể rút từ tài khoản phái sinh.
              type: string
            nonCashDrawableRCCall:
              description: Tiền không mặt có thể rút trong RC Call.
              type: string
            cashSSI:
              description: Tiền mặt trong tài khoản phái sinh tại SSI.
              type: string
            validNonCashSSI:
              description: Tiền không mặt hợp lệ tại SSI.
              type: string
            totalAssetSSI:
              description: Tổng tài sản phái sinh tại SSI.
              type: string
            withdrawableSSI:
              description: Số tiền có thể rút từ SSI.
              type: string
            eeSSI:
              description: Equity Excess tại SSI.
              type: string
            cashVSDC:
              description: Tiền mặt trong tài khoản phái sinh tại VSDC.
              type: string
            validNonCashVSDC:
              description: Tiền không mặt hợp lệ tại VSDC.
              type: string
            totalAssetVSDC:
              description: Tổng tài sản phái sinh tại VSDC.
              type: string
            withdrawableVSDC:
              description: Số tiền có thể rút từ VSDC.
              type: string
            eeVSDC:
              description: Equity Excess tại VSDC.
              type: string
            spreadMarginSSI:
              description: Spread Margin tại SSI.
              type: string
            deliveryMarginSSI:
              description: Delivery Margin tại SSI.
              type: string
            marginReqSSI:
              description: Margin Requirement tại SSI.
              type: string
            accountRatioSSI:
              description: Account Ratio tại SSI.
              type: string
            usedLimitWarningLevel1SSI:
              description: Mức cảnh báo sử dụng hạn mức Level 1 tại SSI.
              type: string
            usedLimitWarningLevel2SSI:
              description: Mức cảnh báo sử dụng hạn mức Level 2 tại SSI.
              type: string
            usedLimitWarningLevel3SSI:
              description: Mức cảnh báo sử dụng hạn mức Level 3 tại SSI.
              type: string
            marginCallSSI:
              description: Margin Call tại SSI.
              type: string
            spreadMarginVSDC:
              description: Spread Margin tại VSDC.
              type: string
            deliveryMarginVSDC:
              description: Delivery Margin tại VSDC.
              type: string
            marginReqVSDC:
              description: Margin Requirement tại VSDC.
              type: string
            accountRatioVSDC:
              description: Account Ratio tại VSDC.
              type: string
            usedLimitWarningLevel1VSDC:
              description: Mức cảnh báo sử dụng hạn mức Level 1 tại VSDC.
              type: string
            usedLimitWarningLevel2VSDC:
              description: Mức cảnh báo sử dụng hạn mức Level 2 tại VSDC.
              type: string
            usedLimitWarningLevel3VSDC:
              description: Mức cảnh báo sử dụng hạn mức Level 3 tại VSDC.
              type: string
            marginCallVSDC:
              description: Margin Call tại VSDC.
              type: string
            totalEquity:
              description: Tổng vốn chủ sở hữu phái sinh.
              type: string
            extInterest:
              description: Lãi suất vay ngoài phái sinh.
              type: string
    ErrorResponse:
      type: object
      properties:
        code:
          description: Mã kết quả hoặc mã xác thực giao dịch.
          type: string
        msg:
          description: Thông báo kết quả xử lý.
          type: string
  responses:
    BadRequest:
      description: Yêu cầu không hợp lệ.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: Chưa được xác thực hoặc token không hợp lệ.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalError:
      description: Lỗi nội bộ máy chủ.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    SsiBearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Access token lấy từ endpoint /api/v3/auth/token hoặc
        /api/v3/auth/refresh.

````

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