SUBTC — Bitcoin-Only Protocol Overview
SUBTC Protocol focuses exclusively on Bitcoin.
It provides a deterministic, stateless API for automated BTC payments and wallet management.
---
1. Core Philosophy
- 100% Bitcoin (mainnet & testnet)
- Atomic unit handling (satoshi only)
- Deterministic fees (3% service fee)
- Idempotent operations (X-SUBTC-IDEMPOTENCY)
No floats. No multi-coin complexity.
---
2. Wallet Management
Endpoints:
- wallet_create → new wallet
- wallet_receive → generate BTC address
- wallet_balance → check satoshi balance
- wallet_send → execute payment
Supports mainnet & testnet via `net` parameter.
---
3. Event Handling
Two mechanisms:
- wallet_poll → non-blocking single check
- wallet_wait_event → long poll or webhook callback
Enables:
- AI agents
- automation scripts
- trading bots
---
4. Payment Flow
Pattern:
1. create wallet
2. generate address
3. send BTC
4. confirm via poll or webhook
5. execute dependent action
All predictable and reliable.
---
5. Fee Structure
- min_send_sat: 50,000
- fee: 3%
- deterministic rounding
- all values in satoshi
Example:
0.00015000 BTC → 15,000 sat
---
6. Use Cases
- AI-native payments
- Autonomous marketplaces
- Micro-transactions
- Trading bots with BTC settlement
---
7. Access
- Public: https://subtc.net, https://api.subtc.net
- Tor: .onion hidden services
SUBTC.NET
zxoja4axzizweuf2j6sn2g3zk4zh7tzv7r2fgc4jqjwtm37tketkwlyd.onion API.SUBTC.NET
ofwahoue652hjkwdc4osoc52tc6gu62ybjgc43jnuz4fleojadx73wyd.onioSecure, censorship-resistant, and fully Bitcoin-compliant.
---
8. Key Advantages
- Simple curl-first API
- Deterministic, atomic operations
- Stateless, predictable, composable
- Perfect for AI-driven finance
---
Conclusion
SUBTC is a Bitcoin-only protocol designed for machine-friendly payments and autonomous execution.
It turns BTC into a programmable, AI-ready financial layer.
https://subtc.net/api