Bankr Agent Error Handling

When your Bankr API calls start throwing 401s or authentication errors, this skill steps in to help Claude diagnose and resolve them. It guides users through creating API keys at bankr.bot/api and handles the common auth pitfalls that come up when integrating with Bankr's API. The scope is narrow but useful if you're building something that relies on Bankr and want Claude to troubleshoot connection issues without you having to context switch to documentation. It's lightweight error recovery, not a full API wrapper, so expect it to shine most when things break rather than during initial setup.

GitHub stars: 80
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add bankrbot/claude-plugins --skill 'Bankr Agent - Error Handling' --agent claude-code

Installs into .claude/skills of the current project.

Files

Bankr Error Handling

Resolve Bankr API errors and authentication issues.

Authentication Errors (401)

Symptoms

HTTP 401 status code
"Invalid API key" or "Unauthorized" message

Resolution

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.

Common Job Failures

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