Credits

Why use Credits?

Our subscriptions are based around "Credits" (or "Compute Units"), which provide a measure for the resources required to fulfill each request.

To demonstrate through an example, /v2/detailed-vaults/{network}/{vaultAddress}/apy has a lower credit cost because it returns only the current APY on a single vault, while /v2/detailed-vaults returns detailed TVL + APY datapoints across many vaults.

General

Endpoint	Base CU per call	CU per datapoint returned
/v2/assets	1	--
/v2/networks	1	--
/v2/tags	1	--
/v2/vaults	1	--
/v2/curators	1	--

Detailed Vaults

Endpoint	Base CU per call	CU per datapoint returned
/v2/detailed-vaults	1	3
/v2/detailed-vaults/{network}/{vaultAddress}	3	--
/v2/detailed-vaults/{network}/{vaultAddress}/apy	1	--
/v2/detailed-vaults/{network}/{vaultAddress}/tvl	1	--

Benchmarks

Endpoint	Base CU per call	CU per datapoint returned
/v2/benchmarks/{network}	3	--
/v2/historical-benchmarks/{network}	3	3

Historical

Endpoint	Base CU per call	CU per datapoint returned
/v2/historical/{network}/{vaultAddress}	3	3
/v2/historical/{network}/{vaultAddress}/apy	1	1
/v2/historical/{network}/{vaultAddress}/tvl	1	1
/v2/historical/{network}/{vaultAddress}/sharePrice	1	1

Portfolio

Endpoint	Base CU per call	CU per datapoint returned
/v2/portfolio/best-deposit-options/{userAddress}	1	2
/v2/portfolio/best-vault/{userAddress}	2	--
/v2/portfolio/events/{userAddress}/{network}/{vaultAddress}	3	--
/v2/portfolio/idle-assets/{userAddress}	5	--
/v2/portfolio/positions/{userAddress}	5	--
/v2/portfolio/positions/{userAddress}/{network}/{vaultAddress}	1	--
/v2/portfolio/returns/{userAddress}/{network}/{vaultAddress}	2	--
/v2/portfolio/total-returns/{userAddress}/{network}/{vaultAddress}	1	--

Transactions

Endpoint	Base CU per call	CU per datapoint returned
/v2/transactions/context/{userAddress}/{network}/{vaultAddress}	3	--
/v2/transactions/{action}/{userAddress}/{network}/{vaultAddress}	5	--
/v2/transactions/rewards/context/{userAddress}	3	--
/v2/transactions/rewards/claim/{userAddress}	5	--

Legacy (v1) API creidts

Looking for details on v1 endpoints? See here.

Note: Our v1 (legacy) API endpoints remain fully supported and maintained. You can access the full v1 documentation here.