Skip to main content
After creating a wallet, you can update its allocation strategy at any time.

​
Update the strategy

curl -X PATCH "$BASE_URL/v2/portfolio-wallets/$WALLET_ID/strategy" \
  -H "Authorization: Bearer $BRAID_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "requestId": "6d74dc1c-f1b5-4f2c-8f33-9f7b9e27cd4b",
    "positions": [
      { "positionKey": "usdz", "targetWeightBps": 5000, "maxProcessingTime": "PT0H" },
      { "positionKey": "rlp", "targetWeightBps": 5000, "maxProcessingTime": "PT24H" }
    ]
  }'
FieldRequiredDescription
requestIdYesUUID v4 idempotency key
positionsYesNew allocation. Weights must sum to 10,000 bps.

​
What happens during a strategy update

Strategy updates are asynchronous. When you update the strategy:
  1. The new target weights are saved immediately and reflected in the wallet response.
  2. The system plans a rebalance to move holdings toward the new targets (sells, buys, and bridges as needed).
  3. The rebalance executes over time. For positions with longer unwind windows (e.g. rlp at PT24H), the full rebalance can take hours.
During the rebalance, actualPositions in the wallet response will gradually converge toward the new targetPositions. You can monitor drift via driftBps on each position.

​
Strategy webhook

Strategy updates emit portfolio_wallet.strategy.status_changed events as the update is applied. See Webhooks for registration and payload details.