Mining Dutch API

https://www.mining-dutch.nl/api/v1/
Admin
API documentation for Mining Dutch, a cryptocurrency mining pool providing endpoints for pool...
Tokens:5,764
Snippets:21
Trust Score:8.7
Update:4 months ago
Show doc for...
Tokens:
Raw
### 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"
        }
    }
}
```
```
Tokens:
Raw