Benchmarks

Benchmark vault APY rates computed from on-chain snapshots

Get historical vault APY

get

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.

Authorizations

ApiKeyAuthBearerAuthOAuth2

x-api-keystringOptional

API key in the format: cc_xxx_yyy (for customer API routes)

Query parameters

addressstringOptional

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

symbolstringOptional

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

networkIdstringRequired

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

Example: eip155:1

fromstring · dateOptional

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

Example: 2025-01-01

tostring · dateOptional

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

Example: 2025-12-31

Responses

200

Default Response

application/json

addressstringRequired

networkIdstringRequired

symbolstringOptional

400

Default Response

application/json

404

Default Response

application/json

get/v3/benchmarks/vault-apy

HTTPcURLJavaScriptPython

GET /v3/benchmarks/vault-apy?networkId=eip155%3A1 HTTP/1.1
Host: api.creditcoop.xyz
x-api-key: YOUR_API_KEY
Accept: */*

{
  "address": "text",
  "networkId": "text",
  "symbol": "text",
  "data": [
    {
      "date": "2025-06-15",
      "apyPct7D": null
    }
  ]
}

Get historical benchmark rate

get

Returns a daily timeseries of a benchmark rate from the prices table. Use symbol FED_FUNDS_RATE for the Federal Funds Effective Rate.

Authorizations

ApiKeyAuthBearerAuthOAuth2

x-api-keystringOptional

API key in the format: cc_xxx_yyy (for customer API routes)

Query parameters

symbolstringOptional

Rate symbol (e.g., FED_FUNDS_RATE). Defaults to FED_FUNDS_RATE.

Default: FED_FUNDS_RATE

fromstring · dateOptional

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

Example: 2025-01-01

tostring · dateOptional

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

Example: 2025-12-31

Responses

200

Default Response

application/json

symbolstringRequired

400

Default Response

application/json

get/v3/benchmarks/rate

HTTPcURLJavaScriptPython

GET /v3/benchmarks/rate HTTP/1.1
Host: api.creditcoop.xyz
x-api-key: YOUR_API_KEY
Accept: */*

{
  "symbol": "text",
  "data": [
    {
      "date": "2025-06-15",
      "rate": 1
    }
  ]
}