Skip to main content
GET
/
kvaults
/
vaults
/
{pubkey}
/
metrics
/
history
Get historical KVault metrics
curl --request GET \
  --url https://api.kamino.finance/kvaults/vaults/{pubkey}/metrics/history
[
  {
    "timestamp": 123,
    "tvl": "1234.56789",
    "solTvl": "1234.56789",
    "apy": "0.2",
    "apyTheoretical": "0.2",
    "apyActual": "0.2",
    "apyFarmRewards": "0.2",
    "apyReservesIncentives": "0.2",
    "apyIncentives": "0.2",
    "sharePrice": "1234.56789",
    "interest": "1234.56789",
    "interestUsd": "1234.56789",
    "interestSol": "1234.56789",
    "reserves": [
      {
        "pubkey": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
        "supplyApy": "0.2",
        "rewardsApy": "0.2",
        "allocationRatio": "1234.56789",
        "rewardTokens": [
          {
            "tokenMint": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
            "apy": "0.2"
          }
        ]
      }
    ],
    "vaultRewards": [
      {
        "tokenMint": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
        "apy": "0.2"
      }
    ]
  }
]

Path Parameters

​
pubkey
string
required

Valid base58-encoded address

Example:

"VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd"

Query Parameters

​
start
default:1970-01-01T00:00:00.000Z

Start date of the range (defaults to Unix epoch). Accepts ISO string or epoch in ms.

Example:

"1970-01-01T00:00:00.000Z"

​
end
default:2026-01-26T11:46:53.028Z

End date of the range (defaults to current time). Accepts ISO string or epoch in ms.

Example:

"2025-01-01T00:00:00.000Z"

Response

OK

​
timestamp
number
required

Unix timestamp in milliseconds

​
tvl
string
required

Total Value Locked in token denomination

Example:

"1234.56789"

​
solTvl
string
required

Total Value Locked in SOL

Example:

"1234.56789"

​
apy
string
required

Annual Percentage Yield

Example:

"0.2"

​
apyTheoretical
string
required

Theoretical Annual Percentage Yield

Example:

"0.2"

​
apyActual
string
required

Actual Annual Percentage Yield

Example:

"0.2"

​
apyFarmRewards
string
required

Annual Percentage Yield from Farm Rewards

Example:

"0.2"

​
apyReservesIncentives
string
required

Annual Percentage Yield from Reserves Incentives

Example:

"0.2"

​
apyIncentives
string
required

Annual Percentage Yield from Incentives

Example:

"0.2"

​
sharePrice
string
required

Share Price of the vault

Example:

"1234.56789"

​
interest
string
required

Interest earned in token denomination

Example:

"1234.56789"

​
interestUsd
string
required

Interest earned in USD

Example:

"1234.56789"

​
interestSol
string
required

Interest earned in SOL

Example:

"1234.56789"

​
reserves
object[]
required

List of reserves with rewards

​
vaultRewards
object[]
required

List of vault reward tokens