mcpField
B
Bankr Agent - Error Handling

Bankr Agent - Error Handling

github.com/bankrbotDevelopment88358 installsUpdated 31w ago
Repository

About Bankr Agent - Error Handling

A troubleshooting skill for Bankr API authentication and job failures. It provides error-specific checks and resolution steps, including when to fix credentials instead of retrying.

Key features

  1. 01401 authentication troubleshooting
  2. 02Common job failure resolutions
  3. 03HTTP status code guidance
  4. 04Connectivity and balance checks
  5. 05User-facing error reporting steps

Use cases

  1. 01Resolve an invalid API key
  2. 02Diagnose failed trading jobs
  3. 03Respond to rate limits or server errors
  4. 04Explain fixes to users

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/bankrbot/claude-plugins --skill bankr-agent---error-handling

After installing, type/bankr-agent---error-handlingin Claude Code to confirm it loaded.

Details

From the project 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

ErrorCauseResolution
Insufficient balanceNot enough tokensCheck balance, reduce amount
Token not foundInvalid symbol/addressVerify token exists on chain
Slippage exceededPrice moved too muchRetry or try smaller amount
Transaction revertedOn-chain failureCheck transaction details
Rate limit exceededToo many requestsWait and retry

HTTP Status Codes

CodeMeaningAction
400Bad requestCheck prompt format
401UnauthorizedFix API key (see above)
402Payment requiredEnsure wallet has BNKR on Base
429Rate limitedWait and retry
500Server errorRetry after delay

Troubleshooting Checklist

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

Reporting Errors to Users

  1. State what went wrong simply
  2. Provide specific fix steps
  3. Avoid technical jargon
  4. 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

Comments

Markdown supported