risk art agent

Configuration Commands

| Command | Description | |---------|-------------| | bankr config get [key] | Get config value(s) | | bankr config set | Set a config value | | bankr --config | Use a custom config file path |

Valid config keys: apiKey, apiUrl, llmKey, llmUrl

Default config location: ~/.bankr/config.json. Override with --config or BANKR_CONFIG env var.

Environment Variables

| Variable | Description | |----------|-------------| | BANKR_API_KEY | API key (overrides stored key) | | BANKR_API_URL | API URL (default: https://api.bankr.bot) | | BANKR_LLM_KEY | LLM gateway key (falls back to BANKR_API_KEY if not set) | | BANKR_LLM_URL | LLM gateway URL (default: https://llm.bankr.bot) |

Environment variables override config file values. Config file values override defaults.

LLM Gateway Commands

| Command | Description | |---------|-------------| | bankr llm models | List available LLM models | | bankr llm credits | Check credit balance | | bankr llm credits add [--token ] [-y] | Top up LLM credits from wallet | | bankr llm credits auto [--enable/--disable] [--amount] [--threshold] [--tokens] | View or configure auto top-up | | bankr llm setup openclaw [--install] | Generate or install OpenClaw config | | bankr llm setup opencode [--install] | Generate or install OpenCode config | | bankr llm setup claude | Show Claude Code environment setup | | bankr llm setup cursor | Show Cursor IDE setup instructions | | bankr llm claude [args...] | Launch Claude Code via the Bankr LLM Gateway |

Core Usage

Simple Query

For straightforward requests that complete quickly:

bankr prompt "What is my ETH balance?"
bankr prompt "What's the price of Bitcoin?"

The CLI handles the full submit-poll-complete workflow automatically. You can also use the shorthand — any unrecognized command is treated as a prompt:

bankr What is the price of ETH?

Interactive Prompt

For prompts containing $ or special characters that the shell would expand:

# Interactive mode — no shell expansion issues
bankr prompt
Then type: Buy $50 of ETH on Base
Or pipe input
echo 'Buy $50 of ETH on Base' | bankr prompt

Conversation Threads

Continue a multi-turn conversation with the agent:

# First prompt — starts a new thread automatically
bankr prompt "What is the price of ETH?"
→ Thread: thr_ABC123
Continue the conversation (agent remembers the ETH context)
bankr prompt --continue "And what about BTC?"
bankr prompt -c "Compare them"
Resume any thread by ID
bankr prompt --thread thr_ABC123 "Show me ETH chart"

Thread IDs are automatically saved to config after each prompt. The --continue / -c flag reuses the last thread.

Manual Job Control

For advanced use or long-running operations:

# Submit and get job ID
bankr prompt "Buy $100 of ETH"
→ Job submitted: job_abc123
Check status of a specific job
bankr status job_abc123
Cancel if needed
bankr cancel job_abc123

LLM Gateway

The Bankr LLM Gateway is a unified API for Claude, Gemini, GPT, and other models — multi-provider access, cost tracking, automatic failover, and SDK compatibility through a single endpoint.

Base URL: https://llm.bankr.bot | Dashboard: bankr.bot/llm | API Keys: bankr.bot/api

Key Concepts

Quick Commands

bankr llm models                           # List available models
bankr llm credits                          # Check credit balance
bankr llm credits add 25                   # Top up $25 credits (USDC)
bankr llm credits auto --enable --amount 25 --tokens USDC  # Auto top-up
bankr llm setup openclaw --install         # Install Bankr provider into OpenClaw
bankr llm setup claude                     # Print Claude Code env vars
bankr llm claude                           # Launch Claude Code through gateway

For full details — setup paths, model list, provider config, SDK examples, key management, and troubleshooting — see:

Reference: references/llm-gateway.md

Capabilities Overview

Trading Operations

Reference: references/token-trading.md

Portfolio Management

Reference: references/portfolio.md

Market Research

Reference: references/market-research.md

Transfers

Reference: references/transfers.md

NFT Operations

Reference: references/nft-operations.md

Polymarket Betting

Reference: references/polymarket.md

Leverage Trading

Reference: references/leverage-trading.md

Token Deployment

Reference: references/token-deployment.md

Automation

Reference: references/automation.md

Arbitrary Transactions

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

Safety & Access Control

Dedicated Agent Wallet: When building autonomous agents, create a separate Bankr account rather than using your personal wallet. This isolates agent funds — if a key is compromised, only the agent wallet is exposed. Fund it with limited amounts and replenish as needed.

API Key Types: Bankr uses a single key format (bk_...) with capability flags (agentApiEnabled, llmGatewayEnabled). You can optionally configure a separate LLM Gateway key via bankr config set llmKey or BANKR_LLM_KEY — useful when you want independent revocation or different permissions for agent vs LLM access.

Read-Only API Keys: Keys with readOnly: true filter all write tools (swaps, transfers, staking, token launches, etc.) from agent sessions. The /agent/sign and /agent/submit endpoints return 403. Ideal for monitoring bots and research agents.

IP Whitelisting: Set allowedIps on your API key to restrict usage to specific IPs. Requests from non-whitelisted IPs are rejected with 403 at the auth layer.

Rate Limits: 100 messages/day (standard), 1,000/day (Bankr Club), or custom per key. Resets 24h from first message (rolling window). LLM Gateway uses a credit-based system.

Key safety rules:

Reference: references/safety.md

Common Patterns

Check Before Trading

# Check balance
bankr prompt "What is my ETH balance on Base?"
Check price
bankr prompt "What's the current price of PEPE?"
Then trade
bankr prompt "Buy $20 of PEPE on Base"

Portfolio Review

# Direct balance check (no AI agent, instant response)
bankr balances
bankr balances --chain base
bankr balances --chain base,solana
bankr balances --json
Via AI agent (natural language, richer context)
bankr prompt "Show my complete portfolio"
Chain-specific
bankr prompt "What tokens do I have on Base?"
Token-specific
bankr prompt "Show my ETH across all chains"

Set Up Automation

# DCA strategy
bankr prompt "DCA $100 into ETH every week"
Stop loss protection
bankr prompt "Set stop loss for my ETH at $2,500"
Limit order
bankr prompt "Buy ETH if price drops to $3,000"

Market Research

# Price and analysis
bankr prompt "Do technical analysis on ETH"
Trending tokens
bankr prompt "What tokens are trending on Base?"
Compare tokens
bankr prompt "Compare ETH vs SOL"

API Workflow

Bankr uses an asynchronous job-based API:

1. Submit — Send prompt (with optional threadId), get job ID and thread ID 2. Poll — Check status every 2 seconds 3. Complete — Process results when done 4. Continue — Reuse threadId for multi-turn conversations

The bankr prompt command handles this automatically. When using the REST API directly, implement the poll loop yourself (see Option 2 above or the reference below). For manual job control via CLI, use bankr status and bankr cancel .

For details on the API structure, job states, polling strategy, and error handling, see:

Reference: references/api-workflow.md

Synchronous Endpoints

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

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

Reference: references/sign-submit-api.md

Error Handling

Common issues and fixes:

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

Reference: references/error-handling.md

Best Practices

Security

1. Never share your API key or LLM key 2. Use a dedicated agent wallet with limited funds for autonomous agents 3. Use read-only API keys for monitoring and research-only agents 4. Set IP whitelisting for server-side agents with known IPs 5. Verify addresses before large transfers 6. Use stop losses for leverage trading 7. Store keys in environment variables, not source code — add ~/.bankr/ to .gitignore

See references/safety.md for comprehensive safety guidance.

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

For Experienced Users

Prompt Examples by Category

Trading

Portfolio

Market Research

Transfers

NFTs

Polymarket

Leverage

Automation

Token Deployment

Solana (LaunchLab):

EVM (Clanker):

Arbitrary Transactions

Sign API (Synchronous)

Direct message signing without AI processing:

# 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)
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}}'

Submit API (Synchronous)

Direct transaction submission without AI processing:

# 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

Resources

Troubleshooting

CLI Not Found

# Verify installation
which bankr
Reinstall if needed
bun install -g @bankr/cli

Authentication Issues

CLI:

# Check current auth
bankr whoami
Re-authenticate
bankr login
Check LLM key specifically
bankr config get llmKey

REST API:

# Test your API key
curl -s "https://api.bankr.bot/_health" -H "X-API-Key: $BANKR_API_KEY"

API Errors

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

Getting Help

1. Check error message in CLI output or API response 2. Run bankr whoami to verify auth (CLI) or test with a curl to /_health (REST API) 3. Consult relevant reference document 4. Test with simple queries first (bankr prompt "What is my balance?" or POST /agent/prompt)

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 your config file to version control. Only trade amounts you can afford to lose.

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

Profile Management

Agents can create and manage public profile pages at bankr.bot/agents. Profiles showcase project metadata, team info, token data (chart + market cap), weekly fee revenue, shipped products, and a Twitter activity feed.

Eligibility: You must have deployed a token through Bankr (Doppler or Clanker) or be a fee beneficiary on the token to create a profile. The token address is verified against your deployment history and beneficiary records.

Profile Lifecycle

1. Deploy a token through Bankr (required prerequisite) 2. Create a profile via CLI or REST API with the token address 3. Populate metadata (team, products, revenue sources) 4. Admin approval — profiles start with approved: false and become publicly visible after admin approval 5. Maintain — post project updates, keep products and revenue sources current

CLI Commands

bankr profile                     # View own profile
bankr profile create              # Interactive creation wizard
bankr profile create --name "My Agent" --token 0x... --twitter myagent
bankr profile update --description "Updated description"
bankr profile delete              # Delete own profile (with confirmation)
bankr profile add-update          # Add a project update
bankr profile add-update --title "v2 Launch" --content "Shipped new features"

All commands support --json for structured output (enables programmatic use).

REST API Endpoints

All endpoints require API key authentication via X-API-Key header.

| Method | Path | Description | |--------|------|-------------| | GET | /agent/profile | Get own profile | | POST | /agent/profile | Create profile | | PUT | /agent/profile | Update profile fields | | DELETE | /agent/profile | Delete own profile | | POST | /agent/profile/update | Add a project update |

Create profile:

curl -X POST "https://api.bankr.bot/agent/profile" \
  -H "X-API-Key: $BANKR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"projectName": "My Agent", "tokenAddress": "0x...", "description": "An AI trading agent"}'

Add a project update:

curl -X POST "https://api.bankr.bot/agent/profile/update" \
  -H "X-API-Key: $BANKR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "v2 Launch", "content": "Shipped swap optimization and new UI"}'

See references/agent-profiles.md for the full integration guide.