Troubleshooting

This guide helps you resolve common issues with CubeTerminal.

Connection Issues

Exchange Connection Failed

Symptoms:

• "API Offline" status
• Cannot place orders
• No position/balance data

Solutions:

1. Verify API Credentials

   • Check API key is correct
   • Verify API secret is correct
   • Ensure passphrase is correct (if required)

2. Check API Permissions

   • Enable trading permissions
   • Enable futures trading (if using futures)
   • Check IP whitelist includes your IP

3. Network Issues

   • Check internet connection
   • Try disabling VPN
   • Check if exchange is accessible

4. Exchange Status

   • Check exchange status page
   • May be under maintenance
   • API may be rate limited

News Sources Not Connecting

Symptoms:

• Red dot on RSS status
• No news appearing
• "Disconnected" status

Solutions:

1. Verify API Keys

   • Check each source's API key
   • Ensure subscription is active
   • Try regenerating API key

2. Check Source Status

   • Provider may be down
   • Check provider's status page
   • Try reconnecting

3. WebSocket Issues

   • Firewall may block WebSocket
   • Try different network
   • Check browser console for errors

Widget Issues

Widget Not Loading

Symptoms:

• Widget shows loading spinner
• Widget displays error
• Widget is blank

Solutions:

1. Refresh the Page

   • Simple refresh often fixes issues
   • Hard refresh: Ctrl+Shift+R

2. Check Connection

   • Verify exchange is connected
   • Check symbol is valid
   • Ensure data is available

3. Reset Widget

   • Remove and re-add the widget
   • Check widget settings

Chart Not Displaying

Symptoms:

• Blank chart area
• "No data" message
• Chart frozen

Solutions:

1. Check Symbol

   • Verify symbol exists
   • Try a major pair (BTC-USDT)

2. Chart Data Issues

   • Candles may still be loading — try a different timeframe
   • For on-chain (contract-address) charts, verify the pair has liquidity
   • Refresh the page

3. Browser Compatibility

   • Use Chrome, Firefox, or Edge
   • Update browser to latest version
   • Disable conflicting extensions

Order Book Empty

Symptoms:

• "No orderbook data"
• Blank order book
• Stale data

Solutions:

1. Check Connection

   • Verify WebSocket is connected
   • Check exchange status

2. Symbol Issues

   • Verify symbol is trading
   • Check market hours
   • Try different symbol

Trading Issues

Order Rejected

Symptoms:

• Order fails to place
• Error message displayed
• Button stays disabled

Common Causes & Solutions:

Position Not Showing

Symptoms:

• Order filled but no position
• Position disappeared
• Wrong position data

Solutions:

1. Refresh Data

   • Wait a few seconds
   • Refresh the page
   • Check exchange directly

2. Check Filters

   • Position may be for different symbol
   • Check all positions view

3. Sync Issues

   • Disconnect and reconnect
   • Clear local storage and reload

Performance Issues

Slow Performance

Symptoms:

• Laggy interface
• Delayed updates
• High CPU usage

Solutions:

1. Reduce Widgets

   • Close unused widgets
   • Simplify layout

2. Browser Issues

   • Close other tabs
   • Clear browser cache
   • Disable extensions

3. Network

   • Check internet speed
   • Use wired connection
   • Reduce other network usage

High Memory Usage

Solutions:

1. Refresh Periodically

   • Long sessions accumulate memory
   • Refresh every few hours

2. Reduce Data

   • Limit news feed history
   • Close unused widgets

Data Issues

Stale Prices

Symptoms:

• Prices not updating
• Old timestamps
• Frozen data

Solutions:

1. Check Connection

   • Verify WebSocket connected
   • Check exchange status

2. Refresh

   • Refresh the page
   • Reconnect exchange

Missing Historical Data

Solutions:

1. Check Timeframe

   • Some timeframes have limited history
   • Try different timeframe

2. Symbol Issues

   • New symbols have less history
   • Check symbol listing date

Reset & Recovery

Reset Layout

If layout is broken:

1. Open Settings → General
2. Click Reset Layout
3. Confirm reset
4. Layout returns to default

Clear All Data

For a fresh start:

1. Open browser developer tools (F12)
2. Go to Application → Storage
3. Click "Clear site data"
4. Refresh the page
5. Reconfigure settings

Getting Help

If issues persist:

1. Check Documentation

   • Review relevant guides
   • Search for your issue

2. Browser Console

   • Press F12 to open developer tools
   • Check Console tab for errors
   • Note any error messages

3. Contact Support

   • Describe the issue clearly
   • Include error messages
   • Note steps to reproduce