Help us improve
Share bugs, ideas, or general feedback.
From bankr-agent
Resolves Bankr API errors including 401 authentication, invalid API keys, job failures, and rate limits with setup instructions, troubleshooting checklists, and resolution tables.
npx claudepluginhub bankrbot/claude-plugins --plugin bankr-agentHow this skill is triggered — by the user, by Claude, or both
Slash command
/bankr-agent:bankr-error-handlingThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Resolve Bankr API errors and authentication issues.
Documents Bankr Agent API endpoints, async submit-poll-complete job pattern, TypeScript examples, and response schemas for crypto trading and market analysis.
Guides Bankr API and CLI security: read-only keys, IP whitelisting, rate limits, dedicated agent wallets, key rotation, and transaction safety.
Configures Bankr x402 SDK client with payment and receiving wallets, private keys, environment variables, and two-wallet setup for micropayments and token handling.
Share bugs, ideas, or general feedback.
Resolve Bankr API errors and authentication issues.
Present these setup instructions to the user:
Step 1: Create an API Key
Visit https://bankr.bot/api to create a new API key
Step 2: Set Environment Variable
# Add to shell profile (~/.zshrc or ~/.bashrc)
export BANKR_API_KEY=bk_your_api_key_here
Step 3: Restart Claude Code
Close and reopen the terminal/Claude Code session
Important: Do NOT retry when authentication fails. User must fix API key first.
| Error | Cause | Resolution |
|---|---|---|
| Insufficient balance | Not enough tokens | Check balance, reduce amount |
| Token not found | Invalid symbol/address | Verify token exists on chain |
| Slippage exceeded | Price moved too much | Retry or try smaller amount |
| Transaction reverted | On-chain failure | Check transaction details |
| Rate limit exceeded | Too many requests | Wait and retry |
| Code | Meaning | Action |
|---|---|---|
| 400 | Bad request | Check prompt format |
| 401 | Unauthorized | Fix API key (see above) |
| 402 | Payment required | Ensure wallet has BNKR on Base |
| 429 | Rate limited | Wait and retry |
| 500 | Server error | Retry after delay |
bk_, Claude Code restarted after settingExample:
Your Bankr API key is not configured. To set it up:
1. Visit https://bankr.bot/api to create an API key
2. Set BANKR_API_KEY in your environment
3. Restart Claude Code