Skill

Bankr Agent - Error Handling

Resolves Bankr API errors including 401 authentication, invalid API keys, job failures, and rate limits with setup instructions, troubleshooting checklists, and resolution tables.

authentication

Install

npx claudepluginhub bankrbot/claude-plugins --plugin bankr-agent

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Resolve Bankr API errors and authentication issues.

SKILL.md

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

139.2k

mcp-builder

9 files

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

anthropics-skills-13

124.2k

canvas-design

20 files

Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.

anthropics-skills-13

124.2k

Stats

Parent Repo Stars70

Parent Repo Forks20

Last CommitJan 23, 2026

Actions

View Source View Plugin View on GitHub View README

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

HTTP Status Codes

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

Troubleshooting Checklist

API Key: Set, starts with bk_, Claude Code restarted after setting
Network: Internet working, api.bankr.bot reachable
For Trading: Wallet has sufficient balance, token exists on chain

Reporting Errors to Users

State what went wrong simply
Provide specific fix steps
Avoid technical jargon
Suggest alternatives

Example:

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