bankr

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Bankr

Execute crypto trading and DeFi operations using natural language through Bankr's AI agent API.

通过Bankr的AI Agent API，使用自然语言执行加密货币交易和DeFi操作。

Quick Start

快速开始

First-Time Setup

首次设置

There are two ways to get started:

有两种方式开始使用：

Option A: User provides an existing API key

选项A：用户提供现有API密钥

If the user already has a Bankr API key, they can provide it directly:

bash

mkdir -p ~/.clawdbot/skills/bankr
cat > ~/.clawdbot/skills/bankr/config.json << 'EOF'
{
  "apiKey": "bk_YOUR_KEY_HERE",
  "apiUrl": "https://api.bankr.bot"
}
EOF

API keys can be created and managed at bankr.bot/api. The key must have Agent API access enabled.

如果用户已经拥有Bankr API密钥，可以直接提供：

bash

mkdir -p ~/.clawdbot/skills/bankr
cat > ~/.clawdbot/skills/bankr/config.json << 'EOF'
{
  "apiKey": "bk_YOUR_KEY_HERE",
  "apiUrl": "https://api.bankr.bot"
}
EOF

API密钥可在bankr.bot/api创建和管理。该密钥必须启用Agent API访问权限。

Option B: Create a new account (guided by Clawd)

选项B：创建新账户（由Clawd引导）

Clawd can walk the user through the full signup flow:

Sign up / Sign in — User provides their email address. Bankr sends a one-time passcode (OTP) to that email. Creating a new account automatically provisions EVM wallets (Base, Ethereum, Polygon, Unichain) and a Solana wallet — no manual wallet setup needed.
Enter OTP — User checks their email and provides the OTP code.
Generate API key — Once authenticated, navigate to bankr.bot/api to create an API key with Agent API access enabled.
Configure — Save the key (starts with
```
bk_
```
) to config:

bash

mkdir -p ~/.clawdbot/skills/bankr
cat > ~/.clawdbot/skills/bankr/config.json << 'EOF'
{
  "apiKey": "bk_YOUR_KEY_HERE",
  "apiUrl": "https://api.bankr.bot"
}
EOF

Clawd可以引导用户完成完整的注册流程：

注册/登录 — 用户提供邮箱地址。Bankr会向该邮箱发送一次性验证码（OTP）。创建新账户会自动配置EVM钱包（Base、Ethereum、Polygon、Unichain）和Solana钱包 — 无需手动设置钱包。
输入OTP — 用户查看邮箱并提供验证码。
生成API密钥 — 认证完成后，前往bankr.bot/api创建启用Agent API访问权限的API密钥。
配置 — 将密钥（以
```
bk_
```
开头）保存到配置文件：

bash

mkdir -p ~/.clawdbot/skills/bankr
cat > ~/.clawdbot/skills/bankr/config.json << 'EOF'
{
  "apiKey": "bk_YOUR_KEY_HERE",
  "apiUrl": "https://api.bankr.bot"
}
EOF

Verify Setup

验证设置

bash

scripts/bankr.sh "What is my balance?"

bash

scripts/bankr.sh "What is my balance?"

Core Usage

核心用法

Simple Query

简单查询

For straightforward requests that complete quickly:

bash

scripts/bankr.sh "What is my ETH balance?"
scripts/bankr.sh "What's the price of Bitcoin?"

The main script handles the full submit-poll-complete workflow automatically.

适用于快速完成的简单请求：

bash

scripts/bankr.sh "我的ETH余额是多少？"
scripts/bankr.sh "比特币的价格是多少？"

主脚本会自动处理完整的提交-轮询-完成流程。

Manual Job Control

手动任务控制

For advanced use or long-running operations:

bash

undefined

适用于高级使用或长时间运行的操作：

bash

undefined

Submit and get job ID

提交并获取任务ID

JOB_ID=$(scripts/bankr-submit.sh "Buy $100 of ETH" | jq -r '.jobId')

JOB_ID=$(scripts/bankr-submit.sh "买入100美元的ETH" | jq -r '.jobId')

Poll for status

轮询状态

scripts/bankr-status.sh "$JOB_ID"

Cancel if needed

如需取消

scripts/bankr-cancel.sh "$JOB_ID"

undefined

scripts/bankr-cancel.sh "$JOB_ID"

undefined

Capabilities Overview

功能概述

Trading Operations

交易操作

Token Swaps: Buy/sell/swap tokens across chains
Cross-Chain: Bridge tokens between chains
Limit Orders: Execute at target prices
Stop Loss: Automatic sell protection
DCA: Dollar-cost averaging strategies
TWAP: Time-weighted average pricing

Reference: references/token-trading.md

代币兑换：跨链买入/卖出/兑换代币
跨链桥接：在不同网络间桥接代币
限价订单：按目标价格执行交易
止损订单：自动卖出保护
DCA（美元成本平均）：定期定额投资策略
TWAP（时间加权平均价格）：分时段执行交易以优化价格

参考文档：references/token-trading.md

Portfolio Management

投资组合管理

Check balances across all chains
View USD valuations
Track holdings by token or chain
Real-time price updates
Multi-chain aggregation

Reference: references/portfolio.md

查看所有网络的余额
查看美元估值
按代币或网络追踪持仓
实时价格更新
多链资产汇总

参考文档：references/portfolio.md

Market Research

市场调研

Token prices and market data
Technical analysis (RSI, MACD, etc.)
Social sentiment analysis
Price charts
Trending tokens
Token comparisons

Reference: references/market-research.md

代币价格和市场数据
技术分析（RSI、MACD等）
社交情绪分析
价格图表
热门代币
代币对比

参考文档：references/market-research.md

Transfers

转账

Send to addresses, ENS, or social handles
Multi-chain support
Flexible amount formats
Social handle resolution (Twitter, Farcaster, Telegram)

Reference: references/transfers.md

向地址、ENS或社交账号转账
多链支持
灵活的金额格式
社交账号解析（Twitter、Farcaster、Telegram）

参考文档：references/transfers.md

NFT Operations

NFT操作

Browse and search collections
View floor prices and listings
Purchase NFTs via OpenSea
View your NFT portfolio
Transfer NFTs
Mint from supported platforms

Reference: references/nft-operations.md

浏览和搜索NFT合集
查看地板价和挂单
通过OpenSea购买NFT
查看个人NFT投资组合
转账NFT
从支持的平台铸造NFT

参考文档：references/nft-operations.md

Polymarket Betting

Polymarket下注

Search prediction markets
Check odds
Place bets on outcomes
View positions
Redeem winnings

Reference: references/polymarket.md

搜索预测市场
查看赔率
针对结果下注
查看持仓
提取奖金

参考文档：references/polymarket.md

Leverage Trading

杠杆交易

Long/short positions (up to 50x crypto, 100x forex/commodities)
Crypto, forex, and commodities
Stop loss and take profit
Position management via Avantis on Base

Reference: references/leverage-trading.md

做多/做空仓位（加密货币最高50倍杠杆，外汇/大宗商品最高100倍）
支持加密货币、外汇和大宗商品
止损和止盈设置
通过Base网络的Avantis管理仓位

参考文档：references/leverage-trading.md

Token Deployment

代币部署

EVM (Base): Deploy ERC20 tokens via Clanker with customizable metadata and social links
Solana: Launch SPL tokens via Raydium LaunchLab with bonding curve and auto-migration to CPMM
Creator fee claiming on both chains
Fee Key NFTs for Solana (50% LP trading fees post-migration)
Optional fee recipient designation with 99.9%/0.1% split (Solana)
Both creator AND fee recipient can claim bonding curve fees (gas sponsored)
Optional vesting parameters (Solana)
Rate limits: 1/day standard, 10/day Bankr Club (gas sponsored within limits)

Reference: references/token-deployment.md

EVM（Base）：通过Clanker部署ERC20代币，支持自定义元数据和社交链接
Solana：通过Raydium LaunchLab发行SPL代币，支持 bonding curve 和自动迁移至CPMM
支持在两条链上提取创作者费用
Solana网络的Fee Key NFT（迁移后可获得50%的LP交易费用）
可选费用接收方设置，按99.9%/0.1%分配（Solana）
创作者和费用接收方均可提取bonding curve费用（Gas由平台赞助）
可选锁仓参数（Solana）
速率限制：标准用户1次/天，Bankr Club用户10次/天（Gas在限额内由平台赞助）

参考文档：references/token-deployment.md

Automation

自动化

Limit orders
Stop loss orders
DCA (dollar-cost averaging)
TWAP (time-weighted average price)
Scheduled commands

Reference: references/automation.md

限价订单
止损订单
DCA（美元成本平均）
TWAP（时间加权平均价格）
定时指令

参考文档：references/automation.md

Arbitrary Transactions

任意交易

Submit raw EVM transactions with explicit calldata
Custom contract calls to any address
Execute pre-built calldata from other tools
Value transfers with data

Reference: references/arbitrary-transaction.md

提交包含明确calldata的原始EVM交易
调用任意地址的自定义合约
执行其他工具生成的预构建calldata
附带数据的价值转账

参考文档：references/arbitrary-transaction.md

Supported Chains

支持的网络

Chain	Native Token	Best For	Gas Cost
Base	ETH	Memecoins, general trading	Very Low
Polygon	MATIC	Gaming, NFTs, frequent trades	Very Low
Ethereum	ETH	Blue chips, high liquidity	High
Solana	SOL	High-speed trading	Minimal
Unichain	ETH	Newer L2 option	Very Low

网络	原生代币	适用场景	Gas成本
Base	ETH	模因币、通用交易	极低
Polygon	MATIC	游戏、NFT、高频交易	极低
Ethereum	ETH	主流代币、高流动性资产	高
Solana	SOL	高速交易	极低
Unichain	ETH	新一代L2选项	极低

Common Patterns

常见使用模式

Check Before Trading

交易前检查

bash

undefined

bash

undefined

Check balance

检查余额

scripts/bankr.sh "What is my ETH balance on Base?"

scripts/bankr.sh "我在Base网络的ETH余额是多少？"

Check price

检查价格

scripts/bankr.sh "What's the current price of PEPE?"

scripts/bankr.sh "PEPE的当前价格是多少？"

Then trade

然后进行交易

scripts/bankr.sh "Buy $20 of PEPE on Base"

undefined

scripts/bankr.sh "在Base网络买入20美元的PEPE"

undefined

Portfolio Review

投资组合回顾

bash

undefined

bash

undefined

Full portfolio

完整投资组合

scripts/bankr.sh "Show my complete portfolio"

scripts/bankr.sh "显示我的完整投资组合"

Chain-specific

特定网络

scripts/bankr.sh "What tokens do I have on Base?"

scripts/bankr.sh "我在Base网络持有哪些代币？"

Token-specific

特定代币

scripts/bankr.sh "Show my ETH across all chains"

undefined

scripts/bankr.sh "显示我在所有网络的ETH持仓"

undefined

Set Up Automation

设置自动化策略

bash

undefined

bash

undefined

DCA strategy

DCA策略

scripts/bankr.sh "DCA $100 into ETH every week"

scripts/bankr.sh "每周定投100美元买入ETH"

Stop loss protection

止损保护

scripts/bankr.sh "Set stop loss for my ETH at $2,500"

scripts/bankr.sh "为我的ETH设置2500美元的止损"

Limit order

限价订单

scripts/bankr.sh "Buy ETH if price drops to $3,000"

undefined

scripts/bankr.sh "当ETH价格跌至3000美元时买入"

undefined

Market Research

市场调研

bash

undefined

bash

undefined

Price and analysis

价格和分析

scripts/bankr.sh "Do technical analysis on ETH"

scripts/bankr.sh "对ETH进行技术分析"

Trending tokens

Compare tokens

代币对比

scripts/bankr.sh "Compare ETH vs SOL"

undefined

scripts/bankr.sh "对比ETH和SOL"

undefined

API Workflow

API工作流

Bankr uses an asynchronous job-based API:

Submit - Send prompt, get job ID
Poll - Check status every 2 seconds
Complete - Process results when done

The

bankr.sh

wrapper handles this automatically. For details on the API structure, job states, polling strategy, and error handling, see:

Reference: references/api-workflow.md

Bankr采用基于异步任务的API：

提交 - 发送指令，获取任务ID
轮询 - 每2秒检查一次状态
完成 - 任务完成后处理结果

bankr.sh

封装脚本会自动处理此流程。如需了解API结构、任务状态、轮询策略和错误处理的详细信息，请查看：

参考文档：references/api-workflow.md

Synchronous Endpoints

同步端点

For direct signing and transaction submission, Bankr also provides synchronous endpoints:

POST /agent/sign - Sign messages, typed data, or transactions without broadcasting
POST /agent/submit - Submit raw transactions directly to the blockchain

These endpoints return immediately (no polling required) and are ideal for:

Authentication flows (sign messages)
Gasless approvals (sign EIP-712 permits)
Pre-built transactions (submit raw calldata)

Reference: references/sign-submit-api.md

对于直接签名和交易提交，Bankr还提供同步端点：

POST /agent/sign - 签署消息、类型化数据或交易，无需广播
POST /agent/submit - 直接向区块链提交原始交易

这些端点会立即返回结果（无需轮询），适用于：

认证流程（签署消息）
无Gas授权（签署EIP-712许可）
预构建交易（提交原始calldata）

参考文档：references/sign-submit-api.md

Error Handling

错误处理

Common issues and fixes:

Authentication errors → Check API key setup
Insufficient balance → Add funds or reduce amount
Token not found → Verify symbol and chain
Transaction reverted → Check parameters and balances
Rate limiting → Wait and retry

For comprehensive error troubleshooting, setup instructions, and debugging steps, see:

Reference: references/error-handling.md

常见问题及解决方法：

认证错误 → 检查API密钥设置
余额不足 → 充值或减少交易金额
代币未找到 → 验证代币符号和网络
交易回滚 → 检查参数和余额
速率限制 → 等待后重试

如需全面的错误排查、设置说明和调试步骤，请查看：

参考文档：references/error-handling.md

Best Practices

最佳实践

Security

安全

Never share your API key
Start with small test amounts
Verify addresses before large transfers
Use stop losses for leverage trading
Double-check transaction details

切勿分享你的API密钥
先使用小额测试金额
大额转账前验证地址
杠杆交易时使用止损
仔细核对交易细节

Trading

交易

Check balance before trades
Specify chain for lesser-known tokens
Consider gas costs (use Base/Polygon for small amounts)
Start small, scale up after testing
Use limit orders for better prices

交易前检查余额
小众代币需指定网络
考虑Gas成本（小额交易使用Base/Polygon）
从小额开始，测试后再扩大规模
使用限价订单获取更优价格

Automation

自动化

Test automation with small amounts first
Review active orders regularly
Set realistic price targets
Always use stop loss for leverage
Monitor execution and adjust as needed

先使用小额测试自动化策略
定期查看活跃订单
设置合理的价格目标
杠杆交易务必使用止损
监控执行情况并按需调整

Tips for Success

成功技巧

For New Users

新用户

Start with balance checks and price queries
Test with $5-10 trades first
Use Base for lower fees
Enable trading confirmations initially
Learn one feature at a time

从余额查询和价格查询开始
先测试5-10美元的交易
使用Base网络以降低手续费
初始阶段启用交易确认
逐个学习功能

For Experienced Users

资深用户

Leverage automation for strategies
Use multiple chains for diversification
Combine DCA with stop losses
Explore advanced features (leverage, Polymarket)
Monitor gas costs across chains

利用自动化执行策略
使用多链进行分散投资
结合DCA和止损策略
探索高级功能（杠杆、Polymarket）
监控各网络的Gas成本

Prompt Examples by Category

按类别划分的指令示例

Trading

交易

"Buy $50 of ETH on Base"
"Swap 0.1 ETH for USDC"
"Sell 50% of my PEPE"
"Bridge 100 USDC from Polygon to Base"

"在Base网络买入50美元的ETH"
"将0.1 ETH兑换为USDC"
"卖出我持有的50% PEPE"
"将100 USDC从Polygon桥接到Base"

Portfolio

投资组合

"Show my portfolio"
"What's my ETH balance?"
"Total portfolio value"
"Holdings on Base"

"显示我的投资组合"
"我的ETH余额是多少？"
"投资组合总价值"
"Base网络的持仓"

Market Research

市场调研

"What's the price of Bitcoin?"
"Analyze ETH price"
"Trending tokens on Base"
"Compare UNI vs SUSHI"

"比特币的价格是多少？"
"分析ETH的价格走势"
"Base网络的热门代币"
"对比UNI和SUSHI"

Transfers

转账

"Send 0.1 ETH to vitalik.eth"
"Transfer $20 USDC to @friend"
"Send 50 USDC to 0x123..."

"向vitalik.eth转账0.1 ETH"
"向@friend转账20美元的USDC"
"向0x123...转账50 USDC"

NFTs

NFT

"Show Bored Ape floor price"
"Buy cheapest Pudgy Penguin"
"Show my NFTs"

"显示Bored Ape的地板价"
"购买最便宜的Pudgy Penguin"
"显示我的NFT"

Polymarket

"What are the odds Trump wins?"
"Bet $10 on Yes for [market]"
"Show my Polymarket positions"

"特朗普获胜的赔率是多少？"
"在[市场]上下注10美元支持Yes"
"显示我的Polymarket持仓"

Leverage

杠杆交易

"Open 5x long on ETH with $100"
"Short BTC 10x with stop loss at $45k"
"Show my Avantis positions"

"用100美元开5倍杠杆做多ETH"
"用10倍杠杆做空BTC，止损设置为45000美元"
"显示我的Avantis持仓"

Automation

自动化

"DCA $100 into ETH weekly"
"Set limit order to buy ETH at $3,000"
"Stop loss for all holdings at -20%"

"每周定投100美元买入ETH"
"设置限价订单，在ETH价格跌至3000美元时买入"
"为所有持仓设置20%跌幅的止损"

Token Deployment

代币部署

Solana (LaunchLab):

"Launch a token called MOON on Solana"
"Launch a token called FROG and give fees to @0xDeployer"
"Deploy SpaceRocket with symbol ROCK"
"Launch BRAIN and route fees to 7xKXtg..."
"How much fees can I claim for MOON?"
"Claim my fees for MOON" (works for creator or fee recipient)
"Show my Fee Key NFTs"
"Claim my fee NFT for ROCKET" (post-migration)
"Transfer fees for MOON to 7xKXtg..."

EVM (Clanker):

"Deploy a token called BankrFan with symbol BFAN on Base"
"Claim fees for my token MTK"

Solana（LaunchLab）：

"在Solana网络发行名为MOON的代币"
"发行名为FROG的代币，并将费用分配给@0xDeployer"
"部署名为SpaceRocket、符号为ROCK的代币"
"发行BRAIN代币，将费用路由至7xKXtg..."
"我可以提取MOON代币的多少费用？"
"提取我的MOON代币费用"（创作者和费用接收方均可使用）
"显示我的Fee Key NFT"
"提取我的ROCKET代币Fee NFT"（迁移后）
"将MOON代币的费用转账至7xKXtg..."

EVM（Clanker）：

"在Base网络发行名为BankrFan、符号为BFAN的代币"
"提取我的MTK代币费用"

Arbitrary Transactions

任意交易

"Submit this transaction: {to: 0x..., data: 0x..., value: 0, chainId: 8453}"
"Execute this calldata on Base: {...}"
"Send raw transaction with this JSON: {...}"

"提交此交易：{to: 0x..., data: 0x..., value: 0, chainId: 8453}"
"在Base网络执行此calldata：{...}"
"发送包含此JSON的原始交易：{...}"

Sign API (Synchronous)

签名API（同步）

Direct message signing without AI processing:

bash

undefined

无需AI处理的直接消息签名：

bash

undefined

Sign a plain text message

签署纯文本消息

curl -X POST "https://api.bankr.bot/agent/sign"
-H "X-API-Key: $API_KEY"
-H "Content-Type: application/json"
-d '{"signatureType": "personal_sign", "message": "Hello, Bankr!"}'

Sign EIP-712 typed data (permits, orders)

签署EIP-712类型化数据（许可、订单）

curl -X POST "https://api.bankr.bot/agent/sign"
-H "X-API-Key: $API_KEY"
-H "Content-Type: application/json"
-d '{"signatureType": "eth_signTypedData_v4", "typedData": {...}}'

Sign a transaction without broadcasting

签署交易但不广播

curl -X POST "https://api.bankr.bot/agent/sign"
-H "X-API-Key: $API_KEY"
-H "Content-Type: application/json"
-d '{"signatureType": "eth_signTransaction", "transaction": {"to": "0x...", "chainId": 8453}}'

undefined

undefined

Submit API (Synchronous)

提交API（同步）

Direct transaction submission without AI processing:

bash

undefined

无需AI处理的直接交易提交：

bash

undefined

Submit a raw transaction

提交原始交易

curl -X POST "https://api.bankr.bot/agent/submit"
-H "X-API-Key: $API_KEY"
-H "Content-Type: application/json"
-d '{ "transaction": {"to": "0x...", "chainId": 8453, "value": "1000000000000000000"}, "waitForConfirmation": true }'


**Reference**: [references/sign-submit-api.md](references/sign-submit-api.md)


**参考文档**：[references/sign-submit-api.md](references/sign-submit-api.md)

Resources

资源

Agent API Reference: https://www.notion.so/Agent-API-2e18e0f9661f80cb83ccfc046f8872e3
API Key Management: https://bankr.bot/api
Terminal: https://bankr.bot/terminal
Twitter: @bankr_bot

Agent API参考：https://www.notion.so/Agent-API-2e18e0f9661f80cb83ccfc046f8872e3
API密钥管理：https://bankr.bot/api
终端：https://bankr.bot/terminal
Twitter：@bankr_bot

Troubleshooting

故障排除

Scripts Not Working

脚本无法运行

bash

undefined

bash

undefined

Ensure scripts are executable

确保脚本可执行

chmod +x ~/.clawdbot/skills/bankr/scripts/*.sh

Test connectivity

测试连接

curl -I https://api.bankr.bot

undefined

curl -I https://api.bankr.bot

undefined

API Errors

API错误

See references/error-handling.md for comprehensive troubleshooting.

请查看references/error-handling.md获取全面的故障排查信息。

Getting Help

获取帮助

Check error message in response JSON
Consult relevant reference document
Verify configuration and connectivity
Test with simple queries first

💡 Pro Tip: The most common issue is not specifying the chain for tokens. When in doubt, always include "on Base" or "on Ethereum" in your prompt.

⚠️ Security: Keep your API key private. Never commit config.json to version control. Only trade amounts you can afford to lose.

🚀 Quick Win: Start by checking your portfolio to see what's possible, then try a small $5-10 trade on Base to get familiar with the flow.

查看响应JSON中的错误消息
查阅相关参考文档
验证配置和连接
先测试简单查询

💡 专业提示：最常见的问题是未指定代币的网络。如有疑问，请在指令中始终包含“在Base”或“在Ethereum”。

⚠️ 安全提示：请妥善保管你的API密钥。切勿将config.json提交到版本控制。仅交易你能承受损失的金额。

🚀 快速上手：先查看你的投资组合了解可用功能，然后在Base网络尝试5-10美元的小额交易以熟悉流程。