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

# Maximum Sharpe Ratio Portfolio

> Constructs the maximum Sharpe ratio portfolio, also known as the tangency portfolio. This portfolio maximizes risk-adjusted returns and represents the optimal risky portfolio in mean-variance theory.

**Use Cases:**
- Constructing the optimal risky portfolio for two-fund separation
- Maximizing risk-adjusted returns in active management
- Identifying the market portfolio in CAPM framework
- Benchmark for performance evaluation

**Mathematical Background:**
Maximizes: (R_p - R_f) / σ_p
Subject to: Σw_i = 1, and optional constraints

Where R_p is portfolio return, R_f is risk-free rate, and σ_p is portfolio volatility.

**Credits:** 5 per request [Tier: PRO, Credits: 5]



## OpenAPI

````yaml api-specs/portfolio.json post /quantlib/portfolio/optimize/max-sharpe
openapi: 3.1.0
info:
  title: FinceptQuantLib API - Portfolio
  description: >-
    Portfolio optimization and risk management module for institutional-grade
    portfolio construction, analysis, and monitoring. Includes mean-variance
    optimization, Black-Litterman, risk parity, and comprehensive risk metrics.


    **Tier:** Pro (5 credits per request)


    **Key Features:**

    - Mean-variance optimization (minimum variance, maximum Sharpe, target
    return)

    - Efficient frontier construction with tangency portfolio identification

    - Black-Litterman model for Bayesian view incorporation

    - Risk parity strategies (ERC, HRP, inverse volatility)

    - Comprehensive risk metrics (VaR, CVaR, tracking error, information ratio)

    - Advanced portfolio analytics (risk contribution, drawdown,
    diversification)
  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-portfolio
    description: Portfolio optimization and risk management endpoints
    x-displayName: Portfolio
paths:
  /quantlib/portfolio/optimize/max-sharpe:
    post:
      tags:
        - quantlib-portfolio
      summary: Maximum Sharpe Ratio Portfolio
      description: >-
        Constructs the maximum Sharpe ratio portfolio, also known as the
        tangency portfolio. This portfolio maximizes risk-adjusted returns and
        represents the optimal risky portfolio in mean-variance theory.


        **Use Cases:**

        - Constructing the optimal risky portfolio for two-fund separation

        - Maximizing risk-adjusted returns in active management

        - Identifying the market portfolio in CAPM framework

        - Benchmark for performance evaluation


        **Mathematical Background:**

        Maximizes: (R_p - R_f) / σ_p

        Subject to: Σw_i = 1, and optional constraints


        Where R_p is portfolio return, R_f is risk-free rate, and σ_p is
        portfolio volatility.


        **Credits:** 5 per request [Tier: PRO, Credits: 5]
      operationId: max_sharpe
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - expected_returns
                - covariance_matrix
              properties:
                expected_returns:
                  type: array
                  items:
                    type: number
                  description: Expected returns for each asset (annualized)
                  example:
                    - 0.08
                    - 0.12
                    - 0.1
                    - 0.15
                covariance_matrix:
                  type: array
                  items:
                    type: array
                    items:
                      type: number
                  description: Asset covariance matrix (annualized)
                  example:
                    - - 0.04
                      - 0.006
                      - 0.008
                      - 0.01
                    - - 0.006
                      - 0.09
                      - 0.012
                      - 0.015
                    - - 0.008
                      - 0.012
                      - 0.0625
                      - 0.018
                    - - 0.01
                      - 0.015
                      - 0.018
                      - 0.16
                rf_rate:
                  type: number
                  description: >-
                    Risk-free rate (annualized). Critical for Sharpe ratio
                    calculation.
                  default: 0
                  example: 0.03
                min_weights:
                  type: array
                  items:
                    type: number
                  description: Minimum weight constraints for each asset
                  nullable: true
                  example:
                    - 0
                    - 0
                    - 0
                    - 0
                max_weights:
                  type: array
                  items:
                    type: number
                  description: Maximum weight constraints for each asset
                  nullable: true
                  example:
                    - 0.5
                    - 0.5
                    - 0.5
                    - 0.5
      responses:
        '200':
          description: Maximum Sharpe ratio portfolio successfully optimized
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      weights:
                        type: array
                        items:
                          type: number
                        description: Optimal tangency portfolio weights
                        example:
                          - 0.25
                          - 0.35
                          - 0.3
                          - 0.1
                      expected_return:
                        type: number
                        description: Expected portfolio return (annualized)
                        example: 0.1125
                      volatility:
                        type: number
                        description: Portfolio volatility (annualized)
                        example: 0.2156
                      sharpe_ratio:
                        type: number
                        description: Maximum achievable Sharpe ratio
                        example: 0.3826
        '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
      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
                  - expected_returns
                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

````