| Endpoint | Monitoring use case |
|---|---|
GET /v2/portfolio-wallets | Periodically sync your list of wallets (and their latest state). |
GET /v2/portfolio-wallets/{id} | Refresh a single wallet’s latest status, balances, and positions. |
POST /v2/portfolio-wallets/yield | Compute yield metrics for one or more wallets over a time window. |
POST /webhooks/registrations | Subscribe to wallet lifecycle and monitoring events (balance, deposits, withdrawals, strategy updates). |
Polling for strategy update events isn’t supported yet, but it’s coming soon. For now, please use the portfolio_wallet.strategy.status_changed webhook to monitor strategy update progress.
Polling (scheduled monitoring)
For code examples and recommended polling patterns, see Polling.Webhooks (real-time monitoring)
Use webhooks to react to balance changes, deposit status updates, withdrawals (including per-leg payouts), position updates, and strategy status updates.- Example JSON bodies for each event type: Webhook payload examples
- How to verify authenticity of incoming webhook requests: Webhook signature verification

