# List vaults

`GET /v1/lending/vaults`

Returns the lending vaults that Circuitry lists, with the rate, the deposits, and the liquidity of each vault. [Lending vaults](/lending) tells how Circuitry selects vaults.

## Request

```bash
curl "https://api.circuitry.company/v1/lending/vaults?chain=base&asset=USD" \
  -H "Authorization: Bearer $CIRCUITRY_API_KEY"
```

| Query parameter | Meaning |
| --- | --- |
| `chain` | Optional. `base` or `robinhood`, to list only the vaults on that chain |
| `asset` | Optional. A currency code, such as `USD`, or a crypto symbol, such as `ETH`, to list only the vaults for that asset |
| `provider` | Optional. `morpho` or `aave`, to list only the vaults of that protocol |

## Response

```json
{
  "object": "list",
  "data": [
    {
      "object": "vault",
      "chain": "base",
      "chainId": 8453,
      "address": "0x4e65fE4DbA92790696d040ac24Aa414708F5c0AB",
      "provider": "aave",
      "version": "v3",
      "name": "Aave USDC",
      "curator": null,
      "status": "active",
      "asset": {
        "type": "fx",
        "currency": "USD",
        "token": {
          "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
          "symbol": "USDC",
          "name": "USD Coin",
          "decimals": 6
        }
      },
      "share": {
        "address": "0x4e65fE4DbA92790696d040ac24Aa414708F5c0AB",
        "symbol": "aBasUSDC",
        "name": "Aave Base USDC",
        "decimals": 6
      },
      "apy": "0.047191",
      "totalDeposits": { "value": "193663968.463618", "raw": "193663968463618" },
      "liquidity": { "value": "17648565.594816", "raw": "17648565594816" },
      "depositLimit": { "value": "36331088.059123", "raw": "36331088059123" },
      "fees": null,
      "updatedAt": "2026-10-27T04:30:00.000Z"
    }
  ]
}
```

| Field | Meaning |
| --- | --- |
| `object` | Always `vault` |
| `chain` | The vault's chain: `base` or `robinhood` |
| `chainId` | The chain's ID: 8453 for Base, or 4663 for Robinhood Chain |
| `address` | The vault's address. It is also the address of the vault's share token. For an Aave reserve, it is the address of the aToken |
| `provider` | `morpho` or `aave` |
| `version` | `vault-v1` or `vault-v2` for a Morpho vault, and `v3` for an Aave reserve |
| `name` | The vault's name |
| `curator` | The company that chooses where a Morpho vault lends. It is `null` for an Aave reserve |
| `status` | `active`, `withdrawals_only`, or `paused`. See [Statuses](/lending#statuses) |
| `asset` | The asset that the vault lends, with the token that the vault holds. ETH vaults hold WETH |
| `share` | The token that shows a position in the vault |
| `apy` | The annual percentage yield as a decimal fraction. `"0.047191"` is 4.7191%. It subtracts all fees, and does not include rewards |
| `totalDeposits` | The amount that the vault holds for its depositors |
| `liquidity` | The amount that depositors can withdraw now. Borrowers use the remainder |
| `depositLimit` | The largest deposit that the vault takes now, because of its caps. It is `null` when no cap applies |
| `fees` | A Morpho curator's fees, as decimal fractions. `performance` is the part of the interest that the curator keeps. `management` is the part of the deposits that the curator takes each year. The APY already subtracts these fees. It is `null` for an Aave reserve |
| `updatedAt` | The time when Circuitry last read the vault from the chain. Circuitry reads each vault every minute |

Each amount gives `value` in the asset's unit and `raw` in the token's base units.

The list puts the vaults in order by chain, then by asset, then by deposits, with the largest first.

## Errors

This endpoint returns `invalid_request` for a query parameter or a value that it doesn't take, the errors in [Failed authentication](/authentication#failed-authentication), `rate_limited`, and `internal_error`.