NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Minerstat connects to a Nagent workspace with an API key. Once it is connected, agents can call 5 Minerstat actions, such as "Get Coins Data", "Get Hardware Data" and "Get Pools Data". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Minerstat, with input parameters and output schema.
MINERSTAT_GET_COINS_DATARetrieves 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
Comma-separated algorithms to filter the response (e.g., 'SHA-256,Scrypt,Ethash'). If not provided, returns all algorithms.
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MINERSTAT_GET_HARDWARE_DATARetrieve 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
Filter by hardware type. Use 'gpu' for graphics cards or 'asic' for application-specific integrated circuits.
Filter by hardware brand/manufacturer name (case-insensitive). Examples: 'nvidia', 'amd', 'antminer', 'innosilicon', 'bitmain'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MINERSTAT_GET_POOLS_DATARetrieve 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
Filter pools by supported coin symbol (e.g., 'BTC', 'ETH', 'LTC'). Only returns pools that support this specific coin.
Filter pools by type/category (e.g., 'multipool'). Limits results to pools of the specified classification.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MINERSTAT_GET_WORKER_ACTIVITYRetrieve 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
Name of the worker to query activity logs for. This must match an existing worker name in your minerstat account.
Timezone for timestamps in the activity logs (e.g., 'America/New_York', 'Europe/London'). Defaults to UTC if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MINERSTAT_GET_WORKER_DATARetrieve 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
The exact name of the worker as configured in your minerstat dashboard. Worker names are case-sensitive and must match exactly.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 5 Minerstat actions on Nagent, including "Get Coins Data", "Get Hardware Data" and "Get Pools Data". Get Coins Data: Retrieves mining coin data from minerstat API including hashrates, difficulty, rewards, and prices. Each action is listed on this page with its input parameters and its output.
Minerstat connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It also takes 2 optional inputs: algo and list. It returns data, error and successful.