# Get KLend obligation history

Get historical metrics for a specific obligation in a Kamino Lending market. This V2 endpoint supports using stake rate for obligation value calculation when useStakeRateForObligation is true.

Endpoint: GET /v2/kamino-market/{marketPubkey}/obligations/{obligationPubkey}/metrics/history
Version: 1.0.0

## Path parameters:

  - `marketPubkey` (string, required)
    Kamino Lend market public key
    Example: "7u3HeHxYDLhnCoErrtycNokbQYbWGzLs6JSDqGAv5PfF"

  - `obligationPubkey` (string, required)
    Kamino Lend obligation public key
    Example: "63QrAB1okxCc4FpsgcKYHjYTp1ua8ch6mLReyKRdc22o"

## Query parameters:

  - `env` (string)
    Solana cluster environment
    Enum: "mainnet-beta", "devnet", "localnet"

  - `start` (any)
    Date input (ISO 8601 string or epoch in ms)

  - `end` (any)
    Date input (ISO 8601 string or epoch in ms)

  - `useStakeRateForObligation` (string)
    Use stake rate to calculate net SOL value
    Enum: "true", "false"

## Response 200 fields (application/json):

  - `obligation` (string, required)
    Market public key
    Example: "3HdrCvoJ91bwgVTejdDXfguo6S2A9jjUkBR5fasq4WhB"

  - `history` (array, required)
    Historical metrics for the obligation

  - `history.timestamp` (string, required)
    Timestamp of the metrics snapshot
    Example: "2025-10-17T00:00:00.000Z"

  - `history.refreshedStats` (object, required)
    Refreshed obligation statistics

  - `history.refreshedStats.leverage` (string, required)
    Total Value Locked in USD
    Example: "1.0580080950430842892"

  - `history.refreshedStats.borrowLimit` (string, required)
    Total Value Locked in USD
    Example: "1.3496969599567630906"

  - `history.refreshedStats.loanToValue` (string, required)
    Total Value Locked in USD
    Example: "0.054827647647367082766"

  - `history.refreshedStats.liquidationLtv` (string, required)
    Total Value Locked in USD
    Example: "0.75000000000000000001"

  - `history.refreshedStats.netAccountValue` (string, required)
    Total Value Locked in USD
    Example: "1.7239138521696367095"

  - `history.refreshedStats.userTotalBorrow` (string, required)
    Total Value Locked in USD
    Example: "0.10000095858274584538"

  - `history.refreshedStats.userTotalDeposit` (string, required)
    Total Value Locked in USD
    Example: "1.8239148107523825549"

  - `history.refreshedStats.borrowUtilization` (string, required)
    Total Value Locked in USD
    Example: "0.074091415739685246983"

  - `history.refreshedStats.borrowLiquidationLimit` (string, required)
    Total Value Locked in USD
    Example: "1.3679361080642869162"

  - `history.refreshedStats.userTotalCollateralDeposit` (string, required)
    Total Value Locked in USD
    Example: "1.8239148107523825549"

  - `history.refreshedStats.userTotalLiquidatableDeposit` (string, required)
    Total Value Locked in USD
    Example: "1.8239148107523825549"

  - `history.refreshedStats.potentialElevationGroupUpdate` (number, required)
    Potential elevation group update indicator

  - `history.refreshedStats.userTotalBorrowBorrowFactorAdjusted` (string, required)
    Total Value Locked in USD
    Example: "0.10000095858274584538"

  - `history.deposits` (array, required)
    Array of deposit positions

  - `history.deposits.amount` (string, required)
    Total Value Locked in USD
    Example: "10000708.005624756258"

  - `history.deposits.mintAddress` (string, required)
    Market public key
    Example: "So11111111111111111111111111111111111111112"

  - `history.deposits.marketValueRefreshed` (string, required)
    Total Value Locked in USD
    Example: "1.8239148107523825549"

  - `history.borrows` (array, required)
    Array of borrow positions

  - `history.tag` (integer, required)
    Obligation type tag (0 = Vanilla, 1 = Multiply, 2 = Lending, 3 = Leverage)

  - `history.obligationSolValues` (object, required)
    Obligation values denominated in SOL

  - `history.obligationSolValues.netValueSol` (string, required)
    Total Value Locked in USD
    Example: "0.009469142566566941841900274495955292427975"

  - `history.obligationSolValues.collateralValueSol` (string, required)
    Total Value Locked in USD
    Example: "0.01001842948854487210536205388880118310325"

  - `history.obligationSolValues.debtValueSol` (string, required)
    Total Value Locked in USD
    Example: "0.0005492869219779302633519230615141419874818"

  - `history.obligationSolValues.solPrice` (string, required)
    Total Value Locked in USD
    Example: "182.05596125"

  - `history.obligationSolValues.timestampSolPrice` (string, required)
    Timestamp of the metrics snapshot
    Example: "2025-10-17T00:00:00.000Z"

  - `history.obligationSolValues.timestampObligation` (string, required)
    Timestamp of the metrics snapshot
    Example: "2025-10-17T00:00:00.000Z"

## Response 500 fields (application/json):

  - `error` (string, required)
    Error message for internal server failure
    Example: "An internal error occurred"