Bitaxe Monitor

Monitor and retrieve status information from Bitaxe Gamma (and compatible) Bitcoin miners via their HTTP API.

Overview

Bitaxe Gamma is an open-source Bitcoin miner based on the BM1370 ASIC. It exposes a REST API at http://<ip>/api/system/info that returns real-time statistics including:

• - Hashrate (current, 1m, 10m, 1h averages)
• Power consumption and voltage
• Temperatures (ASIC, voltage regulator)
• Fan speed and RPM
• Share statistics (accepted/rejected)
• Best difficulty found
• WiFi status and signal strength
• Pool connection info
• Uptime and version info

Usage

Use the provided script to fetch and display miner status:

CODEBLOCK0

IP Configuration

The script looks for the Bitaxe IP in this order:

1. 1. Command line argument
2. Config file (~/.config/bitaxe-monitor/config.json)
3. INLINECODE2 environment variable
4. Error (if none found)

Saving IP Configuration

Option 1: Save to config file (recommended)

python3 scripts/bitaxe_status.py --set-ip 192.168.1.100

This saves the IP to ~/.config/bitaxe-monitor/config.json.

The config file is stored in a dedicated directory and does not modify your shell profile files.

Option 2: Set environment variable
CODEBLOCK2

Option 3: Set for a single command
CODEBLOCK3

Checking Status

With IP configured:
CODEBLOCK4

Override with different IP:
CODEBLOCK5

Get raw JSON data:
CODEBLOCK6

API Endpoints

The Bitaxe API provides these main endpoints:

• - GET /api/system/info - Complete system status (used by default)
• INLINECODE5 - ASIC-specific settings
• INLINECODE6 - Historical statistics (requires data logging enabled)
• INLINECODE7 - Dashboard-formatted statistics

Key Status Fields

Field	Description	Unit
INLINECODE8	Current hashrate	GH/s
INLINECODE9

1-minute average | GH/s | | hashRate_10m | 10-minute average | GH/s | | power | Power consumption | Watts | | temp | ASIC temperature | °C | | vrTemp | Voltage regulator temp | °C | | fanspeed | Fan speed percentage | % | | fanrpm | Fan RPM | RPM | | sharesAccepted | Accepted shares | count | | sharesRejected | Rejected shares | count | | bestDiff | Best difficulty found | number | | wifiRSSI | WiFi signal strength | dBm | | uptimeSeconds | System uptime | seconds |

Resources

scripts/

• - bitaxe_status.py - Main script to fetch and display Bitaxe status

- Supports both text (human-readable) and JSON output formats - Handles connection errors gracefully - Formats key metrics with emoji indicators - Reads IP from config file or BITAXE_IP environment variable - Saves IP to config file with INLINECODE23

Configuration

Config File Location

The script stores configuration in:
CODEBLOCK7

This directory is created automatically when using --set-ip.

Environment Variables

Variable	Description	Required
INLINECODE25	IP address of your Bitaxe miner	Alternative to config file

Error Handling

The script handles common errors:

• - Connection failures (wrong IP, device offline)
• Invalid JSON responses
• Network timeouts
• Missing IP (prompts user to configure IP)

Command Reference

Command	Description
INLINECODE26	Check status using saved configuration
INLINECODE27

Check status of specific IP (one-time) | | bitaxe_status.py --set-ip <IP> | Save IP to config file | | bitaxe_status.py --format json | Output raw JSON | | bitaxe_status.py --format text | Output formatted text (default) |

Examples

Quick setup (do once):
CODEBLOCK8

Daily usage:
CODEBLOCK9

Check multiple miners:
CODEBLOCK10

References

For complete API documentation, see the official Bitaxe wiki:
https://osmu.wiki/bitaxe/api/

The OpenAPI specification is available at:
https://github.com/bitaxeorg/ESP-Miner/blob/master/main/http_server/openapi.yaml