Skip to main content
Once your wallet is funded, use these endpoints to track balances, positions, and yield.

​
Fetch a wallet

curl -X GET "$BASE_URL/v2/portfolio-wallets/$WALLET_ID" \
  -H "Authorization: Bearer $BRAID_API_TOKEN"
Key fields in the response:
FieldDescription
globalWalletBalanceTotal wallet value (principal + yield) across all positions
blendedRateBpsWeighted average APR derived from strategy positions
actualPositions[]Per-position balances, USD values, and drift vs target weights
liquidityProfile[]How fast each portion of the wallet can be withdrawn
Balances are computed from refreshed onchain holdings + price feeds and cached for fast reads. They may briefly lag deposits or withdrawals.

​
Customer-facing valuation notes

  • syrupUsdc is valued from an onchain ERC-4626 conversion read at request time (typically block-level fresh).
  • rlp is valued from Resolv’s oracle feed and can be up to ~24 hours stale per Resolv’s documented cadence.
  • Treat both as NAV-based valuations, not guaranteed 1:1 USDC marks at every instant.
For destination-specific withdrawability (including in-flight reservations) and a sourcing plan, use POST /v2/portfolio-wallets/:id/withdrawal-preview (see Withdraw Funds).

​
Yield metrics

Dedicated yield metrics endpoints are not yet available. Today you can monitor:
  • blendedRateBps — from strategy config + yield source catalog rates
  • globalWalletBalance and actualPositions — computed and cached; may briefly lag recent activity
  • Per-position valueUsd and balanceUnits in actualPositions[]

​
List wallets

curl -X GET "$BASE_URL/v2/portfolio-wallets?limit=25" \
  -H "Authorization: Bearer $BRAID_API_TOKEN"
Supports cursor-based pagination. See API Conventions for details.

​
Look up a wallet

Look up a wallet by requestId or label: 
curl -X GET "$BASE_URL/v2/portfolio-wallets/lookup?requestId=$REQUEST_ID" \
  -H "Authorization: Bearer $BRAID_API_TOKEN"

curl -X GET "$BASE_URL/v2/portfolio-wallets/lookup?label=My%20Portfolio" \
  -H "Authorization: Bearer $BRAID_API_TOKEN"

​
Balance and position webhooks

Subscribe to these events for real-time balance updates:
  • portfolio_wallet.balance.updated — fires when wallet balance changes
  • portfolio_wallet.position.updated — fires when a position’s value or weight changes
See Webhooks for registration and payload details.