AgentSkillsCN

Bankr Agent - Error Handling

当遇到身份验证错误、API 密钥错误、401 错误、“无效的 API 密钥”、“BANKR_API_KEY 未设置”、作业失败，或任何 Bankr API 错误时，应使用此技能。提供设置说明与故障排除指南，帮助解决 Bankr 配置问题。

SKILL.md
--- frontmatter
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

code
Visit https://bankr.bot/api to create a new API key

Step 2: Set Environment Variable

bash
# Add to shell profile (~/.zshrc or ~/.bashrc)
export BANKR_API_KEY=bk_your_api_key_here

Step 3: Restart Claude Code

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:

code
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