Troubleshooting

Most Common Issue: Specify Your Chain

The number one mistake when using Bankr is not specifying the chain in your prompt. Bankr supports multiple chains, so you need to tell it where to execute.

Bad

Buy ETH

The agent doesn’t know which chain you mean. This will fail or produce unexpected results.

Good

Buy $20 of PEPE on Base

Always include “on Base”, “on Ethereum”, “on Solana”, etc. in your prompts.

Tip

Make it a habit to always end your prompts with “on Base” (or whichever chain you’re targeting). It prevents the most common class of errors.

Authentication Errors

“Invalid API key” Check that your key starts with bk_ and is copied correctly. API keys are case-sensitive. Make sure there are no trailing spaces or newline characters.

“Unauthorized” Make sure you are using the X-API-Key header — not Authorization, not Bearer, not a query parameter. The correct format is:

X-API-Key: bk_YOUR_KEY

“API key expired” Generate a new key at bankr.bot/api. Old keys cannot be reactivated.

General key hygiene: Store API keys in environment variables, never hardcode them in your source code. Never commit keys to version control.

Connectivity

Testing the API:

curl -I https://api.bankr.bot

You should get a 200 response. If you get a timeout or connection error, check your network connection and firewall settings.

Terminal not loading at bankr.bot/terminal:

• Try incognito/private browsing mode
• Clear your browser cache and cookies
• Use a stable internet connection (not public Wi-Fi)
• Try a different browser (Chrome, Firefox, Safari)
• Disable browser extensions that might interfere (ad blockers, privacy extensions)

SDK Issues

“Insufficient USDC” The SDK costs $0.10 USDC per request on Base. You need USDC in your wallet on the Base network. Check your balance and top up if needed. This is separate from your API key — the SDK uses on-chain payment.

“Cannot use in browser” The Bankr SDK is server-side only. It is designed for Node.js environments. You cannot import or use it in browser-side JavaScript, React components, or any client-side code. Run it in a Node.js backend, serverless function, or CLI script.

ERC20 swap failing If a token swap is failing, you may need to approve the AllowanceHolder contract first before executing the swap. This is a standard ERC20 approval step. Check the SDK documentation for the correct contract address and approval flow.

Solana not working via SDK Solana is NOT supported via the SDK. Solana interactions are only available through the Agent API (POST /agent/prompt) and OpenClaw skills. If you need Solana support programmatically, use the API directly.

Polymarket not working via SDK Polymarket is NOT supported via the SDK. Like Solana, Polymarket is only accessible through the Agent API and OpenClaw skills.

Token Launching

“Deployment limit reached” There is a 24-hour cooldown per account for token deployments. If you have hit the limit, wait 24 hours and try again. To get higher deployment limits, join the Bankr Club.

“No claimable fees” Fees only accumulate when people actually trade your token. If your token has no trading volume, there are no fees to claim. Promote your token, build a community, and fees will follow.

Finding your wallet address Your Clanker wallet (used for token launching) is the same as your Base trading wallet. Use GET /agent/user to see all your wallet addresses.

Airdrops

“Airdrop not available” Airdrops are a Bankr Club premium feature. You need an active Bankr Club membership to access and claim airdrops. Join the Club to unlock this feature.

General Tips

• Keep API keys private. Never commit config.json or .env files to version control. Add them to your .gitignore.
• Only trade amounts you can afford to lose. Bankr agents interact with real assets on real blockchains. There are no testnets or sandboxes.
• Use environment variables for all sensitive values — API keys, private keys, wallet addresses.
• Always specify the chain in every prompt. This is worth repeating because it is the single most common source of errors.

Frequently Asked Questions

Where is my wallet address? Use GET /agent/user to see all your wallet addresses. Your Base wallet and Clanker wallet share the same address.

How much does the SDK cost? $0.10 USDC per request on Base. No API key is needed for SDK usage — payment is handled on-chain.

Can I use Bankr on Solana with the SDK? No. Solana is only supported via the Agent API and OpenClaw skills. The SDK is limited to EVM chains (Base, Ethereum, etc.).

How do I get $BNKR? Trade on Uniswap V3, Aerodrome, or Uniswap V4 on the Base network. You can also tell your Bankr agent: “Buy BNKR on Base.”

What happens if my agent runs out of funds? Your agent cannot execute transactions without funds in its wallet. To keep your agent running autonomously, connect the LLM Gateway to auto-fund from trading fees. This creates a self-sustaining loop where your agent earns fees and uses them to fund its own compute.

Where can I get help? Join the Bankr Discord for community support, or open an issue on the relevant GitHub repository.