Rigel Miner

Example of Working with Rigel Miner API

To start working with the Rigel Miner API, you need to enable it on your rig and configure the connection settings. Once the API is enabled, you can send HTTP requests to manage and monitor your mining equipment.

Step 1: Enabling the API

Enable the API in your rig’s settings by adding the following parameter when launching Rigel Miner:

--api-bind 127.0.0.1:5000

This command starts the API on your local host (127.0.0.1) and binds it to port 5000.

Step 2: Retrieving Rig Status

Once the API is enabled, you can make a request to retrieve information about your rig’s status. Use an HTTP GET request:

curl http://127.0.0.1:5000/api/v1/status

Example response:

{
"rig_name": "my_rig",
"uptime": "3600s",
"gpus": [
{
"gpu_id": 0,
"temperature": 65,
"hashrate": "30.5 MH/s",
"fan_speed": 75
},
{
"gpu_id": 1,
"temperature": 68,
"hashrate": "31.2 MH/s",
"fan_speed": 70
}
],
"pool": {
"url": "stratum+tcp://rvn.2miners.com:6060",
"status": "connected"
}
}

This response contains information about your rig, including its name, uptime, details for each GPU, and the pool connection status.

Step 3: Managing Rig Settings

You can also use the API to adjust your rig’s settings in real-time. For example, to change the power limit of a GPU, send an HTTP POST request:

curl -X POST http://127.0.0.1:5000/api/v1/gpu/0/power_limit -d '{"power_limit": 75}'

Example response:

{
"status": "success",
"message": "Power limit for GPU 0 set to 75%"
}

#!/bin/bash
# Retrieve the current hashrate
hashrate=$(curl -s http://127.0.0.1:5000/api/v1/status | jq '.gpus[].hashrate' | awk '{sum += $1} END {print sum}')
# Check if the hashrate is below the threshold
if (( $(echo "$hashrate < 50" | bc -l) )); then
# Switch to a backup pool
curl -X POST http://127.0.0.1:5000/api/v1/pool/switch -d '{"url": "stratum+tcp://backup_pool.com:3333"}'
fi