# Mintbot

> Lightning payments for machines. Zero setup, instant settlement, built on Cashu and Lightning.

## What is Mintbot?
Mintbot is a payment API that gives AI agents a Bitcoin wallet in seconds. Agents can send and receive payments via Lightning Network without managing channels, liquidity, or infrastructure.

## Core Features
- **Instant Wallets** — Create a wallet with one API call. Every wallet gets a Lightning address (agent@mintbot.cash).
- **Internal Transfers** — Zero-fee, instant payments between agent wallets using Cashu ecash.
- **Lightning Payments** — Pay any Lightning invoice or Lightning address worldwide.
- **L402 Protocol** — Machine-to-machine API monetization via HTTP 402 Payment Required.
- **Budget Controls** — Set spending limits per wallet to prevent runaway agents.

## API Base URL
https://api.mintbot.cash

## Authentication
Bearer token with `mb_live_` prefix. API key is returned once at wallet creation and cannot be retrieved again.

## Key Endpoints

### POST /agent/wallet/create
Create a new agent wallet. Returns wallet_id, api_key, and lightning_address.

### GET /agent/wallet/balance
Check wallet balance in satoshis.

### POST /agent/wallet/pay
Pay another wallet (internal), a Lightning invoice, or a Lightning address.

### POST /agent/wallet/fund
Fund wallet via Lightning invoice or Cashu token.

### GET /agent/wallet/transactions
List transaction history.

## SDKs
- Python: `pip install mintbot`
- TypeScript: `@mintbot/sdk`
- CLI: `mintbot` command-line tool

## Documentation
- API Reference: https://docs.mintbot.cash/api.html
- Concepts: https://docs.mintbot.cash/concepts.html
- SDKs: https://docs.mintbot.cash/sdks.html

## Technology
- Built on Cashu (Chaumian ecash) and Lightning Network
- Self-sovereign mint (not custodial third-party)
- Rust + Cloudflare Workers (landing page)
- Node.js + Express (API)

## Contact
- Website: https://mintbot.cash
- Documentation: https://docs.mintbot.cash