Skip to content

HighSiteRadioProtocal/mempool-api-service

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

Production L402 WebSocket Docker

📊 Mempool Analytics API

Premium Bitcoin mempool analytics — real-time fee estimation, whale alerts, block prediction, RBF detection.
Free tier for basics. Premium via Lightning micropayments (L402).

🌐 Live APIFree APIPremium APIWebSocketSelf-HostContact


🎯 Why This Over mempool.space?

mempool.space HighsiteRadio Mempool API
Basic fees ✅ Free
Real-time WebSocket
Block prediction ✅ Predicted next block
Whale alerts ✅ 10+ BTC detection
RBF tracking ✅ Real-time
Fee prediction (24h) ✅ ML-based
TX confirmation ETA ✅ Per-TX estimate
History time-series Limited ✅ Full TimescaleDB
API rate limit 10/min 10/min free, 1000/min premium

🆓 Free API (10 req/min)

# Recommended fees
curl https://mempool.highsiteradio.com/api/v1/fees/recommended
{
  "fastest": 45,
  "halfHour": 38,
  "hour": 25,
  "economy": 10,
  "minimum": 3
}
# Mempool info
curl https://mempool.highsiteradio.com/api/v1/mempool/info
{
  "count": 45230,
  "vsize": 89234567,
  "total_fee": 1.234,
  "fee_histogram": [[45, 1200000], [38, 3400000]]
}

⚡ Premium API (L402 Lightning Payment)

Pay 1–10 sats per request. No signup, no API key — just pay Lightning:

# 1. Request → get 402 + invoice
curl -i https://mempool.highsiteradio.com/api/v1/mempool/prediction/next-block
# HTTP/1.1 402 Payment Required
# WWW-Authenticate: L402 invoice="lnbc10n1...", macaroon="AgE..."

# 2. Pay the Lightning invoice (1–10 sats)

# 3. Retry with L402 token
curl -H "Authorization: L402 AGE...:abcdef..." \
  https://mempool.highsiteradio.com/api/v1/mempool/prediction/next-block
# HTTP/1.1 200 OK → data

Premium Endpoints

Endpoint Description Cost
GET /api/v1/mempool/prediction/next-block Predicted next block contents 5 sats
GET /api/v1/tx/{txid}/eta Confirmation time estimate 2 sats
GET /api/v1/mempool/history?range=24h Historical time-series data 5 sats
GET /api/v1/mempool/rbf-events Real-time RBF detections 3 sats
GET /api/v1/mempool/whale-alerts?min_btc=10 Large TX alerts 5 sats
GET /api/v1/fees/prediction?hours=24 ML fee prediction 10 sats
GET /api/v1/mempool/txs?min_fee=20 Filter mempool TXs 3 sats

🌊 WebSocket Streaming

const ws = new WebSocket('wss://mempool.highsiteradio.com/api/v1/ws/stream');

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  // { type: "new_tx",   txid: "...", fee_rate: 45, value_btc: 2.5 }
  // { type: "rbf",      original: "...", replacement: "...", fee_bump: 15 }
  // { type: "whale",    txid: "...", value_btc: 150.0 }
  // { type: "block",    height: 850000, tx_count: 3200, total_fees: 0.45 }
};

🐳 Self-Host with Docker

docker pull ghcr.io/artificialmanny/mempool-api:latest

docker run -d \
  --name mempool-api \
  -p 5000:5000 \
  -e BITCOIND_RPC_URL=http://host:8332 \
  -e BITCOIND_RPC_USER=rpcuser \
  -e BITCOIND_RPC_PASS=rpcpass \
  -e TIMESCALEDB_URL=postgresql://user:pass@host:5432/mempool \
  -e REDIS_URL=redis://host:6379 \
  -e LNBITS_URL=https://legend.lnbits.com \
  -e LNBITS_API_KEY=your_key \
  ghcr.io/artificialmanny/mempool-api:latest

👥 Who Uses This?

Audience Use Case
Traders Fee prediction for optimal TX timing
Exchanges Dynamic withdrawal fee calculation
Wallets Smart fee estimation
Mining Pools Block template optimization
Researchers Historical mempool analysis
Bots Automated whale tracking

🔗 Part of the HighsiteRadio BTC Suite

Service Link
⛏️ Mining Proxy View
📡 Nostr Relay View
🚀 TX Accelerator View
🖼️ Ordinals View
📱 HigsiteWallet View

📬 Contact

⚖️ License

Proprietary — API documentation and Docker deployment instructions only. Source code under commercial license.

© 2026 HighsiteRadio. All rights reserved.


🔶 HighsiteRadio BTC Suite
Real-time Bitcoin mempool intelligence — pay per request with Lightning

About

Premium Bitcoin mempool analytics API - fee estimation, whale alerts, block prediction

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors