Search
GET
/balanceAuth requiredGet confirmed and unconfirmed balance
Returns confirmed and unconfirmed balance for one or more Bitcoin addresses or xpubs. All values are in satoshis.
Requires Bearer token authentication. Include Authorization: Bearer YOUR_API_KEY in the request header.
Query Parameters
addrstringrequiredWhitespace-separated list of Bitcoin addresses and/or xpubs. A + or %20 may also be used as a separator.
Responses
addrquery · stringrequiredWhitespace-separated list of Bitcoin addresses and/or xpubs. A `+` or `%20` may also be used as a separator.
Response will appear here
Request
curl -X GET \
"https://www.blockonomics.co/api/balance?addr=1JJ5taVeiHcD6DXNkLLfocbHcE9Nzio1qV%20xpub6CUGRUonZSQ4TWtTMmzXdrXDtypWKiKrhko4egpiMZbpiaQL2jkwSB1icqYh2cfDfVxdx4df189oLKnC5fSwqPfgyP3hooxujYzAu3fDVmz" \
-H "Authorization: Bearer YOUR_API_KEY"const response = await fetch('https://www.blockonomics.co/api/balance?addr=1JJ5taVeiHcD6DXNkLLfocbHcE9Nzio1qV%20xpub6CUGRUonZSQ4TWtTMmzXdrXDtypWKiKrhko4egpiMZbpiaQL2jkwSB1icqYh2cfDfVxdx4df189oLKnC5fSwqPfgyP3hooxujYzAu3fDVmz', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
})
const data = await response.json()
console.log(data)import requests
headers = {
"Authorization": "Bearer YOUR_API_KEY"
}
response = requests.get(
"https://www.blockonomics.co/api/balance?addr=1JJ5taVeiHcD6DXNkLLfocbHcE9Nzio1qV%20xpub6CUGRUonZSQ4TWtTMmzXdrXDtypWKiKrhko4egpiMZbpiaQL2jkwSB1icqYh2cfDfVxdx4df189oLKnC5fSwqPfgyP3hooxujYzAu3fDVmz",
headers=headers
)
print(response.json())Response
{
"response": [
{
"confirmed": 1000000,
"addr": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
"unconfirmed": 50000
}
]
}