Skip to main content
GET
/
v2
/
earn
/
vaults
Python (SDK)
from compass_api_sdk import CompassAPI, models


with CompassAPI(
    api_key_auth="<YOUR_API_KEY_HERE>",
) as compass_api:

    res = compass_api.earn.earn_vaults(order_by="tvl_usd", direction=models.V2EarnVaultsDirection.DESC, offset=0, limit=50)

    # Handle response
    print(res)
{
  "total": 123,
  "offset": 123,
  "limit": 123,
  "vaults": [
    {
      "apy_30d": "5.12",
      "apy_7d": "5.25",
      "apy_90d": "4.98",
      "asset": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "asset_name": "USD Coin",
      "asset_symbol": "USDC",
      "chain": "ethereum",
      "name": "Steakhouse USDC",
      "owner": "0x1234567890123456789012345678901234567890",
      "symbol": "steakUSDC",
      "tvl_usd": "12500000.00",
      "vault_address": "0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"
    },
    {
      "apy_30d": "3.28",
      "apy_7d": "3.45",
      "apy_90d": "3.15",
      "asset": "0x4200000000000000000000000000000000000006",
      "asset_name": "Wrapped Ether",
      "asset_symbol": "WETH",
      "chain": "base",
      "name": "Morpho Blue WETH",
      "owner": "0x1234567890123456789012345678901234567890",
      "symbol": "mWETH",
      "tvl_usd": "8750000.00",
      "vault_address": "0x616a4E1db48e22028f6bbf20444Cd3b8e3273738"
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

Your Compass API Key. Get your key here.

Query Parameters

​
order_by
string
default:tvl_usd
required

The field to order the results by.

​
direction
enum<string>
default:desc

The direction to order the results by.

Available options:
asc,
desc
​
offset
integer
default:0

The offset of the first item to return.

​
limit
integer
default:50

The number of items to return.

Required range: x <= 1000
​
chain
enum<string> | null

Optional chain filter. If not provided, returns vaults for all chains. The chain to use.

Available options:
base,
ethereum,
arbitrum
​
asset_symbol
string | null

Filter vaults by underlying asset symbol (e.g., 'USDC', 'WETH').

​
min_tvl_usd

Minimum TVL in USD. Vaults with TVL below this value will be excluded.

Response

Successful Response

Response model for a paginated list of ERC-4626 vaults.

​
total
integer
required
​
offset
integer
required
​
limit
integer
required
​
vaults
VaultInfo · object[]
required

A list of vault information objects.

Example:
[
  {
    "apy_30d": "5.12",
    "apy_7d": "5.25",
    "apy_90d": "4.98",
    "asset": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "asset_name": "USD Coin",
    "asset_symbol": "USDC",
    "chain": "ethereum",
    "name": "Steakhouse USDC",
    "owner": "0x1234567890123456789012345678901234567890",
    "symbol": "steakUSDC",
    "tvl_usd": "12500000.00",
    "vault_address": "0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"
  },
  {
    "apy_30d": "3.28",
    "apy_7d": "3.45",
    "apy_90d": "3.15",
    "asset": "0x4200000000000000000000000000000000000006",
    "asset_name": "Wrapped Ether",
    "asset_symbol": "WETH",
    "chain": "base",
    "name": "Morpho Blue WETH",
    "owner": "0x1234567890123456789012345678901234567890",
    "symbol": "mWETH",
    "tvl_usd": "8750000.00",
    "vault_address": "0x616a4E1db48e22028f6bbf20444Cd3b8e3273738"
  }
]