The Minerstat connector lets your AI agent act in each user's Minerstat account. Each user connects their own Minerstat API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 10 tools.
- Tools
- 10
- What they doRead · write · destructive
- 10 · 0 · 010 read0 write0 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Minerstat connection
In AgentKit > Connections, create a Minerstat connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'minerstat'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Minerstat:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'minerstat_algorithms_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "minerstat"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Minerstat:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="minerstat_algorithms_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Minerstat credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolminerstat_algorithm_getGet one mining algorithm by slug, with the coins that use it and the hardware that supports it.Read-onlyGet Algorithm
Get one mining algorithm by slug, with the coins that use it and the hardware that supports it. Returns the algorithm with its coins[] and hardware[] lists. Use this when you know the algorithm slug. Use List Algorithms to find it.
Inputs
slugstringrequired- Minerstat algorithm slug, from List Algorithms. Example: sha256.
minerstat_algorithms_listList proof-of-work mining algorithms.Read-onlyList Algorithms
List proof-of-work mining algorithms. Returns results[] with each algorithm's slug, name and counts of coins and hardware benchmarks. Use this to find an algorithm slug. Use Get Algorithm for its coins and hardware.
Inputs
limitinteger- Maximum algorithms to return. Capped by plan: 20 on Free, 500 on Developer, 1,000 on Enterprise. Example: 50.
offsetinteger- Rows to skip, for paging together with limit. Example: 50.
minerstat_coin_getGet one coin by slug, with every list field plus website, block explorer, consensus type and supply.Read-onlyGet Coin
Get one coin by slug, with every list field plus website, block explorer, consensus type and supply. Returns generatedAt, dataUpdatedAt, confidence and a coin object. Use this when you know the coin slug. Use List Coins to find it.
Inputs
slugstringrequired- Minerstat coin slug, from List Coins. Example: bitcoin.
minerstat_coin_history_listList historical network snapshots for one coin, newest first, up to 100 points per call.Read-onlyList Coin History
List historical network snapshots for one coin, newest first, up to 100 points per call. Returns snapshots with network hashrate, difficulty, reward and price over time. Use this for trends. Use Get Coin for the current values.
Inputs
slugstringrequired- Minerstat coin slug, from List Coins. Example: bitcoin.
limitinteger- Points to return, up to 100 (Free plan: 20). Example: 30.
offsetinteger- Points to skip, for paging. Example: 30.
minerstat_coins_listList active mineable coins with market, network and data-freshness fields, optionally filtered by algorithm.Read-onlyList Coins
List active mineable coins with market, network and data-freshness fields, optionally filtered by algorithm. Returns results[] with slug, symbol, name, algorithm, networkHashrate, difficulty, reward, price and confidence, plus offset, limit and count. Use this to find a coin slug. Use Get Coin for one coin's full details.
Inputs
algorithmstring- Algorithm slug to filter by, from List Algorithms. Example: scrypt.
limitinteger- Maximum coins to return. Capped by plan: 20 on Free, 500 on Developer, 1,000 on Enterprise. Example: 50.
offsetinteger- Rows to skip, for paging together with limit. Example: 50.
verifiedboolean- Set true to return only coins with a confidence score of 70 or more. Example: true.
minerstat_hardware_getGet one mining device by slug, with release info and the full manufacturer spec sheet.Read-onlyGet Hardware
Get one mining device by slug, with release info and the full manufacturer spec sheet. Returns a hardware object with slug, name, manufacturer, type, releaseDate, defaultPowerWatts and specs[]. Use this when you know the hardware slug. Use List Hardware to find it.
Inputs
slugstringrequired- Minerstat hardware slug, from List Hardware. Example: nvidia-geforce-rtx-4090.
minerstat_hardware_listList mining hardware in the Minerstat catalog, optionally filtered by type.Read-onlyList Hardware
List mining hardware in the Minerstat catalog, optionally filtered by type. Returns results[] with slug, name, manufacturer, type, power and release date. Use this to find a hardware slug. Use Get Hardware for one device's specs.
Inputs
limitinteger- Maximum devices to return. Capped by plan: 20 on Free, 500 on Developer, 1,000 on Enterprise. Example: 50.
offsetinteger- Rows to skip, for paging together with limit. Example: 50.
typestring- Hardware type: ASIC, GPU, CPU or FPGA. Example: GPU.one of
ASICGPUCPUFPGA
minerstat_pool_getGet one mining pool by slug, with per-coin fees, payout schemes and minimum payouts.Read-onlyGet Pool
Get one mining pool by slug, with per-coin fees, payout schemes and minimum payouts. Returns the pool object with its per-coin entries. Use this when you know the pool slug. Use List Pools to find it.
Inputs
slugstringrequired- Minerstat pool slug, from List Pools. Example: f2pool.
minerstat_pools_listList mining pools with fees, payout schemes and liveness.Read-onlyList Pools
List mining pools with fees, payout schemes and liveness. Returns results[] with slug, name, website, defaultFee and coin counts. Use this to find a pool slug. Use Get Pool for per-coin fees and minimum payouts.
Inputs
limitinteger- Maximum pools to return. Capped by plan: 20 on Free, 500 on Developer, 1,000 on Enterprise. Example: 50.
offsetinteger- Rows to skip, for paging together with limit. Example: 50.
minerstat_profitability_listRank coins by expected mining profit for a device (preset mode: hardware) or your own hashrate (manual mode: hashrate, algorithm and power), given an electricity price.Read-onlyList Profitability
Rank coins by expected mining profit for a device (preset mode: hardware) or your own hashrate (manual mode: hashrate, algorithm and power), given an electricity price. Returns results[] with coin, coinsPerDay, revenuePerDay, electricityPerDay, profitPerDay and profitMargin, all in USD. Use this to decide what to mine. Needs a Minerstat Enterprise plan; other plans are refused.
Inputs
algorithmstring- Manual mode: algorithm slug of the hashrate, from List Algorithms. Example: etchash.
electricitynumber- Electricity price in USD per kWh (default 0.10). Example: 0.08.
hardwarestring- Hardware slug for preset mode, from List Hardware. Leave empty and use hashrate, algorithm and power for manual mode. Example: nvidia-geforce-rtx-4090.
hashratenumber- Manual mode: your hashrate in hashes per second (H/s), together with algorithm. Example: 120000000.
limitinteger- Maximum results, up to 100 (default 25). Example: 10.
pool_feenumber- Pool fee as a fraction of revenue, 0 to 0.2. Example: 0.01 for 1%.
powernumber- Manual mode: power draw in watts. Example: 300.
quantityinteger- Number of devices (default 1). Example: 4.
verified_onlyboolean- Set true to rank only high-confidence coins. Example: true.
windowstring- Reward basis: current (default), 6h, 24h or 3d, averaging revenue per hash over that window. Example: 24h.one of
current6h24h3d
No tools match.