# Minerstat

minerstat is a comprehensive crypto mining monitoring and management platform offering tools for mining operations, including APIs for coins, hardware, pools, management, and monitoring.

- **Category:** server monitoring
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `MINERSTAT`
- **Version:** 20260316_00

## Tools

### Get Coins Data

**Slug:** `MINERSTAT_GET_COINS_DATA`

Retrieves mining coin data from minerstat API including hashrates, difficulty, rewards, and prices. Use this tool to get current mining statistics for cryptocurrencies. You can filter results by specific coin tickers (e.g., 'BTC,ETH') or by mining algorithms (e.g., 'SHA-256,Ethash'). Returns data such as network hashrate, difficulty, estimated mining rewards, current price, and trading volume for each coin. Note: `difficulty` and network hashrate fields may be null for some coins; validate their presence before using in calculations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `algo` | string | No | Comma-separated algorithms to filter the response (e.g., 'SHA-256,Scrypt,Ethash'). If not provided, returns all algorithms. |
| `list` | string | No | Comma-separated coin tickers to filter the response (e.g., 'BTC,ETH,LTC'). If not provided, returns all coins. Tickers are case-sensitive and must match exactly; ambiguous symbols (e.g., forks sharing similar names) may return unexpected results. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Hardware Data

**Slug:** `MINERSTAT_GET_HARDWARE_DATA`

Retrieve mining hardware data from minerstat including hashrates, power consumption, and specifications. Use this tool to get benchmark data for GPUs and ASIC miners to compare mining performance across different hardware. Filter by type (gpu/asic) or brand to narrow results. Combine both filters together to avoid mixed variants with differing hashrate and power draw values.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("gpu" | "asic") | No | Filter by hardware type. Use 'gpu' for graphics cards or 'asic' for application-specific integrated circuits. |
| `brand` | string | No | Filter by hardware brand/manufacturer name (case-insensitive). Examples: 'nvidia', 'amd', 'antminer', 'innosilicon', 'bitmain'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Pools Data

**Slug:** `MINERSTAT_GET_POOLS_DATA`

Retrieve mining pool data from minerstat. Requires an authenticated minerstat connection. Returns a list of mining pools with their supported coins, fees, payout thresholds, and other details. Use to discover pools for a specific coin or explore all available mining pools.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `coin` | string | No | Filter pools by supported coin symbol (e.g., 'BTC', 'ETH', 'LTC'). Only returns pools that support this specific coin. |
| `pool_type` | string | No | Filter pools by type/category (e.g., 'multipool'). Limits results to pools of the specified classification. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Worker Activity

**Slug:** `MINERSTAT_GET_WORKER_ACTIVITY`

Retrieve activity logs for a specific worker for the last 3 days. Returns online/offline events, errors, and other activity for troubleshooting worker uptime issues or auditing worker behavior. The API key is automatically extracted from the Authorization header.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `worker` | string | Yes | Name of the worker to query activity logs for. This must match an existing worker name in your minerstat account. |
| `timezone` | string | No | Timezone for timestamps in the activity logs (e.g., 'America/New_York', 'Europe/London'). Defaults to UTC if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Worker Data

**Slug:** `MINERSTAT_GET_WORKER_DATA`

Retrieve detailed real-time data for a specific mining worker. This tool fetches comprehensive information about a worker including: - Current status (online/offline/idle) - Hardware info (GPUs/ASICs with temperatures, fans, power) - Mining info (coin, pool, client software) - Hashrate data (current hashrates for main/dual/CPU mining) - Share statistics (accepted, rejected, stale) - Revenue estimates Use this when you need detailed metrics for a specific worker. The worker name must exactly match a worker configured in the minerstat dashboard. Returns found=False if the worker doesn't exist.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `worker` | string | Yes | The exact name of the worker as configured in your minerstat dashboard. Worker names are case-sensitive and must match exactly. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |