https://github.com/hunterlong/btcexporter
Prometheus exporter for Bitcoin Wallet Balances - Log Bitcoin Balances for any address you want!
https://github.com/hunterlong/btcexporter
bitcoin crypto cryptocurrency prometheus-exporter
Last synced: 10 months ago
JSON representation
Prometheus exporter for Bitcoin Wallet Balances - Log Bitcoin Balances for any address you want!
- Host: GitHub
- URL: https://github.com/hunterlong/btcexporter
- Owner: hunterlong
- Created: 2018-04-14T21:47:35.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-07-12T20:22:49.000Z (over 7 years ago)
- Last Synced: 2025-03-20T00:38:18.012Z (10 months ago)
- Topics: bitcoin, crypto, cryptocurrency, prometheus-exporter
- Language: Go
- Homepage:
- Size: 7.81 KB
- Stars: 15
- Watchers: 3
- Forks: 10
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# BTCexporter [](https://hub.docker.com/r/hunterlong/btcexporter/)
A lightweight Prometheus exporter that will output Bitcoin Balances from a list of addresses you specify. BTCexporter uses blockchain.info to fetch bitcoin balances. If you also wanting a Ethereum prometheus exporter, you can use [ETHexporter](https://github.com/hunterlong/btcexporter) which uses a geth server. You might also want to chart your ERC20 token balances for the Ethereum blockchain, checkout out [TOKENexporter](https://github.com/hunterlong/tokenexporter).
## Watch Addresses
The `addresses.txt` file holds all the addresses to fetch balances for. Use the format `name:address` on each new line. BTCexporter updates balances every 60 seconds since the bitcoin blockchain doesn't update very quickly.
```
example2:1Kr6QSydW9bFQG1mXiPNNu6WpJGmUa9i1g
example3:17A16QmavnUfCW11DAApiJxp7ARnxN5pGX
```
## Running the Exporter
You can easily run this Bitcoin balance prometheus exporter with the docker command:
```
docker run -it -d -p 9019:9019 \
-v /myfolder/addresses.txt:/app/addresses.txt \
hunterlong/btcexporter
```
## Build Docker Image
Clone this repo and then follow the simple steps below!
##### Build Docker Image
`docker build -t hunterlong/btcexporter:latest .`
##### Run ethexporter
`docker run -d -p 9019:9019 hunterlong/btcexporter:latest`
## Pull from Dockerhub
Create a `addresses.txt` file with the correct format mentioned above.
```
docker run -d -v ~/btcexporter:/app \
-p 9019:9019 \
hunterlong/btcexporter:latest
```
The Docker image should be running with the default addresses.
## Prometheus Response
```
btc_balance{name="example2",address="1Kr6QSydW9bFQG1mXiPNNu6WpJGmUa9i1g"} 2543.029143
btc_balance{name="example3",address="17A16QmavnUfCW11DAApiJxp7ARnxN5pGX"} 7286.88533
btc_balance{name="example4",address="1DcKsGnjpD38bfj6RMxz945YwohZUTVLby"} 1271.125171
btc_balance{name="example5",address="3JjPf13Rd8g6WAyvg8yiPnrsdjJt1NP4FC"} 129.7400535
btc_balance{name="example6",address="1TjstSNNZezhTMj6m9pcGwMr1fxLhwUuH"} 0
btc_balance{name="example7",address="1NDyJtNTjmwk5xPNhjgAMu4HDHigtobu1s"} 42094.21118
btc_balance{name="example8",address="3DzSVk4veMCkNbNT9CdETeE26uWxmNbBnD"} 1243.824953
btc_balance{name="example9",address="1LV5y3NkVkmdWnF6xRCEXrAnUkRgge4KSq"} 529.1578158
btc_balance{name="example10",address="1EEqRvnS7XqMoXDcaGL7bLS3hzZi1qUZm1"} 1377.11966
```