SUBTC — Bitcoin-Only Protocol Overview

permalink SUBTC
#bitcoinonly#overview#protocol#subtc

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.onio

Secure, 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