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

# Calculate Basel III Capital Ratios

> Calculates all Basel III regulatory capital ratios including CET1 (Common Equity Tier 1), Tier 1, Total Capital, and optionally the Leverage Ratio. Compares results against minimum regulatory requirements (CET1 >= 4.5%, Tier 1 >= 6%, Total >= 8%) and returns compliance flags. Use this for regulatory capital adequacy assessments, board reporting, and supervisory submissions. The leverage ratio (Tier 1 / Total Exposure) is only calculated if total_exposure is provided. [Tier: ENTERPRISE, Credits: 10]



## OpenAPI

````yaml api-specs/regulatory.json post /quantlib/regulatory/basel/capital-ratios
openapi: 3.1.0
info:
  title: FinceptQuantLib API - Regulatory
  description: >-
    Pro-tier regulatory compliance and capital adequacy endpoints covering Basel
    III capital ratios and RWA calculations, SA-CCR counterparty credit risk
    exposure metrics, IFRS 9 expected credit loss provisioning, liquidity
    coverage ratios (LCR/NSFR), and stress testing capital projections. All
    endpoints require Pro tier access and consume 5 credits per request.
  version: 3.0.0
  contact:
    name: Fincept API Support
    url: https://fincept.in
servers:
  - url: https://api.fincept.in
    description: Fincept API Production Server
security:
  - APIKeyHeader: []
tags:
  - name: quantlib-regulatory
    description: >-
      Regulatory compliance and capital adequacy calculations for Basel III,
      SA-CCR, IFRS 9, liquidity ratios, and stress testing. Pro tier required.
    x-displayName: Regulatory
paths:
  /quantlib/regulatory/basel/capital-ratios:
    post:
      tags:
        - quantlib-regulatory
      summary: Calculate Basel III Capital Ratios
      description: >-
        Calculates all Basel III regulatory capital ratios including CET1
        (Common Equity Tier 1), Tier 1, Total Capital, and optionally the
        Leverage Ratio. Compares results against minimum regulatory requirements
        (CET1 >= 4.5%, Tier 1 >= 6%, Total >= 8%) and returns compliance flags.
        Use this for regulatory capital adequacy assessments, board reporting,
        and supervisory submissions. The leverage ratio (Tier 1 / Total
        Exposure) is only calculated if total_exposure is provided. [Tier:
        ENTERPRISE, Credits: 10]
      operationId: capital_ratios
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - cet1_capital
                - tier1_capital
                - total_capital
                - risk_weighted_assets
              properties:
                cet1_capital:
                  type: number
                  description: >-
                    Common Equity Tier 1 capital (retained earnings, common
                    shares, accumulated other comprehensive income, qualifying
                    minority interests)
                  example: 85000000
                tier1_capital:
                  type: number
                  description: >-
                    Total Tier 1 capital (CET1 + Additional Tier 1 such as
                    perpetual non-cumulative preferred stock)
                  example: 95000000
                total_capital:
                  type: number
                  description: >-
                    Total regulatory capital (Tier 1 + Tier 2 capital including
                    subordinated debt, loan loss reserves)
                  example: 120000000
                risk_weighted_assets:
                  type: number
                  description: >-
                    Total risk-weighted assets (credit RWA + market RWA +
                    operational RWA)
                  example: 950000000
                total_exposure:
                  type: number
                  description: >-
                    Total exposure measure for leverage ratio calculation
                    (on-balance sheet + derivatives + securities financing).
                    Optional.
                  example: 1500000000
                  nullable: true
            examples:
              regional_bank:
                summary: Regional bank capital structure
                value:
                  cet1_capital: 85000000
                  tier1_capital: 95000000
                  total_capital: 120000000
                  risk_weighted_assets: 950000000
                  total_exposure: 1500000000
              investment_firm:
                summary: Investment firm (no leverage ratio)
                value:
                  cet1_capital: 42000000
                  tier1_capital: 42000000
                  total_capital: 55000000
                  risk_weighted_assets: 480000000
      responses:
        '200':
          description: Capital ratios calculated successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      cet1_ratio:
                        type: number
                        description: >-
                          Common Equity Tier 1 ratio (minimum regulatory
                          requirement: 4.5%)
                        example: 0.08947368421052632
                      tier1_ratio:
                        type: number
                        description: >-
                          Tier 1 capital ratio (minimum regulatory requirement:
                          6%)
                        example: 0.1
                      total_capital_ratio:
                        type: number
                        description: >-
                          Total capital ratio (minimum regulatory requirement:
                          8%)
                        example: 0.12631578947368421
                      leverage_ratio:
                        type: number
                        description: >-
                          Leverage ratio (Tier 1 / Total Exposure), only present
                          if total_exposure provided. Minimum: 3%
                        example: 0.06333333333333334
                      cet1_adequate:
                        type: boolean
                        description: Whether CET1 ratio meets minimum 4.5% requirement
                        example: true
                      tier1_adequate:
                        type: boolean
                        description: Whether Tier 1 ratio meets minimum 6% requirement
                        example: true
                      total_adequate:
                        type: boolean
                        description: >-
                          Whether Total Capital ratio meets minimum 8%
                          requirement
                        example: true
              examples:
                well_capitalized:
                  summary: Well-capitalized institution
                  value:
                    success: true
                    data:
                      cet1_ratio: 0.08947368421052632
                      tier1_ratio: 0.1
                      total_capital_ratio: 0.12631578947368421
                      leverage_ratio: 0.06333333333333334
                      cet1_adequate: true
                      tier1_adequate: true
                      total_adequate: true
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '402':
          $ref: '#/components/responses/InsufficientCreditsError'
        '422':
          $ref: '#/components/responses/ValidationError'
components:
  responses:
    UnauthorizedError:
      description: Authentication information is missing or invalid
      content:
        application/json:
          schema:
            type: object
            properties:
              detail:
                type: string
                example: Invalid API key
    InsufficientCreditsError:
      description: Insufficient API credits to complete request
      content:
        application/json:
          schema:
            type: object
            properties:
              detail:
                type: string
                example: Insufficient credits. This endpoint requires 5 credits.
    ValidationError:
      description: Request validation error
      content:
        application/json:
          schema:
            type: object
            properties:
              detail:
                type: array
                items:
                  type: object
                  properties:
                    loc:
                      type: array
                      items:
                        type: string
                    msg:
                      type: string
                    type:
                      type: string
          example:
            detail:
              - loc:
                  - body
                  - cet1_capital
                msg: field required
                type: value_error.missing
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        API key for authentication. Get your key at
        https://api.fincept.in/auth/register

````