Troubleshooting

Connecting

Message	Cause	Fix
Your app asks you to sign in with OAuth	The app can't send a custom `Authorization` header.	Use a client from Connect your client.
`Missing connection token…` (HTTP 401)	The app isn't sending the `Authorization` header.	Add `Authorization: Bearer <connection token>` to the server's settings.
`Malformed connection token…` (401)	The header isn't `Bearer <API key>:<API secret>`.	The key is `wlt_bot_` plus 64 hex characters, then a colon, then the 64-character secret. Check for spaces, quotes or a missing `Bearer` .
`Wellat rejected the connection token: wrong key or secret, or the key was deleted.` (401)	The secret is wrong, or the key was revoked.	Create a new key in the app and build a new token.
`This strategy is operated by a bot. Agents can trade only strategies created for an AI agent.` (403)	The key's strategy was created for a bot.	Create a strategy operated by an AI agent, with its own key.
`This key has no strategy. In the Wellat app, create a strategy operated by an AI agent with this key.` (403)	The key isn't bound to a strategy.	Create the strategy and bind the key.
`This key is bound to a … strategy. Agents can trade spot and futures strategies only.` (403)	The strategy isn't Spot or Futures.	Use a Spot or Futures strategy.
`Too many failed connection attempts from this address; retry in N seconds.` (429)	20 failed connections in a minute from your IP address.	Fix the token, then wait.

Message	Cause	Fix
`Order not sent: …`	The order breaks the symbol's rules; nothing was sent.	Read `get_symbol_rules` and correct the values.
`<SYMBOL> isn't a symbol Wellat trades. list_symbols lists the ones it does.`	The symbol isn't one Wellat trades for this strategy.	Call `list_symbols` and use a listed symbol.
`Wellat rejected the request (code …): …`	Wellat refused the request. The text after the code says why, for example the strategy isn't LIVE.	Act on Wellat's message.
`Rate limited; retry in N seconds.`	The key's request weight or order budget is used up.	Wait, then slow down.
`Wellat is temporarily unavailable.`	Wellat couldn't be reached.	Retry shortly.
`get_strategy` shows an old status	The strategy is cached for up to 30 seconds.	Wait 30 seconds.