bankr

What this skill does

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

```bash
mkdir -p ~/.thinkfleet/skills/bankr
cat > ~/.thinkfleet/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](https://bankr.bot/api). The key must have **Agent API** access enabled.

#### Option B: Create a new account (guided by ThinkFleet)

ThinkFleet 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](https://bankr.bot/api) to create an API key with **Agent API** access enabled.
4. **Configure** — Save the key (starts with `bk_`) to config:

```bash
mkdir -p ~/.thinkfleet/skills/bankr
cat > ~/.thinkfleet/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?"
```

## 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.

### Manual Job Control

For advanced use or long-running operations:

```bash
# 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](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](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](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](references/nft-operations.md)

### Polymarket Betting

- 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](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](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](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](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 |

## Common Patterns

### Check Before Trading

```bash
# 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

```bash
# 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

```bash
# 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

```bash
# 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](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](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