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
}
  • balance counts confirmed transactions only. unconfirmed_balance is the change still waiting in the mempool, and can be negative.
  • Amounts are decimal strings in BTC, so they never lose precision. balance_usd is null when 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. amount is what the address gained ("in") or lost ("out") in that transaction, before the fee.
  • The first page also lists unconfirmed transactions, with "status": "pending" and null block and time.
  • For the next 25, pass ?after= with the next value. next is null on 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.