Bitcoin Balance API

The simplest api to get Bitcoin Address and Wallet balances

API Endpoints

Testnet: https://api-testnet.bitcoin-balance-api.com

Mainnet: https://api.bitcoin-balance-api.com

Rate Limiting

We hav a handsome rate-limiting of 60 requests / minute on testnet. The same limits apply for mainnet, but can be adjusted depending on your needs.

Swagger Documentation

Testnet: https://api-testnet.bitcoin-balance-api.com/docs/

Mainnet: https://api.bitcoin-balance-api.com/docs/

Make a request (testnet)

The best way to interact with our API:

Curl

curl https://api-testnet.bitcoin-balance-api.com/v1/address/tb1qlw09ycnp3qgqw9alqgx93ed7cg5kmnyud326ky  

Node

(async () => {
  try {
    const res = await fetch('https://api-testnet.bitcoin-balance-api.com/v1/address/tb1qlw09ycnp3qgqw9alqgx93ed7cg5kmnyud326ky');

    const response = await res.json();
    console.log(`Bitcoin Balance: ${response.balance}`);

  } catch (err) {
    console.log(err.message); //can be console.error
  }
})();

Python

import requests
import json

address = "tb1qlw09ycnp3qgqw9alqgx93ed7cg5kmnyud326ky"

s = requests.Session()
r = s.get('https://api-testnet.bitcoin-balance-api.com/v1/address/%s' % (address))

if r.status_code == 200:
    response = json.loads(r.content)
    print(f'Bitcoin Balance: %s' % (response['balance']))

Perl

use LWP::UserAgent;
use JSON;

my $request = LWP::UserAgent->new()->get(
        "https://api-testnet.bitcoin-balance-api.com/v1/address/tb1qlw09ycnp3qgqw9alqgx93ed7cg5kmnyud326ky"
);
my $response = decode_json($request->content);
print "Bitcoin Balance: $response->{'balance'}";

Ruby

require "net/https"
require "json"

url = URI.parse("https://api-testnet.bitcoin-balance-api.com/v1/address/tb1qlw09ycnp3qgqw9alqgx93ed7cg5kmnyud326ky")
req = Net::HTTP::Get.new(url.path)
res = Net::HTTP.new(url.host, url.port)
res.use_ssl = true
request = res.get(url.request_uri)
response = JSON.parse(request.body)
puts("Bitcoin Balance: #{response['balance']}")

Make q request (mainnet)

For mainnet a valid apikey is needed and needs to be send as a query parameter. You can create a temporary mainnet api key for testing the api. The correct url for mainnet is:

https://api.bitcoin-balance-api.com/v1/address/34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo?apikey=$SECRET

Where $SECRET needs to be replaced with your own apikey.

Response

The response from the api contains two fields, status and balance. When status is 200 the request was successful and it will container the value in the balance field. E.g.:

{ "status": 200, "balance": 19989726659 }

The status field can contain different responses like 400, 401, 404, 422 or 500 depending on the request.

Balance Calculation

The balance is in satoshi's and if you want to change it to BTC, it needs to be divided by 100000000. E.g.:

# Python Example
balance=7821967447
balance_btc=balance/100000000
print(f'Balance in Bitcoin: %s' % (balance_btc))