Simplemining.net API (latest)

Download OpenAPI specification:Download

REST API

Overview

The API is based on REST principles. It supports GET, POST, PUT, PATCH and DELETE requests.

Base URI

All URLs referenced in the documentation have the following base: https://api.simplemining.net

Authentication

apiKey

To call api methods you must provide api key.
The api key is listed in Account Settings on Subaccouts tab.
Each api key is assigned to subaccount and its permissions.

Security Scheme Type: API Key
Header parameter name: X-AUTH-TOKEN

Rig List

Get Rig List

Get Rig List for User

Authorizations:
apiKey
query Parameters
itemsPerPage
integer
Example: itemsPerPage=100

Number of items returned

page
integer
Example: page=1

Number of page

order[name]
string
Enum: "asc" "desc"
Example: order[name]=desc

Order by name

order[hashrate]
string
Enum: "asc" "desc"
Example: order[hashrate]=desc

Order by hashrate

order[status]
string
Enum: "asc" "desc"
Example: order[status]=desc

Order by status

order[temp]
string
Enum: "asc" "desc"
Example: order[temp]=desc

Order by max temperature

order[rigOc.name]
string
Enum: "asc" "desc"
Example: order[rigOc.name]=desc

Order by Group OC name

order[description]
string
Enum: "asc" "desc"
Example: order[description]=desc

Order by info

order[startCount]
string
Enum: "asc" "desc"
Example: order[startCount]=desc

Order by number of restarts

order[sysPwr]
string
Enum: "asc" "desc"
Example: order[sysPwr]=desc

Order by power consumption (watts)

statusAlert
string
Enum: "has_alerts" "no_alerts" "reboot" "gpu" "paused" "temp"
Example: statusAlert=has_alerts

Filter by alerts:
has_alerts - With alerts
no_alerts - Without alerts
reboot - Only Reboots
gpu - Only Missing GPU
paused - Only Paused
temp - Only Temp

status
string
Enum: "on" "off"
Example: status=on

Filter by status

statusAddedTimeDelay
integer
Example: statusAddedTimeDelay=3600

Filter by rig added within (value in seconds)

statusTimeDelay
integer
Example: statusTimeDelay=3600

Filter by status OFF within (value in seconds)

statusTimeGreaterThan
integer
Example: statusTimeGreaterThan=3600

Filter by status OFF more than (value in seconds)

osSeries
string
Example: osSeries=NV

Filter by osSeries
see: Get filter List

rigGroup
integer
Example: rigGroup=1

Filter by Group Config ID
see: Get filter List

rigOc
integer
Example: rigOc=1

Filter by Group OC ID
see: Get filter List

userTags[]
Array of integers
Example: userTags[]=1

Filter by Tags
see: Get filter List

search
string

Filter by name, description, OS Series, OS Version, Group Config name, Group OC name, Support ID

Responses

Request samples

curl --location --request GET 'https://api.simplemining.net/rigs/user-list' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
[
  • {
    }
]

Get Filter List

Get Filter List for User

Authorizations:
apiKey

Responses

Request samples

curl --location --request GET 'https://api.simplemining.net/rigs/filter-list' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
[
  • {
    }
]

Get Rigs Summary

Get Rigs summary details

Authorizations:
apiKey
query Parameters
order[name]
string
Enum: "asc" "desc"
Example: order[name]=desc

Order by name

order[hashrate]
string
Enum: "asc" "desc"
Example: order[hashrate]=desc

Order by hashrate

order[status]
string
Enum: "asc" "desc"
Example: order[status]=desc

Order by status

order[temp]
string
Enum: "asc" "desc"
Example: order[temp]=desc

Order by max temperature

order[rigOc.name]
string
Enum: "asc" "desc"
Example: order[rigOc.name]=desc

Order by Group OC name

order[description]
string
Enum: "asc" "desc"
Example: order[description]=desc

Order by info

statusAlert
string
Enum: "has_alerts" "no_alerts" "reboot" "gpu" "paused" "temp"
Example: statusAlert=has_alerts

Filter by alerts:
has_alerts - With alerts
no_alerts - Without alerts
reboot - Only Reboots
gpu - Only Missing GPU
paused - Only Paused
temp - Only Temp

status
string
Enum: "on" "off"
Example: status=on

Filter by status

statusAddedTimeDelay
integer
Example: statusAddedTimeDelay=3600

Filter by rig added within (value in seconds)

statusTimeDelay
integer
Example: statusTimeDelay=3600

Filter by status OFF within (value in seconds)

statusTimeGreaterThan
integer
Example: statusTimeGreaterThan=3600

Filter by status OFF more than (value in seconds)

osSeries
string
Example: osSeries=NV

Filter by osSeries
see: Get filter List

rigGroup
integer
Example: rigGroup=1

Filter by Group Config ID
see: Get filter List

rigOc
integer
Example: rigOc=1

Filter by Group OC ID
see: Get filter List

userTags[]
Array of integers
Example: userTags[]=1

Filter by Tags
see: Get filter List

search
string

Filter by name, description, OS Series, OS Version, Group Config name, Group OC name, Support ID

Responses

Request samples

curl --location --request GET 'https://api.simplemining.net/rigs/summary' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
{
  • "all": {
    },
  • "filtered": {
    }
}

Get Rig Details

Get Rig Details by ID

Authorizations:
apiKey
path Parameters
id
required
integer
Example: 1

Rig ID

Responses

Request samples

curl --location --request GET 'https://api.simplemining.net/rigs/1' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
{
  • "id": 0,
  • "supportId": "string",
  • "name": "string",
  • "description": "string",
  • "startCount": 0,
  • "ebSerial": "string",
  • "ip": "string",
  • "gpuCountMax": 0,
  • "executeStatus": "string",
  • "osSeries": "string",
  • "osVersion": "string",
  • "ocCore": "string",
  • "ocMemory": "string",
  • "ocPowerLimit": "string",
  • "ocVddc": "string",
  • "ocMode": true,
  • "ocTempTarget": "string",
  • "ocFanSpeedMin": "string",
  • "ocAdvTools": "string",
  • "ocMvdd": "string",
  • "ocMvddci": "string",
  • "dateResetCounter": "2022-05-10T13:59:01+02:00",
  • "date": "2022-03-16T11:47:34+01:00",
  • "dateStart": "2022-03-10T09:27:30+01:00",
  • "isPaused": true,
  • "isOcAdvToolsOn": true,
  • "isOcDelayed": true,
  • "isOnline": true,
  • "srrSerial": "string",
  • "srrSlot": 0,
  • "isSrrEnabled": true,
  • "rigGroup": {
    },
  • "rigOc": {
    },
  • "schedule": {
    },
  • "userTags": [
    ],
  • "redisData": null,
  • "alerts": [
    ],
  • "gpuList": [
    ]
}

Delete Rig

Delete Rig by ID

Authorizations:
apiKey
path Parameters
id
required
integer
Example: 1

Rig ID

Responses

Request samples

curl --location --request DELETE 'https://api.simplemining.net/rigs/1' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
{}

Get Rig Console

Get Rig Console by ID

Authorizations:
apiKey
path Parameters
id
required
integer
Example: 1

Rig ID

query Parameters
type
string
Enum: "debug" "dmesg"

Console Type

Responses

Request samples

curl --location --request GET 'https://api.simplemining.net/rigs/1/console' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
{
  • "console": "string"
}

Change Group Config

Change Group Config in Rigs by Rig IDs

Authorizations:
apiKey
header Parameters
Content-Type
required
string
Example: application/merge-patch+json
Request Body schema: application/merge-patch+json
rigIds
Array of arrays

Provide Rig IDs to apply change on selected Rigs

rigGroupId
integer

Group Config ID

execute
string

Provide additional execute command:
reload - reload rigs after change
reboot - reboot rigs after change

Responses

Request samples

Content type
application/merge-patch+json
{
  • "rigIds": [
    ],
  • "rigGroupId": 7,
  • "execute": "reload"
}

Response samples

Content type
application/json
{ }

Change Group OC

Change Group OC in Rigs by Rig IDs

Authorizations:
apiKey
header Parameters
Content-Type
required
string
Example: application/merge-patch+json
Request Body schema: application/merge-patch+json
rigIds
Array of arrays

Provide Rig IDs to apply change on selected Rigs

rigOcId
integer

Group OC ID

action
string

Provide action type:
link - change Group OC on given rigs
unlink - remove Group OC from given rigs

execute
string

Provide execute command:
reload - reload rigs after change
reboot - reboot rigs after change

Responses

Request samples

Content type
application/merge-patch+json
{
  • "rigIds": [
    ],
  • "rigOcId": 7,
  • "action": "link",
  • "execute": "reload"
}

Response samples

Content type
application/json
{ }

Execute Reboot

Execute Reboot on Rigs by Rig IDs, Group OC ID or Group Config ID

Authorizations:
apiKey
header Parameters
Content-Type
required
string
Example: application/merge-patch+json
Request Body schema: application/merge-patch+json
rigIds
Array of arrays

Provide Rig IDs to apply change on selected Rigs

rigOcId
integer

Provide Group OC ID to apply change on Rigs within this group

rigGroupId
integer

Provide Group Config ID to apply change on Rigs within this group

rigGroupIds
Array of arrays

Provide Group Config IDs to apply change on Rigs within this groups

Responses

Request samples

Content type
application/merge-patch+json
{
  • "rigIds": [
    ],
  • "rigOcId": 1,
  • "rigGroupId": 1,
  • "rigGroupIds": [
    ]
}

Response samples

Content type
application/json
{ }

Execute Reload

Execute Reload on Rigs by Rig IDs, Group OC ID or Group Config ID

Authorizations:
apiKey
header Parameters
Content-Type
required
string
Example: application/merge-patch+json
Request Body schema: application/merge-patch+json
rigIds
Array of arrays

Provide Rig IDs to apply change on selected Rigs

rigOcId
integer

Provide Group OC ID to apply change on Rigs within this group

rigGroupId
integer

Provide Group Config ID to apply change on Rigs within this group

rigGroupIds
Array of arrays

Provide Group Config IDs to apply change on Rigs within this groups

Responses

Request samples

Content type
application/merge-patch+json
{
  • "rigIds": [
    ],
  • "rigOcId": 1,
  • "rigGroupId": 1,
  • "rigGroupIds": [
    ]
}

Response samples

Content type
application/json
{ }

Execute Pause

Execute Pause on Rigs by Rig IDs, Group OC ID or Group Config ID

Authorizations:
apiKey
header Parameters
Content-Type
required
string
Example: application/merge-patch+json
Request Body schema: application/merge-patch+json
rigIds
Array of arrays

Provide Rig IDs to apply change on selected Rigs

rigOcId
integer

Provide Group OC ID to apply change on Rigs within this group

rigGroupId
integer

Provide Group Config ID to apply change on Rigs within this group

rigGroupIds
Array of arrays

Provide Group Config IDs to apply change on Rigs within this groups

Responses

Request samples

Content type
application/merge-patch+json
{
  • "rigIds": [
    ],
  • "rigOcId": 1,
  • "rigGroupId": 1,
  • "rigGroupIds": [
    ]
}

Response samples

Content type
application/json
{ }

Execute Resume

Execute Resume on Rigs by Rig IDs, Group OC ID or Group Config ID

Authorizations:
apiKey
header Parameters
Content-Type
required
string
Example: application/merge-patch+json
Request Body schema: application/merge-patch+json
rigIds
Array of arrays

Provide Rig IDs to apply change on selected Rigs

rigOcId
integer

Provide Group OC ID to apply change on Rigs within this group

rigGroupId
integer

Provide Group Config ID to apply change on Rigs within this group

rigGroupIds
Array of arrays

Provide Group Config IDs to apply change on Rigs within this groups

Responses

Request samples

Content type
application/merge-patch+json
{
  • "rigIds": [
    ],
  • "rigOcId": 1,
  • "rigGroupId": 1,
  • "rigGroupIds": [
    ]
}

Response samples

Content type
application/json
{ }

Execute Find Rig

Execute Find Rig on Rigs by Rig IDs, Group OC ID or Group Config ID

Authorizations:
apiKey
header Parameters
Content-Type
required
string
Example: application/merge-patch+json
Request Body schema: application/merge-patch+json
rigIds
Array of arrays

Provide Rig IDs to apply change on selected Rigs

rigOcId
integer

Provide Group OC ID to apply change on Rigs within this group

rigGroupId
integer

Provide Group Config ID to apply change on Rigs within this group

rigGroupIds
Array of arrays

Provide Group Config IDs to apply change on Rigs within this groups

Responses

Request samples

Content type
application/merge-patch+json
{
  • "rigIds": [
    ],
  • "rigOcId": 1,
  • "rigGroupId": 1,
  • "rigGroupIds": [
    ]
}

Response samples

Content type
application/json
{ }

Execute Find GPU

Execute Find GPU on Rigs by Rig IDs, Group OC ID or Group Config ID

Authorizations:
apiKey
header Parameters
Content-Type
required
string
Example: application/merge-patch+json
Request Body schema: application/merge-patch+json
rigIds
Array of arrays

Provide Rig IDs to apply change on selected Rigs

rigOcId
integer

Provide Group OC ID to apply change on Rigs within this group

rigGroupId
integer

Provide Group Config ID to apply change on Rigs within this group

rigGroupIds
Array of arrays

Provide Group Config IDs to apply change on Rigs within this groups

gpuId
integer

Number starting of 0

Responses

Request samples

Content type
application/merge-patch+json
{
  • "rigIds": [
    ],
  • "rigOcId": 1,
  • "rigGroupId": 1,
  • "rigGroupIds": [
    ],
  • "gpuId": 0
}

Response samples

Content type
application/json
{ }

Execute Shutdown

Execute Shutdown on Rigs by Rig IDs, Group OC ID or Group Config ID

Authorizations:
apiKey
header Parameters
Content-Type
required
string
Example: application/merge-patch+json
Request Body schema: application/merge-patch+json
rigIds
Array of arrays

Provide Rig IDs to apply change on selected Rigs

rigOcId
integer

Provide Group OC ID to apply change on Rigs within this group

rigGroupId
integer

Provide Group Config ID to apply change on Rigs within this group

rigGroupIds
Array of arrays

Provide Group Config IDs to apply change on Rigs within this groups

Responses

Request samples

Content type
application/merge-patch+json
{
  • "rigIds": [
    ],
  • "rigOcId": 1,
  • "rigGroupId": 1,
  • "rigGroupIds": [
    ]
}

Response samples

Content type
application/json
{ }

Execute Sleep

Execute Sleep on Rigs by Rig IDs, Group OC ID or Group Config ID

Authorizations:
apiKey
header Parameters
Content-Type
required
string
Example: application/merge-patch+json
Request Body schema: application/merge-patch+json
rigIds
Array of arrays

Provide Rig IDs to apply change on selected Rigs

rigOcId
integer

Provide Group OC ID to apply change on Rigs within this group

rigGroupId
integer

Provide Group Config ID to apply change on Rigs within this group

rigGroupIds
Array of arrays

Provide Group Config IDs to apply change on Rigs within this groups

minutes
integer

Number of minutes

hours
integer

Number of hours

Responses

Request samples

Content type
application/merge-patch+json
{
  • "rigIds": [
    ],
  • "rigOcId": 1,
  • "rigGroupId": 1,
  • "rigGroupIds": [
    ],
  • "minutes": 1,
  • "hours": 1
}

Response samples

Content type
application/json
{ }

Execute Clear Counter

Execute Clear Counter on Rigs by Rig IDs, Group OC ID or Group Config ID

Authorizations:
apiKey
header Parameters
Content-Type
required
string
Example: application/merge-patch+json
Request Body schema: application/merge-patch+json
rigIds
Array of arrays

Provide Rig IDs to apply change on selected Rigs

rigOcId
integer

Provide Group OC ID to apply change on Rigs within this group

rigGroupId
integer

Provide Group Config ID to apply change on Rigs within this group

rigGroupIds
Array of arrays

Provide Group Config IDs to apply change on Rigs within this groups

Responses

Request samples

Content type
application/merge-patch+json
{
  • "rigIds": [
    ],
  • "rigOcId": 1,
  • "rigGroupId": 1,
  • "rigGroupIds": [
    ]
}

Response samples

Content type
application/json
{ }

Execute Delete

Execute Delete on Rigs by Rig IDs, Group OC ID or Group Config ID

Authorizations:
apiKey
header Parameters
Content-Type
required
string
Example: application/merge-patch+json
Request Body schema: application/merge-patch+json
rigIds
Array of arrays

Provide Rig IDs to apply change on selected Rigs

Responses

Request samples

Content type
application/merge-patch+json
{
  • "rigIds": [
    ]
}

Response samples

Content type
application/json
{ }

Execute Command

Execute Command on Rigs by Rig IDs, Group OC ID or Group Config ID

Authorizations:
apiKey
header Parameters
Content-Type
required
string
Example: application/merge-patch+json
Request Body schema: application/merge-patch+json
rigIds
Array of arrays

Provide Rig IDs to apply change on selected Rigs

rigOcId
integer

Provide Group OC ID to apply change on Rigs within this group

rigGroupId
integer

Provide Group Config ID to apply change on Rigs within this group

rigGroupIds
Array of arrays

Provide Group Config IDs to apply change on Rigs within this groups

commandId
integer

Command ID

commandOptions
string

Provide command options when applicable

Responses

Request samples

Content type
application/merge-patch+json
{
  • "rigIds": [
    ],
  • "rigOcId": 1,
  • "rigGroupId": 1,
  • "rigGroupIds": [
    ],
  • "commandId": 7,
  • "commandOptions": "string"
}

Response samples

Content type
application/json
{ }

Group Config

Get available Group Configs

Get available Group Configs

Authorizations:
apiKey
query Parameters
itemsPerPage
integer
Example: itemsPerPage=100

Number of items returned

page
integer
Example: page=1

Number of page

order[name]
string
Enum: "asc" "desc"
Example: order[name]=desc

Order by name

order[rigsCount]
string
Enum: "asc" "desc"
Example: order[rigsCount]=desc

Order by rigs count

order[minerProgram.name]
string
Enum: "asc" "desc"
Example: order[minerProgram.name]=desc

Order by miner program name

search
string

Filter by name, description

Responses

Request samples

curl --location --request GET 'https://api.simplemining.net/rig-groups/user-list' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
[
  • {
    }
]

Group OC

Get available Group OCs

Get available Group OCs

Authorizations:
apiKey
query Parameters
itemsPerPage
integer
Example: itemsPerPage=100

Number of items returned

page
integer
Example: page=1

Number of page

order[name]
string
Enum: "asc" "desc"
Example: order[name]=desc

Order by name

order[rigsCount]
string
Enum: "asc" "desc"
Example: order[rigsCount]=desc

Order by rigs count

order[ocCore]
string
Enum: "asc" "desc"
Example: order[ocCore]=desc

Order by core

order[ocMemory]
string
Enum: "asc" "desc"
Example: order[ocMemory]=desc

Order by memory

order[ocVddc]
string
Enum: "asc" "desc"
Example: order[ocVddc]=desc

Order by core voltage

order[ocMvdd]
string
Enum: "asc" "desc"
Example: order[ocMvdd]=desc

Order by MVDD

order[ocMvddci]
string
Enum: "asc" "desc"
Example: order[ocMvddci]=desc

Order by MVDDCI

order[ocMode]
string
Enum: "asc" "desc"
Example: order[ocMode]=desc

Order by aggressive undervolt

order[ocPowerLimit]
string
Enum: "asc" "desc"
Example: order[ocPowerLimit]=desc

Order by power stage (RX) or power limit (NV)

order[ocTempTarget]
string
Enum: "asc" "desc"
Example: order[ocTempTarget]=desc

Order by target temp

order[ocFanSpeedMin]
string
Enum: "asc" "desc"
Example: order[ocFanSpeedMin]=desc

Order by min fan speed

order[isOcAdvToolsOn]
string
Enum: "asc" "desc"
Example: order[isOcAdvToolsOn]=desc

Order by advanced tools

osSeries
string
Enum: "RX" "NV" "R"
Example: osSeries=has_alerts

Filter by osSeries:
RX - AMD rigs
NV - Nvidia rigs
R - very old AMD (HD7000/R200) rigs

search
string

Filter by name, description

Responses

Request samples

curl --location --request GET 'https://api.simplemining.net/rig-ocs/user-list' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
[
  • {
    }
]

Commands

Get available commands

Get available commands to execute on rig

Authorizations:
apiKey

Responses

Request samples

curl --location --request GET 'https://api.simplemining.net/rig-commands' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
[
  • {
    }
]

Deposit Fee

Get deposit address

Get deposit address by currency code

Authorizations:
apiKey
query Parameters
currency
required
string
Enum: "BTC" "ETH" "ETC" "ZEC" "LTC"
Example: currency=ETH

Currency code

Responses

Request samples

curl --location --request GET 'https://api.simplemining.net/deposits/address?currency=eth' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
{
  • "currency": "ETH",
  • "currencyStatus": "online",
  • "address": "0x734272hdhduahdufu38748er7wDC"
}

Get deposit summary

Get deposit summary including balance, service days remaining, etc

Authorizations:
apiKey

Responses

Request samples

curl --location --request GET 'https://api.simplemining.net/deposits/summary' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
{
  • "balanceUsd": "20.002",
  • "daysRemaining": 10,
  • "isAccountBlocked": false,
  • "rates": {
    },
  • "last24hRigsCount": 2,
  • "discountLevel": 0,
  • "discountLevelRate": 1,
  • "currentPricePerRig": 2
}

Get deposit list

Get deposit list with transaction ID, status, etc

Authorizations:
apiKey
query Parameters
itemsPerPage
integer
Example: itemsPerPage=100

Number of items returned

page
integer
Example: page=1

Number of page

order[createdAt]
string
Enum: "asc" "desc"
Example: order[createdAt]=desc

Order by createdAt

order[amountUsd]
string
Enum: "asc" "desc"
Example: order[amountUsd]=desc

Order by amountUsd

order[status]
string
Enum: "asc" "desc"
Example: order[status]=desc

Order by status

Responses

Request samples

curl --location --request GET 'https://api.simplemining.net/deposits/user-list' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
[]