Troubleshooting
What went wrong, on which side and how to fix it.
Start with doctor
In the agent's folder:
npx binference doctorIt checks the app, the key and the cockpit, the AI budget, the hooks and whether the last session ran them, the skills, baw, the wallet's sign-in and Binance's MCP Server, and says what to fix. npx binference doctor --fix repairs what failed and keeps your own settings. If it says the hooks are from another version, update the folder:
npx binference@latest doctor --fixWhich side is it?
| You see | Side | Fix |
|---|---|---|
| The app can't start or says the key is wrong | bInference | Check ANTHROPIC_AUTH_TOKEN or BINF_API_KEY. See API keys |
402 insufficient_balance | bInference | The AI budget can't cover the call's reserve. Lower max_tokens or add credit |
402 key_limit | bInference | The key hit its spending limit. It resets at 00:00 UTC, or raise it |
429 or 529 | bInference | Too many calls at once, or a busy model. The app retries on its own |
403 agent_paused | bInference | You paused the agent. Resume it in its cockpit |
| A trade refused: "Your limits on binference.io…" | bInference | Your trade limits blocked it. Change them in the cockpit, or confirm the trade |
| The agent's sessions or spend don't show in the cockpit | bInference | Start the agent with ./start in its folder, not plain claude or codex |
429 or 418 from Binance, "too much request weight" or "IP banned" | Binance | The agent called Binance too often. Wait the time Binance names: calls during a ban make it longer |
| A trade fails for insufficient balance | Binance | The Agentic sub-account is empty. Transfer funds into it |
| Market data works, account or trading doesn't | Binance | Reconnect and grant the Account or Trade scope |
| The server is added but can't be used | Binance | Reconnect and authenticate again |
| The authorization expired | Binance | Disconnect and reconnect the Binance MCP Server |
Binance MCP Server
- The command isn't recognized. Make sure Claude Code or Codex is installed, open a new terminal and try again.
- You opened the address in a browser. Close it and run the command for your app instead.
- You pasted the address into the chat. Remove the connection the AI made, then follow the setup steps exactly.
- Check the address. It must be exactly
https://agent.binance.com/mcp/agentic.
bInference
- Nothing seems to reach bInference. Claude Code needs
ANTHROPIC_BASE_URL=https://binference.io/api, without/v1. Codex needsbase_url = "https://binference.io/api/v1", with it. - Your calls don't show up on the Calls page. Messages calls, which Claude Code makes, appear within a minute, once they're priced.
- Every error code is on Errors, with what to do.
Still stuck?
For the Binance side, use Binance Customer Support's Live Chat. For bInference, quote the x-binference-call-id from the failing call.