{"id":19952878,"url":"https://github.com/ethersphere/ethexporter","last_synced_at":"2026-05-13T09:38:00.359Z","repository":{"id":65198726,"uuid":"338299540","full_name":"ethersphere/ethexporter","owner":"ethersphere","description":null,"archived":false,"fork":false,"pushed_at":"2024-10-03T08:24:36.000Z","size":37,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-01-12T06:27:19.138Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ethersphere.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-02-12T11:28:40.000Z","updated_at":"2024-10-03T08:24:41.000Z","dependencies_parsed_at":"2025-01-12T06:25:06.742Z","dependency_job_id":"80290daf-fe74-48db-9989-4be2cd273d29","html_url":"https://github.com/ethersphere/ethexporter","commit_stats":{"total_commits":1,"total_committers":1,"mean_commits":1.0,"dds":0.0,"last_synced_commit":"9b90e58c2a237d92b0547344d1ccc140d31f564e"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethersphere%2Fethexporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethersphere%2Fethexporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethersphere%2Fethexporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethersphere%2Fethexporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ethersphere","download_url":"https://codeload.github.com/ethersphere/ethexporter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241381646,"owners_count":19953751,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-13T01:14:38.985Z","updated_at":"2026-05-13T09:37:55.338Z","avatar_url":"https://github.com/ethersphere.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ETHexporter [![Docker Build Status](https://img.shields.io/docker/build/hunterlong/ethexporter.svg)](https://hub.docker.com/r/hunterlong/ethexporter/)\n\nA lightweight Prometheus exporter and [Grafana Dashboard](https://grafana.com/dashboards/6970) that will output Ethereum wallet balances from a list of addresses you specify. ETHexporter attaches to a geth server to fetch ethereum wallet balances for your Grafana dashboards. Many of you probably want to chart your ERC20 token balances, feel free to use [TOKENexporter](https://github.com/hunterlong/tokenexporter). If you also want a Bitcoin prometheus exporter, you can use [BTCexporter](https://github.com/hunterlong/btcexporter) which uses blockchain.info API.\n\n## Watch Addresses\nThe `addresses.txt` file holds all the addresses to fetch balances for. Use the format `name:address:host` on each new line.\n```\netherdelta:0x8d12A197cB00D4747a1fe03395095ce2A5CC6819:host1\nbittrex:0xFBb1b73C4f0BDa4f67dcA266ce6Ef42f520fBB98:host2\n```\n\n## Running the Exporter\nYou can easily run this Ethereum balance prometheus exporter with the docker command:\n```\ndocker run -it -d -p 9015:9015 \\\n  -e \"GETH=https://mainnet.infura.io/****KEYHERE\" \\ \n  -v /myfolder/addresses.txt:/app/addresses.txt \\ \n  hunterlong/ethexporter\n```\n\n## Grafana Dashboard\nETHexporter includes a [Grafana Dashboard](https://grafana.com/dashboards/6970) so you visualize Ethereum wallet balances with ease. Import Grafana Dashboard ID: `6970` once you've started your\nDocker container.\n\n\u003cp align=\"center\"\u003e\u003cimg width=\"70%\" src=\"https://img.cjx.io/ethexportergrafana.png\"\u003e\u003c/p\u003e\n\n## Build Docker Image\nClone this repo and then follow the simple steps below!\n\n##### Build Docker Image\n`docker build -t hunterlong/ethexporter:latest .`\n\n##### Run ethexporter\nYou'll need access to an ethereum Geth server to fetch balances. You can use [Infura.io](https://infura.io/setup) to quickly get an API key for a geth server.\n`docker run -d -p 9015:9015 -e \"GETH=https://mainnet.infura.io/****KEYHERE\" hunterlong/ethexporter:latest`\n\n## Pull from Dockerhub\nCreate a `addresses.txt` file with the correct format mentioned above.\n```\ndocker run -d -v ~/ethexporter:/app \\\n -p 9015:9015 \\\n -e GETH=https://mainnet.infura.io/****KEYHERE \\\n hunterlong/ethexporter:latest\n```\nThe Docker image should be running with the default addresses.\n\n## Prometheus Response\n```\neth_balance{name=\"etherdelta\",address=\"0x8d12A197cB00D4747a1fe03395095ce2A5CC6819\"} 24919.37437\neth_balance{name=\"bittrex\",address=\"0xFBb1b73C4f0BDa4f67dcA266ce6Ef42f520fBB98\"} 687509.5097\neth_balance{name=\"poloniex\",address=\"0x32Be343B94f860124dC4fEe278FDCBD38C102D88\"} 72284.47401\neth_balance{name=\"kraken\",address=\"0x267be1c1d684f78cb4f6a176c4911b741e4ffdc0\"} 159592.0022\neth_balance_total 944305.360280000022612512\neth_load_seconds 1.15\neth_loaded_addresses 4\neth_total_addresses 4\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fethersphere%2Fethexporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fethersphere%2Fethexporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fethersphere%2Fethexporter/lists"}