bankr-agent-error-handling

name	Bankr Agent - Error Handling
description	This skill should be used when encountering authentication errors, API key errors, 401 errors, "invalid API key", "BANKR_API_KEY not set", job failures, or any Bankr API errors. Provides setup instructions and troubleshooting guidance for resolving Bankr configuration issues.
version	1.0.0

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