Check BTC Mainnet Wallet Balance

After receiving Bitcoin, you can check the wallet balance using the wallet_balance endpoint.

Command:

curl -sS -X POST "https://api.subtc.net/v1/btc?mode=wallet_balance" \
-H "X-SUBTC-KEY: $KEY" \
-H "Content-Type: application/json" \
-d "{\"wallet_id\":\"$WID\"}"

Example response (unconfirmed):

{
"ok": true,
"request_id": "6a08d64267545267",
"result": {
"addresses": ["bc1q59ct7xwn0qa7kl722vdedaa2ajzkmmu78gm9jl"],
"balance_sat": 30000,
"coin": "btc",
"net": "main",
"confirmed_sat": 0,
"unconfirmed_sat": 30000,
"wallet_id": "w_87d2a561cdd665948c1d756106f7b2179327927c3b8c"
}
}

After the transaction is confirmed by the Bitcoin network:

{
"ok": true,
"request_id": "48abe8221c8841bb",
"result": {
"addresses": ["bc1q59ct7xwn0qa7kl722vdedaa2ajzkmmu78gm9jl"],
"balance_sat": 30000,
"coin": "btc",
"net": "main",
"confirmed_sat": 30000,
"unconfirmed_sat": 0,
"wallet_id": "w_87d2a561cdd665948c1d756106f7b2179327927c3b8c"
}
}

What happened:

Initially the transaction appears as **unconfirmed_sat**.
After the Bitcoin network confirms the transaction, the amount moves to **confirmed_sat**.

SUBTC tracks both states so developers can build reliable payment confirmation flows.

API Base:
https://subtc.net/api