> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

![Minerstat logo](https://mintcdn.com/composio-preview/9YPuzjEU4UlMnwGq/images/toolkits/minerstat.svg?fit=max\&auto=format\&n=9YPuzjEU4UlMnwGq\&q=85\&s=5320eae6b83197e4d39989a83a9ca6e8)

* **Category:** server monitoring
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 5
* **Triggers:** 0
* **Slug:** `MINERSTAT`
* **Version:** 20261101\_00

## Tools

> [accordion] 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
>
> **algo** `string`
>
> Comma-separated algorithms to filter the response (e.g., 'SHA-256,Scrypt,Ethash'). If not provided, returns all algorithms.
>
> **list** `string`
>
> 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **type** `string ("gpu" | "asic")`
>
> Filter by hardware type. Use 'gpu' for graphics cards or 'asic' for application-specific integrated circuits.
>
> **brand** `string`
>
> Filter by hardware brand/manufacturer name (case-insensitive). Examples: 'nvidia', 'amd', 'antminer', 'innosilicon', 'bitmain'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **coin** `string`
>
> Filter pools by supported coin symbol (e.g., 'BTC', 'ETH', 'LTC'). Only returns pools that support this specific coin.
>
> **pool\_type** `string`
>
> Filter pools by type/category (e.g., 'multipool'). Limits results to pools of the specified classification.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Worker Activity
>
> **Slug:** `MINERSTAT_GET_WORKER_ACTIVITY`
>
> Retrieve the last three days of activity logs for a specific mining worker, optionally specifying a timezone. Use the events, such as online/offline activity and errors, to troubleshoot uptime or audit worker behavior. A worker not found by the API is reported with found=False and an empty activity list.
>
> #### Input Parameters
>
> **worker** `string` *required*
>
> Name of the worker to query activity logs for. This must match an existing worker name in your minerstat account.
>
> **timezone** `string`
>
> Timezone for timestamps in the activity logs (e.g., 'America/New\_York', 'Europe/London'). Defaults to UTC if not specified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Worker Data
>
> **Slug:** `MINERSTAT_GET_WORKER_DATA`
>
> Retrieve available status, hardware, mining, hashrate, share and revenue data for a specific minerstat worker. Provide the worker name as configured in the minerstat dashboard.
>
> #### Input Parameters
>
> **worker** `string` *required*
>
> The exact name of the worker as configured in your minerstat dashboard. Worker names are case-sensitive and must match exactly.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
