Documentation
What do you want to do?
Start here
1
Quick start
What to do and in what order
2
Create your account
Email, Google or wallet
3
Connect an exchange
Quick Connect or your own keys
4
Your first bot
Small size and low leverage
Troubleshooting
Use this section to identify a problem from what you see. Each exchange guide above also has its own table of exact messages. If nothing here solves it, write in the Telegram support group with the exchange, the connection or bot name, the exact message and a screenshot with keys hidden.
Diagnosis order
1
Account
Can you sign in? Is 2FA working? See Create an account and Security.
2
Connection verified
Account → Exchanges: is the connection listed and Active? If saving failed, the message says which field is wrong.
3
Trading activation
Manage: Builder/Integrator Fee approved (Trading active, Integrator approved or Ready for trading)? Bitunix: activated by support?
4
Balance and market settings
Is there balance on the exchange? Are leverage, margin mode and position mode valid for that market?
5
Bot configuration
Is every order above the market minimum? Is the price inside the bot range? Is a Trigger Condition still waiting?
6
Compare with the exchange
Do the orders and position in the bot page match what the exchange shows?
Connections
| Symptom | Likely cause | Fix |
|---|---|---|
| Save & verify fails | Value in the wrong field, extra spaces, key from another account or network, or expired key. | Read the message, check each field against the exchange guide and paste again. Never paste a wallet private key or seed phrase. |
| Connection saved but Inactive | Trading activation not completed, or (Bitunix) pending manual activation. | Open Manage and complete activation, or contact support for Bitunix. |
| Wallet signature rejected or “does not match” | A different wallet account is selected, or the request expired. | Select the exact wallet saved in the connection and try again. |
| Balance 0 or missing | No deposit, wrong main address, or temporary read failure (Partial balance). | Deposit on the exchange, correct the address, or refresh later. |
| Everything worked and suddenly stopped | API wallet/key expired or revoked, or approval needs an update. | Pause bots, create new credentials, edit the connection and reactivate if Manage asks for it. |
| Lighter: tier or integrator errors | Wallet-less (email/social) account, or Standard tier on a bot that pays a fee. | Use a wallet-created account; for bots with a fee, change to Plus or Premium. See Connect Lighter. |
Bots
| Symptom | Likely cause | Fix |
|---|---|---|
| Cannot choose the connection (“Key not available for this Bot”, “inactive”) | Connection inactive, activation missing, or exchange not supported by that bot. | Finish activation in Manage or choose a supported exchange. |
| Warning below minimum in the preview | Per-order value below the exchange minimum. | Increase investment or leverage, or reduce levels. |
| Bot created but no orders | Not activated, Trigger Condition waiting, TDCA filters (only below average) not met, or the next cycle has not run yet. | Check status and trigger on the bot page and wait a short moment. If it stays empty, check the connection. |
| Grid has orders but no fills | Price is outside the range or has not reached the levels. | Wait, or edit/stop the bot to adapt the range. |
| Red trades on the exchange with a working grid | The exchange measures each close against the average of the whole position. | Normal; see the GridBot Classic section. Judge by total PnL. |
| Leverage or margin rejected | Leverage above the market maximum, Aster Multi-Asset requires Cross, or open positions block the change. | Use a valid leverage, Cross on Aster Multi-Asset, or close/cancel before changing mode. |
| Lighter: “No local leverage/mode is saved for this market…” | Leverage/mode not synced yet for that market. | Change leverage or mode in the form or set it in Manage → Leverage settings. |
| Bot position does not match the exchange | Manual intervention, partial fill or a delayed update. | Market Maker: use Repair. Others: pause, compare with the exchange and ask support if it persists. |
| Bot stuck in Closing / Stopping | A cancel or close is waiting for the exchange. | Wait and check the exchange. If it stays stuck, use Force delete only after cleaning the exchange manually, or ask support. |
| Insufficient margin / order rejected | Not enough available balance for the planned orders, or another bot uses the same margin. | Reduce size or leverage, add funds, or pause other bots on the account. |
Account and notifications
| Symptom | Fix |
|---|---|
| Lost 2FA device | Sign in with a recovery code, then set up 2FA again. Without codes, contact support from the account email. |
| Not receiving Telegram alerts | Check that Telegram is linked, notifications are On and Order notifications in Preferences include what you expect. |
| Trading Agent says “Connect your exchange” | Complete a connection with trading activation; the support chat works meanwhile. |
| Values hidden with asterisks | Protect Data or the eye icon is enabled. |