Withdrawal minimums
OrcaRail supports auto-withdrawal: periodically moving funds from deposit wallets to your configured withdrawal addresses. To avoid withdrawing dust or paying gas for negligible amounts, a minimum balance threshold is enforced.
Auto-withdrawal minimum
| Variable | Default | Description |
|---|---|---|
WITHDRAWAL_MIN_AUTO_AMOUNT | 0.0001 | Minimum balance (in USD) required for auto-withdrawal to run. |
When the user’s effective balance (after any holds or prior withdrawals) is below this threshold, auto-withdrawal is skipped for that user/address. No withdrawal is attempted, and no gas or fees are spent for that run.
This applies per user/address group: each address (or grouped balance) is compared against WITHDRAWAL_MIN_AUTO_AMOUNT. The value is in USD so that the same threshold applies regardless of which token or chain the balance is in (after conversion for comparison).
Configuration
- Server-side: Set the environment variable
WITHDRAWAL_MIN_AUTO_AMOUNTto a decimal string (e.g.0.001for one-tenth of a USD). The API default is0.0001when the variable is not set. - Behavior: Implemented in the withdrawals service; when the balance is below the minimum, the job logs that auto-withdraw was skipped and does not create a withdrawal for that balance.
See also
- Fees — Support and commission (which are included in payments and later withdrawn to the API key owner).
- Payment minimums — Per-network minimum transfer amounts for payments (separate from withdrawal minimum).
- Withdrawals API Reference — Withdrawal settings and endpoints.