> ## 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 Bucket Delta (DV01 by Tenor)

> Computes sensitivity to interest rate changes at specific maturity buckets (e.g., 1Y, 5Y, 10Y). Shows where along the yield curve the portfolio has risk exposure. Critical for interest rate risk management, immunization strategies, and regulatory reporting under FRTB. [Tier: PRO, Credits: 5]



## OpenAPI

````yaml api-specs/risk.json post /quantlib/risk/sensitivities/bucket-delta
openapi: 3.1.0
info:
  title: FinceptQuantLib API - Risk Module
  description: >-
    Professional-grade risk management endpoints including Value at Risk (VaR),
    stress testing, copulas, extreme value theory (EVT), XVA calculations,
    sensitivities, and portfolio hedging. Part of the Pro Tier (5 credits per
    request).
  version: 3.0.0
  contact:
    name: Fincept API Support
    url: https://fincept.in
    email: support@fincept.in
servers:
  - url: https://api.fincept.in
    description: Fincept API Production Server
security:
  - APIKeyHeader: []
tags:
  - name: quantlib-risk
    description: Risk Management Module - Pro Tier (5 credits/request)
    x-displayName: Risk
paths:
  /quantlib/risk/sensitivities/bucket-delta:
    post:
      tags:
        - quantlib-risk
      summary: Calculate Bucket Delta (DV01 by Tenor)
      description: >-
        Computes sensitivity to interest rate changes at specific maturity
        buckets (e.g., 1Y, 5Y, 10Y). Shows where along the yield curve the
        portfolio has risk exposure. Critical for interest rate risk management,
        immunization strategies, and regulatory reporting under FRTB. [Tier:
        PRO, Credits: 5]
      operationId: bucket_delta
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - positions
              properties:
                positions:
                  type: array
                  description: List of fixed income positions with tenor information
                  items:
                    type: object
                    properties:
                      tenor:
                        type: number
                        description: Maturity in years
                      notional:
                        type: number
                      duration:
                        type: number
                  example:
                    - tenor: 2
                      notional: 1000000
                      duration: 1.9
                    - tenor: 5
                      notional: 500000
                      duration: 4.5
                bump_size:
                  type: number
                  description: Rate bump size in decimal (e.g., 0.0001 for 1bp)
                  example: 0.0001
                  default: 0.0001
            example:
              positions:
                - tenor: 1
                  notional: 2000000
                  duration: 0.98
                - tenor: 3
                  notional: 1500000
                  duration: 2.85
                - tenor: 5
                  notional: 1000000
                  duration: 4.52
                - tenor: 10
                  notional: 800000
                  duration: 8.75
              bump_size: 0.0001
      responses:
        '200':
          description: Bucket delta by tenor
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    description: DV01 by tenor bucket
                    additionalProperties:
                      type: number
                    example:
                      1Y: 1960
                      3Y: 4275
                      5Y: 4520
                      10Y: 7000
              example:
                success: true
                data:
                  1Y: 1960
                  3Y: 4275
                  5Y: 4520
                  10Y: 7000
                  total: 17755
        '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 for this 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
  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

````