| 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
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 |