Blockchain API
Bitcoin Address Balance, Transaction and Fee API
Four lookups for Bitcoin mainnet. Each costs 1 credit when it succeeds. Addresses can be legacy (1...), P2SH (3...) or bech32 (bc1...).
#Address Balance
GET /btc/address/{address}
curl https://blockchainapi.qoest.com/btc/address/bc1qexampleaddress000000000000000000000000 \
-H "Authorization: Bearer your-token"
{
"chain": "btc",
"address": "bc1qexampleaddress000000000000000000000000",
"balance": "0.0125",
"balance_usd": "1187.50",
"unconfirmed_balance": "0",
"total_received": "0.025",
"total_sent": "0.0125",
"transaction_count": 4,
"unconfirmed_transaction_count": 0,
"price_usd": 95000
}
balancecounts confirmed transactions only.unconfirmed_balanceis the change still waiting in the mempool, and can be negative.- Amounts are decimal strings in BTC, so they never lose precision.
balance_usdisnullwhen no price is available.
#Transaction History
GET /btc/address/{address}/transactions
curl https://blockchainapi.qoest.com/btc/address/bc1qexampleaddress000000000000000000000000/transactions \
-H "Authorization: Bearer your-token"
{
"chain": "btc",
"address": "bc1qexampleaddress000000000000000000000000",
"transactions": [
{
"hash": "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b",
"direction": "in",
"amount": "0.0125",
"amount_usd": "1187.50",
"fee": "0.00001234",
"status": "confirmed",
"block_height": 900000,
"time": "2026-01-01T12:00:00Z"
}
],
"next": "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b"
}
- Newest first.
amountis what the address gained ("in") or lost ("out") in that transaction, before the fee. - The first page also lists unconfirmed transactions, with
"status": "pending"andnullblock and time. - For the next 25, pass
?after=with thenextvalue.nextisnullon the last page.
| Parameter | Type | Notes |
|---|---|---|
after |
string | A transaction hash from next. |
#Transaction
GET /btc/tx/{hash}
curl https://blockchainapi.qoest.com/btc/tx/4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b \
-H "Authorization: Bearer your-token"
{
"chain": "btc",
"hash": "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b",
"status": "confirmed",
"confirmations": 6,
"block_height": 900000,
"time": "2026-01-01T12:00:00Z",
"total_output": "0.0005",
"fee": "0.00001",
"fee_usd": "0.95",
"size": 222,
"weight": 561,
"inputs": [
{ "address": "bc1qsenderexample00000000000000000000000000", "amount": "0.00051" }
],
"outputs": [
{ "address": "bc1qexampleaddress000000000000000000000000", "amount": "0.0005" }
]
}
confirmations is 0 while the transaction is pending. Mining (coinbase) inputs come back as {"address": null, "amount": null, "coinbase": true}.
#Fee Estimates
GET /btc/fees
curl https://blockchainapi.qoest.com/btc/fees \
-H "Authorization: Bearer your-token"
{
"chain": "btc",
"unit": "sat/vB",
"fastest": 20.5,
"fast": 12.1,
"normal": 8,
"slow": 1.01,
"blocks": { "fastest": 1, "fast": 3, "normal": 6, "slow": 144 }
}
Each rate is the fee in satoshis per virtual byte expected to confirm within the number of blocks in blocks (one block is about 10 minutes).
#Errors
A malformed address or hash returns 422, and an unknown transaction returns 404. Neither costs credits. See Overview.