DeFi Positions

Browse available vaults and pools

List all active DeFi vaults/pools across providers:

GET /v1.2/safes/vaults
Header: X-Blockchain-Id: 8453

Filter by provider using the provider query parameter:

Each entry contains: provider, poolAddress, name, assetTicker, apy, tvl, isDefault, metadata (provider-specific), and linked tokens (supplyToken, borrowToken, poolToken).

View your positions

After depositing into any DeFi protocol, retrieve your positions:

GET /v1.2/users/me/pools
Header: X-Blockchain-Id: 8453

Optional query: includeZero=true to include providers with no active position.

Response structure:

{
  "timestamp": "2026-05-17T18:00:00.000Z",
  "blockchainId": "8453",
  "address": "0xSAFE…",
  "pools": [
    { "provider": "AAVE", "items": [ … ] },
    { "provider": "MORPHO", "items": [ … ] },
    { "provider": "HYPERLIQUID", "items": [ … ] }
  ]
}

All three providers are queried in parallel. Each provider uses a different data source:

Real-time catalog updates

Subscribe to WebSocket events to get notified when vault catalog changes (APY shifts, new vaults):

The pool_catalog_update event is broadcast to all authenticated WebSocket clients when significant changes are detected. Refresh your catalog via GET /v1.2/safes/vaults when received.

See the WebSocket documentation for connection details.