Benchmarks

Get historical vault APY

Returns a daily timeseries of rolling 7-day APY for any vault with on-chain snapshots. Works with both internal vaults (sharePrice) and ERC-4626 vaults (convertToAssets). Specify the vault by address or token symbol.

get/v3/benchmarks/vault-apy

Request

  • Base URL: https://api.creditcoop.xyz
  • URL: https://api.creditcoop.xyz/v3/benchmarks/vault-apy
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://clerk.creditcoop.xyz/oauth/authorize, token URL https://clerk.creditcoop.xyz/oauth/token)
    • none

Query parameters

addressstring

Vault contract address (e.g., 0xabc...)

symbolstring

Token symbol to look up the vault (e.g., stataEthUSDC)

networkIdstring required
Example:eip155:1

CAIP-2 network identifier (e.g., eip155:1 for Ethereum, eip155:8453 for Base)

fromstring date
Example:2025-01-01

Start date (YYYY-MM-DD). Defaults to earliest available data.

tostring date
Example:2025-12-31

End date (YYYY-MM-DD). Defaults to latest available data.

Response

Default Response

addressstring required
networkIdstring required
symbolstring

Example response

{
  "data": [
    {
      "date": "2025-06-15"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.