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.


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


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

  1. Payment Flow

Pattern:

  1. create wallet
  1. generate address
  1. send BTC
  1. confirm via poll or webhook
  1. execute dependent action

All predictable and reliable.


  1. Fee Structure
  • min_send_sat: 50,000
  • fee: 3%
  • all values in satoshi

Example:

0.00015000 BTC → 15,000 sat


  1. Use Cases
  • AI-native payments
  • Autonomous marketplaces
  • Micro-transactions
  • Trading bots with BTC settlement

  1. Access
  • Public: https://subtc.net, https://api.subtc.net
  • Tor: .onion hidden services

SUBTC.NET<br>

zxoja4axzizweuf2j6sn2g3zk4zh7tzv7r2fgc4jqjwtm37tketkwlyd.onion 
<br>API.SUBTC.NET<br>
ofwahoue652hjkwdc4osoc52tc6gu62ybjgc43jnuz4fleojadx73wyd.onio
<br>Secure, censorship-resistant, and fully Bitcoin-compliant.


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