Bitcoin Benji API

⚡ How It Works

1. Request

Hit any endpoint. No signup, no API key.

2. Invoice

Get a 402 response with a Lightning invoice (5-50 sats).

3. Pay

Pay the invoice. Your wallet provides the preimage.

4. Data

Re-send with Authorization: L402 header. Get your data.

Compatible with L402 clients (Aperture, lnget), or any HTTP client + Lightning wallet.

🧠 AI Inference

All inference runs locally on an RTX 5070 Ti. Your data never leaves the server. Drastically cheaper than OpenAI/Anthropic.

Endpoint	Method	Price	Description
/ai/agent	POST	30 sats	General AI — any text task. `{task, context?}`
/ai/code-review	POST	50 sats	Code review for bugs, security, perf. `{code, language?}`
/ai/extract	POST	25 sats	Extract structured JSON from text. `{text, schema?}`
/ai/explain	POST	25 sats	Explain any topic at your level. `{topic, level?}`
/ai/summarize	POST	20 sats	Summarize text. `{text, max_length?}`
/ai/translate	POST	20 sats	100+ languages. `{text, target, source?}`
/ai/scrape	POST	15 sats	Scrape & extract text from URL. `{url}`
/ai/grammar	POST	15 sats	Fix grammar & punctuation. `{text}`
/ai/rewrite	POST	15 sats	Rewrite in any style. `{text, style}`
/ai/sentiment	POST	10 sats	Sentiment w/ confidence. `{text}`
/ai/classify	POST	10 sats	Classify into your categories. `{text, categories[]}`

₿ Mempool Intelligence

Real-time data from a full Bitcoin Core node. Whale alerts, fee predictions, block data.

Endpoint	Method	Price	Description
/whales/stream	SSE	1 sat/min	Realtime whale alert stream (Bearer key required, ≥60 sat balance)
/whales/alerts/subscribe	POST	100 + 5/event	Webhook subscription for whale alerts. `{url, min_btc?}`
/mempool/predict	GET	50 sats	EMA fee prediction with direction + confidence
/mempool/history	GET	50 sats	Rolling 24h mempool snapshots
/whales	GET	40 sats	Whale / consolidation / distribution alerts
/fees	GET	10 sats	Fee estimates with trend analysis
/blocks	GET	10 sats	Recent block data
/mempool	GET	5 sats	Live mempool state

🎟️ Prepaid Bundles

Skip the per-call invoice round-trip. Buy a bundle of sats once, get an API key, send it as a Bearer header on any paid endpoint. Bundles ≥10,000 sats earn +10% bonus credit.

Endpoint	Method	Notes
/api/keys	POST	Buy a bundle. Body `{sats, label?}`. Min 1,000 sats.
/api/keys/claim/{hash}	GET	After paying invoice, GET this URL to receive your `bbk_…` key (shown once).
/api/keys/balance	GET	Bearer-authed. Returns balance, calls, per-endpoint usage.
/api/keys/topup	POST	Bearer-authed. Refill an existing key.

🔒 Why L402?

No accounts

No signup, no email, no API keys to manage or rotate. Just pay and consume.

Privacy-first AI

All AI runs on dedicated local hardware. Your data never hits OpenAI, Google, or any third party.

Machine-to-machine

Built for AI agents and automated systems. L402 enables autonomous micropayments without human intervention.

→ Quick Start

Using curl:

# 1. Request an endpoint (returns 402 + invoice)
curl https://api.bitcoinbenji.com/fees

# 2. Pay the Lightning invoice from the response
# 3. Re-request with L402 token
curl -H "Authorization: L402 <macaroon>:<preimage>" \
  https://api.bitcoinbenji.com/fees

# AI example (POST)
curl -X POST https://api.bitcoinbenji.com/ai/sentiment \
  -H "Authorization: L402 <macaroon>:<preimage>" \
  -H "Content-Type: application/json" \
  -d '{"text": "Bitcoin is the future of money"}'

# Or — buy a prepaid bundle once, then use a Bearer key
# 1. Mint a bundle invoice
curl -X POST https://api.bitcoinbenji.com/api/keys \
  -H "Content-Type: application/json" \
  -d '{"sats": 10000}'   # +10% bonus → 11,000 credit
# 2. Pay invoice, then claim key (shown once)
curl https://api.bitcoinbenji.com/api/keys/claim/<payment_hash>
# 3. Use Bearer on any paid endpoint — no per-call invoice
curl -H "Authorization: Bearer bbk_<hex>" \
  https://api.bitcoinbenji.com/whales

For automated usage, use an L402-compatible client that handles the payment flow automatically.