Bankr

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

Quick Start

First-Time Setup

There are two ways to get started:

Option A: User provides an existing API key

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

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.

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

Clawd can walk the user through the full signup flow:

1. 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.
2. Enter OTP — User checks their email and provides the OTP code.
3. Generate API key — Once authenticated, navigate to bankr.bot/api to create an API key with Agent API access enabled.
4. Configure — Save the key (starts with bk_) to config:

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

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

Core Usage

Simple Query

For straightforward requests that complete quickly:

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.

Manual Job Control

For advanced use or long-running operations:

# Submit and get job ID
JOB_ID=$(scripts/bankr-submit.sh "Buy $100 of ETH" | jq -r '.jobId')

# Poll for status
scripts/bankr-status.sh "$JOB_ID"

# Cancel if needed
scripts/bankr-cancel.sh "$JOB_ID"

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

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

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

Transfers

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

Reference: references/transfers.md

NFT Operations

• 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

Polymarket Betting

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

Reference: 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

Token Deployment

• Deploy ERC20 tokens on Base and Unichain via Clanker
• Customizable name, symbol, description, and social links
• Creator fee claiming
• Rate limits: 1/day standard, 10/day Bankr Club

Reference: 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

Supported Chains

Common Patterns

Check Before Trading

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

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

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

Portfolio Review

# Full portfolio
scripts/bankr.sh "Show my complete portfolio"

# Chain-specific
scripts/bankr.sh "What tokens do I have on Base?"

# Token-specific
scripts/bankr.sh "Show my ETH across all chains"

Set Up Automation

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

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

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

Market Research

# Price and analysis
scripts/bankr.sh "Do technical analysis on ETH"

# Trending tokens
scripts/bankr.sh "What tokens are trending on Base?"

# Compare tokens
scripts/bankr.sh "Compare ETH vs SOL"

API Workflow

Bankr uses an asynchronous job-based API:

1. Submit – Send prompt, get job ID
2. Poll – Check status every 2 seconds
3. 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

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

Best Practices

Security

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

Trading

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

Automation

1. Test automation with small amounts first
2. Review active orders regularly
3. Set realistic price targets
4. Always use stop loss for leverage
5. 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

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

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”

Portfolio

• “Show my portfolio”
• “What’s my ETH balance?”
• “Total portfolio value”
• “Holdings on Base”

Market Research

• “What’s the price of Bitcoin?”
• “Analyze ETH price”
• “Trending tokens on Base”
• “Compare UNI vs SUSHI”

Transfers

• “Send 0.1 ETH to vitalik.eth”
• “Transfer $20 USDC to @friend”
• “Send 50 USDC to 0x123…”

NFTs

• “Show Bored Ape floor price”
• “Buy cheapest Pudgy Penguin”
• “Show my NFTs”

Polymarket

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

Leverage

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

Automation

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

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

Troubleshooting

Scripts Not Working

# Ensure scripts are executable
chmod +x ~/.clawdbot/skills/bankr/scripts/*.sh

# Test connectivity
curl -I https://api.bankr.bot

API Errors

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

Getting Help

1. Check error message in response JSON
2. Consult relevant reference document
3. Verify configuration and connectivity
4. 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.