Bonus transactions¶
Bonus is broker-provided funds stored separately from balance and credit. It is never directly withdrawable. Executed bonus transactions keep their signed amount in the trade profit field, and BalanceFix reconstructs the account bonus from completed bonus transactions.
Group policy¶
bonus_usage_policy is a bitmask from 0 to 7:
| Flag | Value | Behavior when enabled |
|---|---|---|
BONUS_USAGE_AS_TRADING_EQUITY |
1 |
Bonus participates in equity, free margin, Margin Call, and Stop Out. |
BONUS_USAGE_ALLOW_CONVERSION |
2 |
Conversion from bonus to balance is allowed. |
BONUS_USAGE_ALLOW_REVOKE_WITH_OPEN_POSITIONS |
4 |
Policy-safe revocation is allowed while positions are open. |
The default value is 7. Revocation and deletion still have to pass projected equity and margin checks.
Commands¶
- BonusIn — create or update a bonus grant.
- BonusOut — create or update a bonus revocation.
- ConvertBonusToBalance — atomically convert bonus to balance.
- DeleteBonus — reverse an ordinary bonus transaction.
| Command | Value | Signed amount |
|---|---|---|
OP_BONUS_IN |
14 |
Positive |
OP_BONUS_OUT |
15 |
Negative |