🔧Troubleshooting
Common issues and solutions when using XOXNO platform features.
Lending & Borrowing
Transaction Failed: "Insufficient balance"
Problem: Transaction fails when trying to supply or borrow.
Solutions:
Ensure you have enough EGLD for gas fees (~0.01 EGLD minimum)
Check you're not trying to supply more than you have
For withdrawals, verify you're not withdrawing collateral used for loans
Health Factor Declining
Problem: Your health factor is dropping toward 1.0.
Immediate actions:
Add collateral - Supply more assets to increase health factor
Repay debt - Reduce borrowed amount
Close position - Fully repay and withdraw if necessary
Prevention:
Keep health factor above 2.0 for safety
Set up price alerts for your borrowed assets
Monitor positions daily when using leverage
Cannot Withdraw Supplied Assets
Problem: Withdraw button disabled or transaction fails.
Causes:
Assets are being used as collateral for a loan
Insufficient liquidity in the pool (rare)
You're trying to withdraw more than supplied
Solutions:
Repay loans first, then withdraw
Withdraw only unused portion (not backing loans)
If liquidity issue, wait for pool to rebalance (usually minutes)
Liquidation Occurred
Problem: You were liquidated and lost some collateral.
What happened:
Health factor dropped below 1.0
Liquidators repaid part of your debt
Liquidation penalty (~5-10%) was charged
Remaining collateral is still yours
Next steps:
Withdraw remaining collateral
Review what caused liquidation (price movement, rate changes)
Use higher health factor buffers (>2.0) in future
Consider less leverage
Borrow APY Increased Unexpectedly
Problem: Your borrow rate went up suddenly.
Why this happens:
Borrow rates are dynamic based on utilization
High demand for asset increases rates
Normal market behavior
What to do:
Monitor if rates stay elevated
Consider repaying if rates too high
Switch to different borrowed asset if needed
Check if E-Mode offers better rates
NFT Marketplace
NFT Not Showing After Purchase
Problem: Bought NFT but don't see it in wallet.
Solutions:
Wait 6 seconds for block confirmation
Refresh wallet/page
Check transaction on MultiversX Explorer
Verify correct wallet address
Cannot List NFT for Sale
Problem: NFT doesn't appear in your sellable items.
Causes:
NFT is staked elsewhere
NFT is listed on another marketplace
Collection not verified on XOXNO
Solutions:
Unstake NFT from other protocols
Delist from other marketplaces first
Contact support if collection should be listed
Offer Rejected Automatically
Problem: Your offer was auto-rejected.
Reasons:
Offer below minimum threshold (usually 50% of floor)
Insufficient funds in wallet when offer accepted
Owner set minimum offer price
Solutions:
Make competitive offers (80%+ of floor price)
Keep EGLD in wallet for full offer duration
Check collection floor price before offering
Leverage & Multiply
Position Underwater
Problem: Leverage position is losing money.
Understanding:
Leverage amplifies losses, not just gains
Market moved against your position (long and price fell, or short and price rose)
Options:
Hold if you believe in recovery - But watch health factor!
Add collateral - Prevents liquidation while waiting
Close position - Accept loss and move on
Partial close - Reduce leverage, keep smaller position
Can't Close Leverage Position
Problem: Unable to exit leveraged trade.
Common causes:
Insufficient liquidity for swap
Health factor too low (near liquidation)
Transaction timing issues
Solutions:
Try closing 50% at a time (smaller trades)
Increase slippage tolerance slightly
Wait for better liquidity (minutes to hours)
Add collateral first to improve health factor
Multiply Strategy Not Profitable
Problem: Expected returns aren't materializing.
Check these factors:
Interest rates changed - Borrow APR may have increased
Yield sources decreased - LP fees or staking APY dropped
Position too small - Gas fees eating into returns
Timing - Some strategies need weeks to show profit
Solutions:
Recalculate with current rates
Exit if no longer profitable
Increase position size (if strategy still viable)
Switch to different strategy
API Integration Issues
Quote Request Fails: "Unknown token"
Problem: Aggregator returns unknown token error.
Solutions:
Verify token identifier format:
TOKEN-hexcode(e.g.,WEGLD-bd4d79)Check token exists on MultiversX
Use pair-config endpoint to verify support:
WebSocket Connection Drops
Problem: WebSocket disconnects frequently.
Causes:
Network issues
Exceeded message rate limit (100/second)
Exceeded topic limit (100 topics)
Connection timeout (no ping/pong)
Solutions:
Implement reconnection logic with exponential backoff
Reduce message frequency
Unsubscribe from unused topics
Respond to ping frames
Transaction Broadcasting Failed
Problem: Relayer rejects transaction.
Common errors:
invalid signature
Wrong signature format or signed different data
Re-sign transaction correctly
nonce too low
Already used this nonce
Get fresh nonce from account
wrong relayer
Used relayer from different shard
Calculate sender shard, use correct relayer
insufficient balance
Not enough funds for value + gas
Reduce value or add funds
Rate Limit Exceeded
Problem: API returns 429 or WebSocket closes.
Limits:
Aggregator API: 100 requests/second
WebSocket: 100 messages/second
Topics: 100 per connection
Solutions:
Implement request queuing
Cache quote responses (1-5 seconds)
Use multiple connections for different topics
Reduce polling frequency
Transaction Errors
Transaction Pending Forever
Problem: Transaction stuck in pending state.
Causes:
Very low gas price (transaction not competitive)
Network congestion
Transaction already processed (check explorer)
Solutions:
Check status on MultiversX Explorer
If truly pending > 5 minutes, likely an issue
Try new transaction with higher gas price
Check nonce hasn't advanced (might be already processed)
"Smart Contract Error" on Execute
Problem: Transaction fails with SC error.
Common causes:
Swap
Slippage exceeded
Increase slippage tolerance
Borrow
Collateral insufficient
Supply more collateral
Withdraw
Used as collateral
Repay loans first
Leverage
Health factor too low
Add collateral or reduce debt
General solution:
Read error message carefully
Check all requirements met
Try smaller amount
Contact support with transaction hash if unclear
Out of Gas
Problem: Transaction failed due to insufficient gas.
Solutions:
Increase gas limit:
Simple transfers: 50,000-100,000
Smart contract calls: 10,000,000-50,000,000
Complex operations: 50,000,000-100,000,000
Check aggregator's
estimatedBuiltinCallsfor gas estimationAdd 20% buffer to estimated gas
Getting Help
Before Contacting Support
Gather this information:
Support Channels
Community Support (Fast):
Discord: discord.gg/xoxno
Telegram: General questions and community help
Technical Support:
Email: [email protected]
Include transaction hash and detailed description
Developer Support:
GitHub Issues: API and integration questions
Discord #dev channel: Technical discussions
Response Times
Discord
Minutes to hours
Telegram
Hours
24-48 hours
GitHub
1-3 days
Status & Monitoring
Check Platform Status
API Status: https://status.xoxno.com (if available)
Network Status: https://explorer.multiversx.com
Gas Prices: Use WebSocket gasStats subscription
Monitor Your Positions
Daily checks:
Health factor
Accrued interest
Rate changes
Weekly checks:
Overall profitability
Alternative strategies
Risk exposure
Set alerts for:
Health factor < 1.5
Unusual rate changes
Large price movements
Last updated
Was this helpful?