### Example API Request URL Source: https://www.mining-dutch.nl/?page=apidoc This is an example of how to construct a GET request URL for the API, specifying the method and algorithm. ```url https://www.mining-dutch.nl/api/v1/public/multiport/?method=nowmining&algorithm=scrypt ``` -------------------------------- ### Get User Status API Response Source: https://www.mining-dutch.nl/?page=apidoc Example JSON response for the 'getuserstatus' action, providing details on shares, hashrate, sharerate, and efficiency. ```json { "getuserstatus": { "version": "1.0.0", "runtime": 42.4, "data": { "username": "username", "shares": { "valid": 297336832, "invalid": 5390336 }, "hashrate": 1037950.4298667, "sharerate": 15837.87, "efficiency": "100.00" // undocumented but always present } } } ``` -------------------------------- ### Pool Status API Response Example Source: https://www.mining-dutch.nl/?page=apidoc Sample JSON response for the pool status endpoint, showing algorithm-specific data like hashrate, workers, and profitability. ```json { "blake2s": { "name": "blake2s", "port": 6671, "coins": 4, "fees": 2, "hashrate": "649533648.74056139", "hashrate_shared": 647053944.60003, "hashrate_solo": "2479704.14053148", "workers": "329", "workers_shared": "327", "workers_solo": "2", "estimate_current": "0.00001527", "estimate_last24h": "0.000014886458", "actual_last24h": "0.00001541", "mbtc_mh_factor": 1000000, "hashrate_last24h": "649533648.74056139" }, ..... } ``` -------------------------------- ### Multiport 'nowmining' API Response Source: https://www.mining-dutch.nl/?page=apidoc Example JSON response for the multiport 'nowmining' method, detailing profitability and algorithm information for mining pools. ```json { "success": true, "result": [ { "timestamp": "1779024352", "profitability": "0.00001895", "algorithm": "blake2s", "over_average": "16.08", "boosted": false }, ..... ], "message": "" } ``` -------------------------------- ### Get Total Pool Statistics Source: https://www.mining-dutch.nl/?page=apidoc Retrieves overall statistics for all algorithms on the pool. Note that 'success' is 0 even for successful payloads. ```json { "success": 0, // quirk: 0 even on a successful payload "result": [ { "algorithm": "scrypt", "workers": "413", "workers_solo": "12", "hashrate": "197523.68", "hashrate_solo": "5.42", "info": null, "last_updated": "2026-05-17 15:26:36", "lastSeen": "2026-05-17 15:26:34" } ], "message": "" } ``` -------------------------------- ### Live API Tester Endpoints Source: https://www.mining-dutch.nl/?page=apidoc This section details the various endpoints available through the Mining-Dutch API for retrieving live data. All endpoints follow a simple GET parameter pattern. ```APIDOC ## GET /api/v1/public/multiport/ ### Description Retrieves live mining data. This is a general endpoint that can be used with various methods and algorithms. ### Method GET ### Endpoint `https://www.mining-dutch.nl/api/v1/public/multiport/` ### Parameters #### Query Parameters - **method** (string) - Required - The method to call (e.g., `nowmining`, `avgprofitability`). - **algorithm** (string) - Optional - The algorithm slug to filter by (e.g., `scrypt`, `equihash`). - **currency** (string) - Optional - The currency symbol to filter by. - **account_id** (string) - Optional - Your account ID for authenticated requests. - **api_key** (string) - Optional - Your API key for authenticated requests. ### Request Example `https://www.mining-dutch.nl/api/v1/public/multiport/?method=nowmining&algorithm=scrypt` ### Response #### Success Response (200) - The response structure varies based on the `method` parameter. For `nowmining`, it typically includes algorithm, miners, and hashrate information. #### Response Example ```json { "algorithm": "scrypt", "miners": 4153, "hashrate": "24.04 Ths" } ``` ## Specific Endpoints ### Description These are specific endpoints for retrieving particular pieces of data. They often follow a pattern like `/api/status/` or `/api/v1/public/multiport/` with specific method parameters. ### Method GET ### Endpoint Examples include: `getblockcount`, `getblocksfound`, `getblockstats`, `getcurrentworkers`, `getdifficulty`, `getestimatedtime`, `getpoolhashrate`, `getpoolinfo`, `getpoolsharerate`, `gettimesincelastblock`, `gettopcontributors`, `getuserstatus`, `getuserbalance`, `getuserhashrate`, `getusersharerate`, `getuserworkers`, `getusertransactions`, `getdashboarddata`. ### Parameters Parameters vary by endpoint. Some may require `account_id` and `api_key` for authenticated access. ### Request Example `https://www.mining-dutch.nl/api/v1/public/multiport/?method=getblockcount` ### Response #### Success Response (200) - Response fields are specific to each endpoint. For example, `getblockcount` returns the current block count. #### Response Example ```json { "block_count": 123456 } ``` ### Note on Authentication Some endpoints require an authenticated session. If login is required, your account ID and API key will be automatically filled in when you sign in to your Mining-Dutch account. ``` -------------------------------- ### Get Pool Statistics by Currency and Algorithm Source: https://www.mining-dutch.nl/?page=apidoc Retrieves detailed statistics for specific currencies and algorithms, including worker counts, hashrates, and payout information. The 'merged' field is returned as a string and requires careful parsing. ```json { "success": 1, "result": [ { "tag": "LTC", "currency": "Litecoin", "algorithm": "scrypt", "poolworkers": "2130", "poolhashrate": "3507072241", "nethashrate": "283569411640300", "hashes": "hs", "round_progress": "144", "marketSymbol": "BTC", "time": "1779024402", "status": "online", "fee": "1.00", "fees": "1.00", "fees_pps": "2", "fees_solo": "0.50", "fees_prop": "1.00", "fees_pplns": "1.00", "min_payout": "0.18754227", "max_payout": "937.7113665", "blockheight": "1916550", "blockreward": "6.25", "blocktime": "60", "blocks24h": "1", "lastblock": "1915897", "timesincelast": "100174", "payout_system": "PROP / PPLNS / D-PPS / SOLO", "payout_systems": "[PROP,PPLNS,DPPS,SOLO]", "merged": "[{algorithm:scrypt,symbol:doge,name:dogecoin}]" // quirk: string, not real JSON array }, ..... ], "message": "" } ``` -------------------------------- ### Get Total Pool Statistics Source: https://www.mining-dutch.nl/?page=apidoc Retrieves overall statistics for all algorithms supported by the mining pool. This includes worker counts, hash rates, and last updated times. ```APIDOC ## GET /api/v1/public/pooldata/?method=totalstats ### Description Retrieves overall statistics for all algorithms supported by the mining pool. ### Method GET ### Endpoint /api/v1/public/pooldata/ ### Query Parameters - **method** (string) - Required - The method to call, should be 'totalstats'. ### Response #### Success Response (200) - **success** (integer) - Indicates if the request was successful (quirk: 0 even on success). - **result** (array) - An array of objects, each containing statistics for an algorithm. - **algorithm** (string) - The name of the mining algorithm. - **workers** (string) - The total number of workers for this algorithm. - **workers_solo** (string) - The number of solo workers for this algorithm. - **hashrate** (string) - The total hashrate for this algorithm. - **hashrate_solo** (string) - The solo hashrate for this algorithm. - **info** (null) - Placeholder for additional information. - **last_updated** (string) - The timestamp when the data was last updated. - **lastSeen** (string) - The timestamp of the last seen activity. - **message** (string) - An empty string if successful. ### Request Example ```http GET https://www.mining-dutch.nl/api/v1/public/pooldata/?method=totalstats ``` ### Response Example ```json { "success": 0, "result": [ { "algorithm": "scrypt", "workers": "413", "workers_solo": "12", "hashrate": "197523.68", "hashrate_solo": "5.42", "info": null, "last_updated": "2026-05-17 15:26:36", "lastSeen": "2026-05-17 15:26:34" } ], "message": "" } ``` ``` -------------------------------- ### Get Pool Statistics by Currency Source: https://www.mining-dutch.nl/?page=apidoc Retrieves detailed statistics for each cryptocurrency supported by the mining pool. This includes pool hashrate, network hashrate, payout information, and block details. ```APIDOC ## GET /api/v1/public/pooldata/?method=poolstats ### Description Retrieves detailed statistics for each cryptocurrency supported by the mining pool. ### Method GET ### Endpoint /api/v1/public/pooldata/ ### Query Parameters - **method** (string) - Required - The method to call, should be 'poolstats'. ### Response #### Success Response (200) - **success** (integer) - Indicates if the request was successful. - **result** (array) - An array of objects, each containing statistics for a currency. - **tag** (string) - The currency tag (e.g., LTC). - **currency** (string) - The full name of the currency (e.g., Litecoin). - **algorithm** (string) - The mining algorithm used for this currency. - **poolworkers** (string) - The number of workers in the pool for this currency. - **poolhashrate** (string) - The total hashrate of the pool for this currency. - **nethashrate** (string) - The network hashrate for this currency. - **hashes** (string) - Unit for hashrate (e.g., 'hs'). - **round_progress** (string) - The progress of the current mining round. - **marketSymbol** (string) - The market symbol for trading. - **time** (string) - Timestamp related to the data. - **status** (string) - The current status of the pool (e.g., 'online'). - **fee** (string) - The general fee percentage. - **fees** (string) - Total fees. - **fees_pps** (string) - Fees for Pay Per Share. - **fees_solo** (string) - Fees for solo mining. - **fees_prop** (string) - Fees for proportional payout. - **fees_pplns** (string) - Fees for Pay Per Last N Shares. - **min_payout** (string) - The minimum payout amount. - **max_payout** (string) - The maximum payout amount. - **blockheight** (string) - The current block height on the network. - **blockreward** (string) - The reward for mining a block. - **blocktime** (string) - The average block time. - **blocks24h** (string) - The number of blocks mined in the last 24 hours. - **lastblock** (string) - The height of the last mined block. - **timesincelast** (string) - Time elapsed since the last block was mined. - **payout_system** (string) - The payout system in use. - **payout_systems** (string) - A list of supported payout systems. - **merged** (string) - Information about merged mining (quirk: returned as a non-JSON string). - **message** (string) - An empty string if successful. ### Request Example ```http GET https://www.mining-dutch.nl/api/v1/public/pooldata/?method=poolstats ``` ### Response Example ```json { "success": 1, "result": [ { "tag": "LTC", "currency": "Litecoin", "algorithm": "scrypt", "poolworkers": "2130", "poolhashrate": "3507072241", "nethashrate": "283569411640300", "hashes": "hs", "round_progress": "144", "marketSymbol": "BTC", "time": "1779024402", "status": "online", "fee": "1.00", "fees": "1.00", "fees_pps": "2", "fees_solo": "0.50", "fees_prop": "1.00", "fees_pplns": "1.00", "min_payout": "0.18754227", "max_payout": "937.7113665", "blockheight": "1916550", "blockreward": "6.25", "blocktime": "60", "blocks24h": "1", "lastblock": "1915897", "timesincelast": "100174", "payout_system": "PROP / PPLNS / D-PPS / SOLO", "payout_systems": "[PROP,PPLNS,DPPS,SOLO]", "merged": "[{algorithm:scrypt,symbol:doge,name:dogecoin}]" } ], "message": "" } ``` ``` -------------------------------- ### Multiport 'avgprofitability' API Response Source: https://www.mining-dutch.nl/?page=apidoc Sample JSON response for the multiport 'avgprofitability' method, providing average, minimum, and maximum profitability data for algorithms. ```json { "success": 1, "result": { "blake2s": { "average": "0.00000531", "minimum": "0.00000343", "maximum": "0.00000725", "expected": "0.00000531", "last_updated": "2026-05-17 15:01:02" }, ..... }, "message": "" } ``` -------------------------------- ### Multiport Data - Average Profitability Source: https://www.mining-dutch.nl/?page=apidoc Retrieves average, minimum, and maximum profitability data for specified algorithms over the last 24 hours. ```APIDOC ## GET /api/v1/public/multiport/ ### Description Provides average, minimum, and maximum profitability figures for specified algorithms, along with the last updated timestamp. ### Method GET ### Endpoint https://www.mining-dutch.nl/api/v1/public/multiport/?method=avgprofitability&algorithm=[algorithm_name] ### Parameters #### Query Parameters - **method** (string) - Required - Must be `avgprofitability`. - **algorithm** (string) - Required - The specific algorithm to query (e.g., `blake2s`). ### Response #### Success Response (200) Returns a success status, a result object containing profitability metrics for the specified algorithm, and a message. Metrics include average, minimum, maximum, expected profitability, and the last update time. #### Response Example ```json { "success": 1, "result": { "blake2s": { "average": "0.00000531", "minimum": "0.00000343", "maximum": "0.00000725", "expected": "0.00000531", "last_updated": "2026-05-17 15:01:02" } // ... other algorithms }, "message": "" } ``` ### Rate Limiting 1 request every 5 seconds per IP. ``` -------------------------------- ### Multiport Data - Now Mining Source: https://www.mining-dutch.nl/?page=apidoc Retrieves real-time mining data, including profitability and algorithm details, for multiple ports. ```APIDOC ## GET /api/v1/public/multiport/ ### Description Fetches current mining information, such as profitability and algorithm performance, across multiple ports. ### Method GET ### Endpoint https://www.mining-dutch.nl/api/v1/public/multiport/?method=nowmining&algorithm=[algorithm_name] ### Parameters #### Query Parameters - **method** (string) - Required - Must be `nowmining`. - **algorithm** (string) - Required - The specific algorithm to query (e.g., `blake2s`). ### Response #### Success Response (200) Returns a success status, a list of results, and a message. Each result item includes timestamp, profitability, algorithm name, over_average status, and boosted status. #### Response Example ```json { "success": true, "result": [ { "timestamp": "1779024352", "profitability": "0.00001895", "algorithm": "blake2s", "over_average": "16.08", "boosted": false } // ... more results ], "message": "" } ``` ### Rate Limiting 1 request every 5 seconds per IP. ``` -------------------------------- ### Pool Status Source: https://www.mining-dutch.nl/?page=apidoc Retrieve real-time statistics for all active mining pools and algorithms. ```APIDOC ## GET /api/status/ ### Description Fetches comprehensive, real-time statistics for each mining algorithm supported by the pool. ### Method GET ### Endpoint https://www.mining-dutch.nl/api/status/ ### Response #### Success Response (200) The response is a JSON object where keys are algorithm names (e.g., `blake2s`). Each algorithm object contains details like port, coins, fees, hashrate (total, shared, solo), worker counts, and profitability estimates. #### Response Example ```json { "blake2s": { "name": "blake2s", "port": 6671, "coins": 4, "fees": 2, "hashrate": "649533648.74056139", "hashrate_shared": 647053944.60003, "hashrate_solo": "2479704.14053148", "workers": "329", "workers_shared": "327", "workers_solo": "2", "estimate_current": "0.00001527", "estimate_last24h": "0.000014886458", "actual_last24h": "0.00001541", "mbtc_mh_factor": 1000000, "hashrate_last24h": "649533648.74056139" } // ... other algorithms } ``` ``` -------------------------------- ### Per Pool / Algorithm Data Source: https://www.mining-dutch.nl/?page=apidoc Retrieve detailed status information for a specific mining pool or algorithm. This includes user-specific data like hashrate, shares, and worker status, as well as general pool statistics. ```APIDOC ## GET /pools/{pool_or_algorithm}.php ### Description Retrieves user status and other data for a specific mining pool or algorithm. ### Method GET ### Endpoint https://www.mining-dutch.nl/pools/litecoin.php?page=api&action=[action]&api_key='your_api_key'&id='your_account_id' Replace `litecoin` with the pool or algorithm name. The `action` parameter specifies the data to retrieve. ### Parameters #### Query Parameters - **page** (string) - Required - Must be 'api'. - **action** (string) - Required - The action to perform (e.g., `getuserstatus`, `getpoolhashrate`, `public`). - **api_key** (string) - Optional - Your API key for authentication. If provided, `id` can be omitted. - **id** (string) - Optional - Your account ID. If `api_key` is provided, this can be omitted. #### Available Actions: - `getblockcount`: Get current block height in blockchain. - `getblocksfound`: Get last N blocks. - `getblockstats`: Get pool block stats. - `getcurrentworkers`: Get amount of current active workers. - `getdashboarddata`: Fetch all dashboard related information. - `getdifficulty`: Get current difficulty in blockchain. - `getestimatedtime`: Get estimated time to next block based on pool hashrate (seconds). - `gethourlyhashrates`: Currently broken. - `getpoolhashrate`: Get current pool hashrate. - `getpoolinfo`: Get the information on pool settings. - `getpoolsharerate`: Get current pool share rate (shares/s). - `gettimesincelastblock`: Get time since last block found (seconds). - `gettopcontributors`: Fetch top contributors data. - `getuserbalance`: Fetch a user's balance. - `getuserhashrate`: Fetch a user's hash rate. - `getusersharerate`: Fetch a user's share rate (currently broken). - `getuserstatus`: Fetch current user's status. - `getusertransactions`: Get a user's transactions. - `getuserworkers`: Fetch a user's worker status. - `public`: Fetch public pool statistics, no authentication required. ### Request Example ```json { "getuserstatus": { "version": "1.0.0", "runtime": 42.4, "data": { "username": "username", "shares": { "valid": 297336832, "invalid": 5390336 }, "hashrate": 1037950.4298667, "sharerate": 15837.87, "efficiency": "100.00" } } } ``` ### Response #### Success Response (200) Response structure varies based on the `action` parameter. For `getuserstatus`, it includes `version`, `runtime`, and `data` containing user-specific metrics. The `public` action returns a flat object. #### Response Example (for `getuserstatus`) ```json { "getuserstatus": { "version": "1.0.0", "runtime": 42.4, "data": { "username": "username", "shares": { "valid": 297336832, "invalid": 5390336 }, "hashrate": 1037950.4298667, "sharerate": 15837.87, "efficiency": "100.00" } } } ``` ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.