Bankr 是一个通过自然语言执行加密货币交易和 DeFi 操作的 AI 智能体,同时提供 LLM 网关服务。它提供两种集成方式:Bankr CLI(推荐)和 REST API,两者共用同一 API 密钥和相同的异步任务工作流。
一、用途 Bankr 用于以自然语言完成加密资产交易、投资组合管理、市场研究、转账、NFT 操作、预测市场下注、杠杆交易和代币部署等操作。同时,其 LLM 网关可作为统一的多模型 API 入口。
二、获取 API 密钥 使用前需要 Bankr API 密钥,有两种方式:
- 无头邮件登录(推荐给智能体):两步流程,先发送 OTP,再验证并完成设置。示例命令: bankr login email user@example.com bankr login email user@example.com --code 123456 --accept-terms --key-name "My Agent" --read-write 此方式会创建钱包、接受条款并生成 API 密钥,无需浏览器。执行第二步前需询问用户需要只读还是读写权限、是否需要 LLM 网关以及密钥名称。
- Bankr Terminal:访问 bankr.bot/api,注册/登录(邮箱加一次性验证码),生成启用 Agent API 访问的密钥(以 bk_ 开头)。 两种方式都会自动配置 EVM 钱包(Base、Ethereum、Polygon、Unichain)和 Solana 钱包,无需手动设置。
三、主要能力
- 交易操作:代币兑换(跨链买卖/交换)、跨链桥接、限价单、止损、DCA(定投)、TWAP(时间加权平均价格)。
- 投资组合管理:查询所有链上的余额、查看美元估值、按代币或链追踪持仓、实时价格更新、多链聚合,可按链过滤(bankr balances --chain base,solana 或 GET /agent/balances?chains=base,solana)。
- 市场研究:代币价格与市场数据、技术分析(RSI、MACD 等)、社交情绪分析、价格图表、热门代币、代币对比。
- 转账:发送到地址、ENS 或社交账号,支持多链、灵活金额格式、社交账号解析(Twitter、Farcaster、Telegram)。
- NFT 操作:浏览和搜索合集、查看地板价和挂单、通过 OpenSea 购买、查看 NFT 持仓、转移 NFT、从支持的平台铸造。
- Polymarket 下注:搜索预测市场、查看赔率、对结果下注、查看持仓、领取奖金。
- 杠杆交易:做多/做空(加密货币最高 50 倍,外汇/商品最高 100 倍),支持加密货币、外汇和商品,止损止盈,通过 Base 上的 Avantis 管理仓位。
- 代币部署:EVM(Base)上通过 Clanker 部署 ERC20 代币,可自定义元数据和社交链接;Solana 上通过 Raydium LaunchLab 发行 SPL 代币,带联合曲线并自动迁移到 CPMM;两条链均可领取创作者费用;Solana 提供 Fee Key NFT(迁移后 50% LP 交易费);Solana 可选指定费用接收方(99.9%/0.1% 分成);创作者和费用接收方均可领取联合曲线费用(Gas 赞助);Solana 可选归属参数;速率限制为标准 1 次/天、Bankr Club 10 次/天(限额内 Gas 赞助)。
- 自动化:限价单、止损单、DCA、TWAP、定时命令。
- 任意交易:提交带明确 calldata 的原始 EVM 交易、对任意地址的自定义合约调用、执行其他工具预构建的 calldata、带数据的价值转移。
四、使用方式
- Bankr CLI(推荐): 安装:bun install -g @bankr/cli 或 npm install -g @bankr/cli 登录:bankr login --api-key bk_YOUR_KEY_HERE;如需在 Terminal 创建密钥,运行 bankr login --url 获取网址。 验证:bankr whoami、bankr prompt "What is my balance?" 简单查询:bankr prompt "What is my ETH balance?";未识别命令会被当作提示词,如 bankr What is the price of ETH? 交互式提示:bankr prompt(避免 shell 展开 $ 等特殊字符),或 echo 'Buy $50 of ETH on Base' | bankr prompt 会话线程:bankr prompt --continue "And what about BTC?" 或 bankr prompt --thread thr_ABC123 "Show me ETH chart" 手动任务控制:bankr status job_abc123、bankr cancel job_abc123 配置:bankr config get/set,有效键为 apiKey、apiUrl、llmKey、llmUrl;默认配置位置 ~/.bankr/config.json,可用 --config 或 BANKR_CONFIG 覆盖。 环境变量:BANKR_API_KEY、BANKR_API_URL、BANKR_LLM_KEY、BANKR_LLM_URL;环境变量优先于配置文件,配置文件优先于默认值。
- REST API(直接调用): 所有请求需 X-API-Key 头。示例: curl -X POST "https://api.bankr.bot/agent/prompt" -H "X-API-Key: bk_YOUR_API_KEY" -H "Content-Type: application/json" -d '{"prompt": "What is my ETH balance?"}' 工作流为提交→轮询→完成:提交提示词返回 jobId,轮询 /agent/job/{jobId} 直到状态为 completed、failed 或 cancelled,再读取 .response。 会话线程:每次响应包含 threadId,回传可继续对话;省略则开启新会话。 端点:POST /agent/prompt(异步提交)、GET /agent/job/{jobId}(查询状态与结果)、POST /agent/job/{jobId}/cancel(取消)、GET /agent/balances(跨链余额,同步,可选 ?chains= 过滤)、POST /agent/sign(签名消息/交易,同步)、POST /agent/submit(提交原始交易,同步)。
- LLM 网关: 基础 URL:https://llm.bankr.bot,使用 llmKey(未配置则回退到 API 密钥)。 命令:bankr llm models、bankr llm credits、bankr llm setup openclaw [--install]、bankr llm setup opencode [--install]、bankr llm setup claude、bankr llm setup cursor、bankr llm claude [--model ...]。 兼容 OpenAI 和 Anthropic SDK,只需覆盖 base URL。示例: curl -X POST "https://llm.bankr.bot/v1/chat/completions" -H "Authorization: Bearer $BANKR_LLM_KEY" -H "Content-Type: application/json" -d '{"model": "claude-sonnet-4.5", "messages": [{"role": "user", "content": "Hello"}]}'
五、支持的链 Base(原生 ETH,适合 Memecoin 和一般交易,Gas 极低)、Polygon(MATIC,适合游戏、NFT、频繁交易,Gas 极低)、Ethereum(ETH,适合蓝筹和高流动性,Gas 高)、Solana(SOL,适合高速交易,Gas 极低)、Unichain(ETH,较新的 L2 选项,Gas 极低)。
六、安全与访问控制
- 专用智能体钱包:构建自主智能体时应创建单独的 Bankr 账户,而非使用个人钱包,以隔离资金;仅存入有限金额并按需补充。
- API 密钥类型:单一格式(bk_...),带能力标志(agentApiEnabled、llmGatewayEnabled);可选用独立 LLM 网关密钥(bankr config set llmKey 或 BANKR_LLM_KEY)。
- 只读密钥:readOnly: true 会过滤所有写工具(兑换、转账、质押、代币发行等),/agent/sign 和 /agent/submit 返回 403,适合监控机器人和研究智能体。
- IP 白名单:在 API 密钥上设置 allowedIps,非白名单 IP 在认证层返回 403。
- 速率限制:标准 100 条消息/天,Bankr Club 1,000 条/天,或按密钥自定义;从首条消息起 24 小时滚动窗口重置。LLM 网关使用基于额度的系统。
- 密钥安全规则:将密钥存储在环境变量(BANKR_API_KEY、BANKR_LLM_KEY)中,切勿写入源代码;将 ~/.bankr/ 和 .env 加入 .gitignore(CLI 将凭据存储在 ~/.bankr/conf...)。
七、限制 LLM 网关目前仅限 beta 测试者使用。代币部署有速率限制(标准 1 次/天,Bankr Club 10 次/天)。杠杆倍数上限为加密货币 50 倍、外汇/商品 100 倍。其他未在资料中说明的限制暂未提供。