Managing Strategies: Top-Up, Partial Withdrawal, and Close

Updated May 22, 2026 · 2 min read

Add or pull funds from a strategy, read PnL correctly, and know when to close positions versus permanently shut down a strategy wallet.

This article covers strategy-level fund operations. For position-level operations within a strategy, see article 13.

Before creating a new strategy, check if you actually need one. You can open more positions in an existing strategy via create_position - a single strategy wallet holds multiple positions in cross-margin (article 14). A new strategy is only required when:

  • You want an isolated sub-wallet for a separate thesis, or
  • You want opposing directions on the same asset (e.g. BTC LONG and BTC SHORT in parallel) - not allowed within one strategy.

If your perp balance shows funds you cannot use for a new strategy: those funds may be locked in existing strategy sub-wallets, not your Main Wallet. New strategies fund from your Main Wallet (Senpi auto-bridges USDC from your supported EVM chains as needed), not from existing sub-wallets. Free up funds via the operations below.

strategy_top_up

Adds capital to an existing strategy.

gotcha
Always use this - never send USDC directly to a strategy sub-wallet address, as that permanently breaks PnL tracking (article 3).
strategy_withdraw_funds

Pulls a partial (or full) USDC amount from a strategy's sub-wallet back to your Main Wallet while the strategy stays ACTIVE.

behavior
Synchronous, no polling needed. Only works on ACTIVE strategies. If a withdrawal brings the strategy's account value to zero, the strategy auto-closes.

Ledger quirk: the totalFunded field is append-only and never decrements on withdrawal, so netFunded (totalFunded minus totalWithdrawn) can go negative when cumulative withdrawals exceed the original deposits. This is normal and expected when you have withdrawn profits.

strategy_close vs strategy_close_positions

Option A

strategy_close - Permanent shutdown

  • Returns all funds to Main Wallet
  • ✗ Irreversible - strategy is gone

Option B

strategy_close_positions - Keep strategy active

  • Closes trading positions only
  • Strategy stays active for new positions
  • ✗ Empty coins array closes ALL positions

If a strategy creation failed (status FAILED), funds are automatically returned to your Main Wallet. As long as your funds are in a Senpi wallet (embedded or strategy sub-wallet), they are always recoverable. Contact support if funds do not appear after a failed operation (article 6).

Manage your strategies

Top up, withdraw, or close a strategy from the Senpi app or web.

Sign in to Senpi
Share

Related articles