# Retrieve a vault

`GET /v1/lending/vaults/:chain/:address`

Returns one lending vault, with its rate, its deposits, and its liquidity. [Lending vaults](/lending) tells how Circuitry selects vaults.

## Request

```bash
curl https://api.circuitry.company/v1/lending/vaults/base/0x4e65fE4DbA92790696d040ac24Aa414708F5c0AB \
  -H "Authorization: Bearer $CIRCUITRY_API_KEY"
```

| Path parameter | Meaning |
| --- | --- |
| `chain` | The vault's chain: `base` or `robinhood` |
| `address` | The vault's address. For an Aave reserve, give the address of its aToken |

## Response

```json
{
  "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"
}
```

[List vaults](/reference/lending-vaults#response) tells what each field means.

## Errors

| Status | Code | Meaning |
| --- | --- | --- |
| 404 | `vault_not_found` | Circuitry lists no vault at this address on the chain |

This endpoint can also return `invalid_request` for a malformed chain or address, the errors in [Failed authentication](/authentication#failed-authentication), `rate_limited`, and `internal_error`.