๐Ÿ“– Developer Docs

Integrate in minutes,
not weeks

Python SDK. JavaScript SDK. REST API. If your agent can make HTTP requests, it can use BotBank.

Developer Experience
From zero to first payment in 3 steps
1

Install the SDK

Python
$ pip install botbank
JavaScript
$ npm install @botbank/sdk
2

Initialize with your API key

Python
from botbank import Account acct = Account("bb_live_sk_YOUR_KEY")
JavaScript
import { Account } from '@botbank/sdk' const acct = new Account('bb_live_sk_YOUR_KEY')
3

Make a payment

Python
# Pay for a service tx = acct.pay( vendor="api.openai.com", amount=4.20, memo="GPT-4o inference batch" ) print(tx.status) # "approved" print(tx.hash) # "0x7a3f...8c2d" print(tx.balance_after) # 45.80
Complete Python SDK
botbank โ€” full reference
from botbank import Account, Vault # โ”€โ”€ Account (Agent) โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ acct = Account("bb_live_sk_...") # Payments acct.pay(vendor, amount, memo="") # โ†’ Transaction acct.balance() # โ†’ float (remaining today) acct.spent_today() # โ†’ float acct.spent_month() # โ†’ float acct.limit() # โ†’ float (daily limit) # History acct.transactions(limit=50) # โ†’ [Transaction] acct.transactions(vendor="openai") # โ†’ filtered acct.transactions(since="2026-02-01")# โ†’ date range # Info acct.info() # โ†’ name, rules, status acct.rules() # โ†’ {limit, whitelist, threshold} # โ”€โ”€ Vault (Owner) โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ vault = Vault("bb_vault_sk_...") # Fund management vault.balance() # โ†’ total vault balance vault.deposit(amount) # โ†’ initiate deposit vault.withdraw(amount, to="0x...") # โ†’ initiate withdrawal vault.yield_earned() # โ†’ DeFi yield this month # Agent management vault.create_agent(name, rules) # โ†’ Agent + API key vault.agents() # โ†’ [Agent] vault.freeze(agent_name) # โ†’ freeze agent vault.unfreeze(agent_name) # โ†’ unfreeze vault.update_rules(agent_name, rules) # โ†’ update limits vault.revoke_key(key_id) # โ†’ revoke API key # Global controls vault.freeze_all() # โ†’ emergency stop vault.transactions() # โ†’ all tx across agents vault.export_csv(since, until) # โ†’ CSV download
Full API reference

Base URL: https://api.botbank.io/v1

Authentication

curl
curl https://api.botbank.io/v1/account \ -H "Authorization: Bearer bb_live_sk_YOUR_KEY"

Agent Endpoints

GET /v1/account Get account info
GET /v1/account/balance Get balance
POST /v1/account/pay Make a payment
GET /v1/transactions List transactions
GET /v1/transactions/:id Get transaction

Vault Endpoints (Owner only)

GET /v1/vault Vault info
POST /v1/vault/deposit Deposit funds
POST /v1/vault/withdraw Withdraw
POST /v1/agents Create agent
GET /v1/agents List agents
PUT /v1/agents/:id/rules Update rules
POST /v1/agents/:id/freeze Freeze agent
DEL /v1/keys/:id Revoke key

Payment Request Body

POST /v1/account/pay
{ "vendor": "api.openai.com", "amount": 4.20, "currency": "USDC", "memo": "GPT-4o batch inference", "idempotency_key": "req_abc123" }

Webhook Events

transaction.completed Payment approved & settled
transaction.rejected Payment rejected (over limit, etc.)
transaction.pending Awaiting human approval
budget.warning Agent at 80% of daily limit
budget.exhausted Agent hit daily limit
agent.frozen Agent account frozen
Works with every AI framework

๐Ÿฆœ LangChain

Native tool integration. Add BotBank as a payment tool in your chain.

๐Ÿšข CrewAI

Give each crew member its own budget and payment capability.

๐Ÿค– AutoGPT

Autonomous payment for AutoGPT tasks. Budget-controlled.

โšก Custom

REST API works with anything. Python, JS, Go, Rust โ€” your choice.

Start building now

Free tier includes 500 test transactions. No credit card required.

Get API Keys โ†’