礦池API

基礎信息

接口地址

● 密鑰獲取方式

a. 提供在蜘蛛官網註冊的郵箱,聯系蜘蛛工作人員開通第三方API權限，開通成功後登錄官網在個人中心下面能看到"獲取API密鑰入口"

● 線上環境

a. 官網線上：https://api.spiderpool.com/

說明

● H、KH、MH、GH、TH、PH、EH，算力單位間相差1000

註意

● 所有接口采用私鑰簽名，公鑰驗簽的方式請求

● 統一請求格式

{
    "dataJson": "", 
    "accessKey": "", 
    "timestamp": 1628381288000,
    "sign": ""
}

● 如訪問/v2/addUser接口

{
    "dataJson": "{"userName":"test001","password":"123456"}",
    "accessKey": "D1504708600B44B499489C16CE7C32A5",
    "timestamp": 1628381288000,
    "sign": "N0n0iqKLUtssteqhbsOHGv2N7UaJh+YnPio90fciAM4hn2L82jAhafG/ynxdgFnBf2ZJ2R2C1d0uRvSNSHnEJKA8rvMx6ytQa2E4gpD8LG0kkdzYwgv9pyEFOGsS4+cUdV+nF/WJiPDRqfx8Cb0gPjBuCj+HboVx5++HOe2v+sA="
}

● 統一返回格式

{
    "code": "",
    "msg": "",
    "data": object,
}

code="SUCCESS" 為操作成功，其余失敗

● 請求示例

8KB

RSACoder.java

    long timestamp = System.currentTimeMillis();
    String spiderUrl = "https://api.spiderpool.com/v2/subaccount/createSubaccount";
    JSONObject jsonObject = new JSONObject();
    jsonObject.put("coin", "eth");
    jsonObject.put("subaccount", "chizg101");
    jsonObject.put("walletAddress", "0x9ed670910a8e5895428bb85e600d7d388a904a22");

    Map<String, Object> param = new HashMap<>();
    String dataJsonStr = jsonObject.toJSONString() + "|" + timestamp;
    String sign = RSACoder.sign(dataJsonStr.getBytes(StandardCharsets.UTF_8), privateKey);

    param.put("dataJson", jsonObject.toJSONString());
    param.put("accessKey", "5A842DAA0B8A4746B362FBF382A04CD9");
    param.put("timestamp", timestamp);
    param.put("sign", sign);

    String jsonBody = JSON.toJSONString(param);

    String reslut = HttpclientUtil.postRequest(spiderUrl, jsonBody,null,true);

    import requests
    from Crypto.PublicKey import RSA
    from Crypto.Signature import PKCS1_v1_5
    from Crypto.Hash import MD5
    import base64
    import time
    import calendar
    datajson = "{'subAccountName':'test0414dan08','coin':'eth'}"
    timestamp = str(int(round(calendar.timegm(time.gmtime())*1000)))
    data = datajson + "|%s" % (timestamp)
    #私钥
    privatekey='''MIICdgIBADANBgkqhkiG9w0BAQEFAASCAmAwggJcAgEAAoGBAJpigNWb2r6fbue9CfnaRyundft0WS4e/hhtdCef74UdH9stDtRidv24hieP7uXdq8KHVmzqAqiNVAHsg4WttwO9Fyz0YPuJZ/mXLqI0S4SOzGZ7hqErDOOF1Z9WE/ykapGAT/SBc5q0lLN6Z3iz7AygZYy4UxrH3cR2BsrUEyGnAgMBAAECgYBNTxpY3Uzyu//bh+xg849EKv2Hx8GIuPhg3x6VYR+eNvFm3e9ZJ12SvD5hvU/SR+jk5sS+kYh3Qx5YQEm0PUMxjyRkBpZUVitkBpRvBaQKfRvS9D65rUlUYhgHnyhwdvmIvJYob9dB+HkOgZMqEwWrWqe4B8E4i8ei9fwLkVSn0QJBAPHUljaXd4gvtkJVExlKB4u7irTEVjwTi9Nbh2pUWk3jgb1/Ua0kbNtQ0vEiBtQ6ROOSqbPoBCiH5YwR0KKjw2UCQQCjbj9Z98wUEXIao2EQ11U4T281B9vqUSYPBR4u7UVEDkeEyxL0gzXmqJc8pAmgCygSi0Ggg5xxD5TjoW+4xg4bAkEAjeE9qBXBiWMEuXIUXHf0aWTEgj3WojSNiplen2GSAbSCv9zc3IpMW3fV6qcd/pGZLTM04Vo0Zlskr8Mb9u/BiQJAcR60Nt+voAxbQFjprLB/ShShUsF31H4Kq8bNF4ofsXV4x0+QdTIEsvzqgYzBJMfUGtHMwP+X3yH72ns5S1m7FQJAKCWFdZzN9D+2HX7yZsc4/Q7l+J//LpZJjLsVhcDh3RGRU3QX6SzCWlLwOq4FX+nUYej2B3rr0ymr+tiy/k7fbQ==
    '''
    private_keyBytes = base64.b64decode(privatekey)
    prikey = RSA.importKey(private_keyBytes)
    signer = PKCS1_v1_5.new(prikey)
    hash_obj = MD5.new(data.encode('utf-8'))
    signtrue = base64.b64encode(signer.sign(hash_obj))
    sign = str(signtrue)[2:-1]
    url = "https://api.spiderpool.com/v2/subaccount/createSubaccount"
    data = {
        "dataJson": datajson,
        "accessKey": "5A842DAA0B8A4746B362FBF382A04CD9",
        "timestamp": timestamp,
        "sign": sign
    }
    result = requests.post(url,json=data)
    print(result.text)

const http = require('http');
const crypto = require('crypto');
const privateKey = "MIICeAIBADANBgkqhkiG9w0BAQEFAASCAmIwggJeAgEAAoGBAM8WblrosGzrRPSo+xBiL1zMCimpq64nqw66Wh4Z3lG1WIAfe+mes3oFzLsiOuPALCUZHbaMQ9fC7gcgQIL8PtlPRnuqxO1VrKDPE1hCN2cy+7HuSgWMrhnkgP11eVrDFEV4c9ugA1pl9e/4s2F3QCuCKCCrDh+lFTcwLOB+/jqbAgMBAAECgYEAme0ZX9c/c+Y4XgbQfvAMNlSvZSJpqsxveEYJwAAIYQGDY9CDITZGP3faImqiDTGFXpnZnRuLPe/1TzSo3vOxniuW2Bdyu7gn39b6/bmwveIUVzHG3K5VUMV5r8uGiFoPkbl9jQmBBluAWhPsEdMMibdW+WGXsMiLigVdocCDF9ECQQD7SQMY4op0UuaUjFY3oPs5zTXzupopMFxMFxIn4WnZYTruRXFnJnzS2r+Cm6t+TdjXES0kHjky2ml5FSVfVLMjAkEA0vkgZTh/jGFSQ619Fa3TYzSa8TNGw309pXnXWQRKJO6USmWKOfdONp1u0aN/QlsFCGi8OmjTxeL8KsNWAEHuKQJAHqWr/Af9LOzDdJCdH1HB8i3GC8DRdn6QczNJIpYKa9nA7ziG+TaneKv3OX2078Wc0bYllEcfYMVkocDjevoAkwJBAIuVCDnwB3N5cFQWlIujVhhs1ZZ/tnHgisjQtAnRLL0CnFoclDeFx9maj5dj9O6SCeJmaSK7+GEUrIIeeufwtwECQQCq5yGYqnuXHQSra6qSpoC+65AyROVdDhXWRPdroFFbtTdE9EdaKImgac4B2ARKMGsKSXNXSXStHneN1R7n+iX/"

const signer = (json) => {
    const privateKeys = "-----BEGIN PRIVATE KEY-----\n" + privateKey + "\n-----END PRIVATE KEY-----"
    const sign = crypto.createSign('md5');
    sign.update(json);
    return sign.sign(privateKeys, 'base64');
}

const jsonObject = JSON.stringify({
    queryTime: 1620732754
})
const timestamp = new Date().valueOf()
const dataJsonStr = `${jsonObject}|${timestamp}`
const sign = signer(dataJsonStr)
const postData = JSON.stringify({
    dataJson: jsonObject,
    accessKey: "AF7180A7203F49779052F1D1336EBE3C",
    timestamp: timestamp,
    sign: sign
});
const options = {
    hostname: 'https://api.spiderpool.com',
    path: '/v2/game/getData',
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Content-Length': Buffer.byteLength(postData)
    }
};
const req = http.request(options, (res) => {
    res.setEncoding('utf8');
    res.on('data', (chunk) => {
        console.log(`響應主體: ${chunk}`);
    });
});
// 將數據寫入請求主體。
req.write(postData);
req.end();

$private = 'PRIVATE_KEY';
$dataJson = json_encode([
    'walletAddress' => 'eth_address',
    'subaccount' => 'sub_account_name',
    'coin' => 'eth',
]);
$timestamp = round(microtime(true) * 1000);
if (openssl_sign($dataJson . '|' . $timestamp, $signature, $private, OPENSSL_ALGO_MD5)) {
    $signature = base64_encode($signature);
    $httpClient = new \GuzzleHttp\Client(['timeout' => 10]);
    $response = $httpClient->post('https://api.spiderpool.com/v2/subaccount/createSubaccount', [
        \GuzzleHttp\RequestOptions::BODY => json_encode([
            'dataJson' => $dataJson,
            'accessKey' => 'ACCESS_KEY',
            'timestamp' => $timestamp,
            'sign' => $signature,
        ]),
    ]);

    dd($response->getBody()->getContents());
}
dd('fail');

API

創建子賬號

備註：建立BTC子帳號會同時建立FB子帳號，但建立FB子帳號不會同時建立BTC子帳號

請求 `AUTH`

POST /v2/subaccount/createSubaccount

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種，如，btc、fb

subaccount

String

true

子賬號(5～20由小寫字母數字組成的)

walletAddress

String

false

錢包地址(請根據鏈環境填符合規則的地址)

正確響應：

{
    "code": "SUCCESS"
}

錯誤響應：

{
    "code": "......", // INVALID_SUBACCOUNT / SUBACCOUNT_EXIST / IVAILD_WALLETADDRESS
    "msg": "......"
}

修改子賬號

請求 `AUTH`

POST /v2/subaccount/modifyWalletAddress

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種縮寫，如，btc、fb

subaccount

String

true

子賬號名稱

newWalletAddress

String

true

新的錢包地址(請根據鏈環境填符合規則的地址)

正確響應：

{
    "code": "SUCCESS"
}

錯誤響應：

{
    "code": "......", // INVALID_SUBACCOUNT / SUBACCOUNT_EXIST / IVAILD_WALLETADDRESS
    "msg": "......"
}

觀察者模式

請求 `AUTH`

POST /v2/subaccount/subAccountObserverLink

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種縮寫，如，btc、fb

subaccount

String

true

子賬號名稱

type

String

true

類型：newSign 新增、resetSign 重置、deleteSign 刪除

正確響應：

{
	"code":"SUCCESS",
	"data":{
		"subaccount":"btctestchizg002",
		"sign":"v92480670d100d4c67f9e22d6ae612fd3e78aebb6e1b1fcdba994ba454ade6482",
		"coin":"btc"
	}
}

錯誤響應：

{
    "code": "......", // INVALID_SUBACCOUNT / SUBACCOUNT_EXIST / IVAILD_WALLETADDRESS
    "msg": "......"
}

獲取子賬號列表

請求 `AUTH`

POST /v2/sp/subaccount/list

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種縮寫，如，btc、ltc、etc

正確響應：

{
    "code": 200,
    "msg": "Success",
    "t": 1748485449635,
    "data": [
        {
            "subaccount": "test",
            "coin": "btc",
            "withdrawAddress": "3CBZ7ayUBz8cUiGfA3F5Fcgo2RQdKYPk94"
        },
        ...
    ],
    "success": true
}

獲取子賬號分页列表-带算力

請求 `AUTH`

POST /v2/sp/subaccount/pageWithHashRate

參數

參數名

參數類型

必填

默認值

描述

coin

String

false

幣種縮寫，如btc、ltc

subaccount

String

false

子賬號，支持模糊查詢

showStatus

Integer

false

0:隱藏子賬號,1:顯示

pageNumber

Integer

false

頁數

pageSize

Integer

false

每頁數量

正確響應：

{
    "code": 200,
    "msg": "Success",
    "t": 1748485522530,
    "data": {
        "total": 4,
        "list": [
            {
                "subaccount": "test",
                "coin": "btc",
                "walletAddress": "3CBZ7ayUBz8cUiGfA3F5Fcgo2RQdKYPk94",
                "realtimeHashrate": "3747113236364438.3",    // 實時算力 （H/s） 
                "avgHashrate1440": "3354490437959777.1",     // 24小時平均算力
                "activeWorkerNum": 882,     //在線礦工數
                "inactiveWorkerNum": 118    //離線礦工數
            },
            ...
        ]
    },
    "success": true
}

獲取子賬號收益詳細信息

請求 `AUTH`

POST /v2/subaccount/getSubaccountProfitDetailInfo

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種縮寫，如btc、ltc

subaccount

String

true

子賬號名稱

startTimestamp

Integer

false

查詢起始時間戳（秒）

endTimestamp

Integer

false

當前時間查詢結束時間戳（秒）

pageNumber

Integer

false

頁號

pageSize

Integer

false

每頁展示條數

bizType

String

false

alone_mining

业务类型（fb币种使用）。alone_mining：单挖；join_mining：双挖

正確響應：

{
    "code": "SUCCESS",
    "data": {
        "total": 35,
        "dayProfitList": [
            {
                "dayDate": 1569600000000,
                "avgHashrate": "90057979829",
                "dayProfit": 0.647981779,
            },
            ......
        ]
    }
}

獲取子賬號支付記錄

請求 `AUTH`

POST /v2/subaccount/getSubaccountPaymentRecord

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種縮寫，如btc、ltc

subaccount

String

true

子賬號名稱

startTimestamp

Integer

false

查詢起始時間戳（毫秒）

endTimestamp

Integer

false

当前时间

查詢結束時間戳（毫秒）

pageNumber

Integer

false

頁號

pageSize

Integer

false

每頁展示條數

正確響應：

{
    "code": "SUCCESS",
        "data": {
        "list": [
            {
                "paymentDate": 1564531200000, // 支付時間
                "paymentAddress": "mv8W2k7UMkqbHbfbvRXcEzaehPGvZCmkV5" // 支付地址
                "paymentMoney": 0.0666348000, // 支付金額
                "txId": "097a39595c261f141de2174d8639fd9c18122236b14f9d08c91e82aea2a87e61" // 交易Id
 
            }
        ],
            "total": 1 // 總記錄數
    }
}

獲取子賬號收益信息

請求 `AUTH`

POST /v2/subaccount/getSubaccountProfitInfo

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種縮寫，如btc、ltc

subaccount

String

true

子賬號名稱

bizType

String

false

alone_mining

业务类型（fb币种使用）。alone_mining：单挖；join_mining：双挖

正確響應：

{
    "code": "SUCCESS",
    "data": {
            "yesterdayProfit": 0.61505330, // 24小時收益
            "unpaidProfit": 0.57536600,    // 未支付收益
            "totalProfit": 26.026078521,   // 總收益
            "dayEstimateProfit": 0.57536600 // 今日收益。fb币种不支持此数据
    }
}

獲取子賬號日收益信息

請求 `AUTH`

POST /v2/sp/subaccount/getDayProfitDetailInfo

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種縮寫，如btc、ltc

subaccount

String

true

子賬號名稱

timeStamp

int

true

秒級時間戳 UTC+0

bizType

String

false

alone_mining

业务类型（fb币种使用）。alone_mining：单挖；join_mining：双挖

正確響應：

{
    "code": 200,
    "msg": "Success",
    "t": 1717677079167,
    "data": {
        "day": 1716854400,
        "coin": "btc",
        "userName": "test",
        "avgShareAccept": 6792538500482.84, // 日均算力 H/s
        "dayProfit":      0.0000052632731696429, // 總收益  BTC
        "ppsDayProfit":   0.00000505032710936514,//pps收益 BTC
        "pplnsDayProfit": 0.00000021294606027776,// 手續費收益 BTC
        "difficult": "84381461788831" //fb币种暂不支持此数据
    }
}

獲取子賬號小時收益信息

請求 `AUTH`

POST /v2/sp/subaccount/getHourProfitDetailInfo

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種縮寫，如btc、ltc

subaccount

String

true

子賬號名稱

timeStamp

int

true

秒級時間戳

正確響應：

{
    "code": 200,
    "msg": "Success",
    "t": 1717677390714,
    "data": {
        "day": 1716861600,
        "coin": "btc",     
        "userName": "test",
        "ppsDayProfit": 0.00000021294606027776  // PPS收益
    }
}

獲取昨日BTC塊收益與手續費收益比例

請求

POST /v2/subaccount/getFPPSRate

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種縮寫，如btc、ltc

day

Int

false

時間（秒）

正確響應：

{
	"code":"SUCCESS",
	"data":{
		"rate":"0.0329531088",
		"day":1711324800,
		"coin":"btc"
	}
}

獲取主賬號实时算力

請求

POST /v2/sp/hashrate/user/realHashRate

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種縮寫，如btc、ltc

正確響應：

{
	"code": 200,
        "msg": "Success",
        "t": 1748487057257,
	"data":{
                "hashRate": "4120389144707508.906",    // 算力（H/s）
                "staleRate": "0.00189",                // 延迟率
                "rejectRate": "0.001716",              // 拒绝率
                "secondTimestamp": 1748484576
        },
        "success": true
}

獲取子賬號實時算力

請求

POST /v2/sp/hashrate/subaccount/realHashRate

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種縮寫，如btc、ltc

subaccount

String

true

子賬號名稱

正確響應：

{
    "code": 200,
    "msg": "Success",
    "t": 1748485059326,
    "data": {
        "subaccount": "test",
        "hashRate": "3764743203804501.3",    // 算力（H/s）
        "staleRate": "0.003499",             // 延迟率
        "rejectRate": "0.007297",            // 拒絕率
        "secondTimestamp": 1748485059,
        "lastShareTime": 1748484468
    },
    "success": true
}

獲取子賬號10分鐘、1小時、24小時算力

請求

POST /v2/sp/hashrate/subaccount/fullHashRate

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種縮寫，如btc、ltc

subaccount

String

true

子賬號名稱

正確響應：

{
    "code": 200,
    "msg": "Success",
    "t": 1748487379592,
    "data": {
        "subaccount": "test",
        "hashRate10": "3832641468476948.48",        //10分鐘平均算力（H/s）
        "staleRate10": "0.00303",                   //10分鐘延遲率
        "rejectRate10": "0.008857",                 //10分鐘拒絕率
        "hashRateHour": "3438555662139319.18",      //1小時平均算力
        "staleRateHour": "0.002197",                //1小時延遲率
        "rejectRateHour": "0.007173",               //1小時拒絕率
        "hashRateDay": "3356108141020665.17",       //24小時平均算力
        "staleRateDay": "0.002946",                 //24小時延遲率
        "rejectRateDay": "0.005107",                //24小時拒絕率
        "lastShareTime": 1748486880
    },
    "success": true
}

獲取子賬號算力圖

請求

POST /v2/sp/hashrate/subaccount/hashRateChart

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種縮寫，如btc、ltc

subaccount

String

true

子賬號名稱

timeLevel

String

false

day_30

hour_24：24小時 10分鐘數據 day_7：7天 1小時級別數據 day_30：30天天級別數據 day_90：90天天級別數據

正確響應：

{
    "code": 200,
    "msg": "Success",
    "t": 1748487567538,
    "data": [
        {
            "subaccount": "test",
            "hashRate": "3340571201268661.6",             //算力（H/s）
            "staleRate": "0.003044",                      //延遲率
            "rejectRate": "0.005074",                     //拒絕率
            "secondTimestamp": 1745884800,                //時間戳
            "lastShareTime": 1745971190
        },
        ...
    ],
    "success": true
}

獲取子賬號歷史算力圖

請求

POST /v2/sp/hashrate/subaccount/timeRangeHashRateChart

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種縮寫，如btc、ltc

subaccount

String

true

子賬號名稱

timeLevel

String

false

day

day：天級別數據 hour：小時級別數據

startTimestamp

Long

true

秒級時間戳

endTimestamp

Long

true

秒級時間戳

正確響應：

{
    "code": 200,
    "msg": "Success",
    "t": 1748487891624,
    "data": [
        {
            "subaccount": "test",
            "hashRate": "2385258781180243.8",        //算力（H/s）
            "staleRate": "0.00299",                  //延遲率
            "rejectRate": "0.00494",                 //拒絕率
            "secondTimestamp": 1748304000,
            "lastShareTime": 1748390397
        },
        ...
    ],
    "success": true
}

獲取子賬號在線/離線礦機數量

請求

POST /v2/sp/hashrate/subaccount/onOffLineWorkerCount

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種縮寫，如btc、ltc

subaccount

String

true

子賬號名稱

正確響應：

{
    "code": 200,
    "msg": "Success",
    "t": 1748488319658,
    "data": {
        "subaccount": "test",
        "totalWorkerCount": 1000,    //總礦機數
        "onlineWorkerCount": 903,    //在線礦機數
        "offlineWorkerCount": 97     //離線礦機數
    },
    "success": true
}

獲取子賬號礦機列表

請求

POST /v2/sp/hashrate/work/list

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種縮寫，如btc、ltc

subaccount

String

true

子賬號名稱

workerName

String

false

礦機名稱，支持模糊查詢

sortField

String

false

worker_name

排序字段， worker_name：礦機名 minute_hash_rate：10分鐘算力 day_hash_rate：24小時算力 day_stale_rate：24小時延遲率 day_reject_rate：24小時拒絕率 share_time：share最後提交時間

sortRule

String

false

asc

asc：正序 desc：倒序

status

String

false

online：在線 offline：離線

pageNum

Integer

false

頁數

pageSize

Integer

false

每頁條數

正確響應：

{
    "code": 200,
    "msg": "Success",
    "t": 1748490725324,
    "data": {
        "total": 1000,        //總條數
        "pageNum": 1,         //頁數
        "pageSize": 10,       //每頁條數
        "pages": 100,         //總頁數
        "records": [
            {
                "subaccount": "test",   //子賬號
                "workerName": "w-1",    //礦機名
                "minuteHashRate": "3182613716008.96",    //10分鐘算力
                "minuteStaleRate": "0",    //10分鐘延遲率
                "minuteRejectRate": "0",    //10分鐘拒絕率
                "hourHashRate": "3178790002069.04",//1小時平均算力
                "hourStaleRate": "0",//1小時延遲率
                "hourRejectRate": "0",//1小時拒絕率
                "dayHashRate": "3352794785964.9",//24小時平均算力
                "dayStaleRate": "0.007917",//24小時延遲率
                "dayRejectRate": "0.009978",//24小時拒絕率
                "lastShareTime": 1748490153,//share最後提交時間
                "status": "online"//狀態 online在線、offline離線
            },
            ...
        ]
    },
    "success": true
}

獲取子賬號礦機算力圖

請求

POST /v2/sp/hashrate/worker/hashRateChart

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種縮寫，如，btc

subaccount

String

true

子賬號名稱

workerName

String

true

礦機名稱

timeLevel

String

false

day_30

hour_24：24小時 10分鐘數據 day_7：7天 1小時級別數據 day_30：30天天級別數據 day_90：90天天級別數據

正確響應：

{
    "code": 200,
    "msg": "Success",
    "t": 1748492183299,
    "data": [
        {
            "subaccount": "test",    //子賬號
            "workerName": "w-1",     //礦機名稱
            "hashRate": "3517727395943.1",    //算力
            "staleRate": "0.007917",    //延遲率
            "rejectRate": "0",          //拒絕率
            "secondTimestamp": 1745884800, //秒級時間戳
            "lastShareTime": 1745970909    //share最後提交時間
        },
        ...
    ],
    "success": true
}

獲取優先上鏈費用

請求

POST /v2/sp/txPriorityChain/getChainingFee

參數

參數名

參數類型

必填

默認值

描述

txHash

String

true

交易hash

informEmail

String

true

用戶郵箱

coin

String

true

btc

正確響應：

{
	"code": 200,
	"msg": "Success",
	"t": 1718250294397,
	"data": {
		"coin": "btc", //幣種
		"curTxSize": 110, //交易體積
		"unconfirmedPreTxSize": 110, //未確認交易體積
		"unit": "btc", //支付費用幣種
		"totalFee": 0.00009721, //實際支付費用
		"theoreticalPayAmount": 0.00003584, //理論支付費用
		"txHash": "d0b0c82931c5c34fccb1f4acd42cadc999450921a1a3925ba6dce20ce10598f9", //交易hash
		"informEmail": "[email protected]", //用戶郵箱
		"timeout": 6000 //下單過期時間 秒
	},
	"success": true
}

優先上鏈

請求

POST /v2/sp/txPriorityChain/submit

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

btc

txHash

String

true

交易hash

informEmail

String

true

用戶郵箱

curTxSize

Integer

true

當前交易體積

totalFee

BigDecimal

true

支付費用

正確響應：

{
	"code": 200,
	"msg": "Success",
	"t": 1718253030928,
	"data": {
		"coin": "btc", //幣種
		"txHash": "d0b0c82931c5c34fccb1f4acd42cadc999450921a1a3925ba6dce20ce10598f9", //交易hash
		"curTxSize": 110, //交易體積
		"unconfirmedPreTxSize": 110, //未確認交易體積
		"currency": "btc", //支付費用幣種
		"totalFee": 0.00009721, //實際支付費用
		"theoreticalPayAmount": 0.00003584, //理論支付費用
		"informEmail": "[email protected]", //用戶郵箱
		"status": 3, //訂單狀態 3: 已支付 4: 加速中 5: 已上鏈
		"createTime": 1718253029277 //下單時間
	},
	"success": true
}

優先上鏈訂單列表

請求

POST /v2/sp/txPriorityChain/queryOrderPage

參數

參數名

參數類型

必填

默認值

描述

pageNumber

Integer

true

當前頁

pageSize

Integer

true

每頁數量

正確響應：

{
	"code": 200,
	"msg": "Success",
	"t": 1718254361407,
	"data": {
		"total": 3,
		"list": [
			{
				"coin": "BTC", //幣種
				"txHash": "d0b0c82931c5c34fccb1f4acd42cadc999450921a1a3925ba6dce20ce10598f9", //交易hash
				"curTxSize": 110, //交易體積
				"unconfirmedPreTxSize": 110, //未確認交易體積
				"currency": "BTC", //支付費用幣種
				"totalFee": 0.00009721, //實際支付費用
				"theoreticalPayAmount": 0.00003584, //理論支付費用
				"informEmail": "[email protected]", //用戶郵箱
				"status": 5, //訂單狀態 3: 已支付 4: 加速中 5: 已上鏈
				"blockHeight": 847608, //區塊高度
				"blockTime": 1718185820, //爆塊時間
				"createTime": 1718253029000 //下單時間
			}
		]
	},
	"success": true
}

優先上鏈訂單詳情

請求

POST /v2/sp/txPriorityChain/orderDetail

參數

參數名

參數類型

必填

默認值

描述

txHash

String

true

交易hash

正確響應：

{
	"code": 200,
	"msg": "Success",
	"t": 1718253030928,
	"data": {
		"coin": "BTC", //幣種
		"txHash": "d0b0c82931c5c34fccb1f4acd42cadc999450921a1a3925ba6dce20ce10598f9", //交易hash
		"curTxSize": 110, //交易體積
		"unconfirmedPreTxSize": 110, //未確認交易體積
		"currency": "BTC", //支付費用幣種
		"totalFee": 0.00009721, //實際支付費用
		"theoreticalPayAmount": 0.00003584, //理論支付費用
		"informEmail": "[email protected]", //用戶郵箱
		"status": 3, //訂單狀態 3: 已支付 4: 加速中 5: 已上鏈
		"blockHeight": 847608, //區塊高度
		"blockTime": 1718185820, //爆塊時間
		"createTime": 1718253029277 //下單時間
	},
	"success": true
}

優先上鏈賬戶信息

請求

POST /v2/sp/txPriorityChain/accountInfo

參數

參數名

參數類型

必填

默認值

描述

正確響應：

{
	"code": 200,
	"msg": "Success",
	"t": 1718254872915,
	"data": [
		{
			"currency": "BTC", //幣種
			"availableBalance": 4.99882903, //可用余額
			"totalConsumeAmount": 0.00117097 //總消費金額
		}
	],
	"success": true
}

子帳戶起付額設定

請求

POST /v2/subaccount/updateUserMinimumPayment

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種

subaccount

String

true

子賬戶名

minimumPay

BigDecimal

true

起付額

正確響應：

{
    "code": "SUCCESS" // 设置成功 
}

取得子帳戶起付額

請求

POST /v2/subaccount/getUserMinimumPayment

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種

subaccount

String

true

子賬戶名

正確響應：

{ 
    "code": "SUCCESS", 
    "data": { 
        "minimumPayment":0.001 
    } 
}

查詢子賬號收益分配列表

請求

POST /v2/sp/incomeDistribute/userList

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種

subaccount

String

true

子賬戶名

正確響應：

{
	"code":200,
	"msg":"Success",
	"t":1740535004319,
	"data":[
		{
			"toSubAccount":"ceshi1",
			"percentage":"50",
			"remark":"ceshi"
		},
		{
			"toSubAccount":"ceshi23",
			"percentage":"15",
			"remark":"15"
		}
	],
	"success":true
}

移除子賬號收益分配

請求

POST /v2/sp/incomeDistribute/delete

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種

subaccount

String

true

子賬戶名

toSubAccount

String

true

接受收益的子賬戶

正確響應：

{
	"code":200,
	"msg":"Success",
	"t":1740535239034,
	"data":null,
	"success":true
}

新增&更新子賬號收益分配

請求

POST /v2/sp/incomeDistribute/upsert

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種

subaccount

String

true

子賬戶名

toSubAccount

String

true

接受收益的子賬戶

percentage

String

true

分成比例0.01-100

remark

String

false

最大長度20

正確響應：

{
	"code":200,
	"msg":"Success",
	"t":1740535239034,
	"data":null,
	"success":true
}

查詢子賬號收益分配剩餘百分比

請求

POST /v2/sp/incomeDistribute/remainingPercent

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種

subaccount

String

true

子賬戶名

正確響應：

{
	"code":200,
	"msg":"Success",
	"t":1740536889868,
	"data":7E+1,
	"success":true
}

棄用API

以下API待棄用，如仍在使用，請按說明切換到對應新接口。

獲取子賬號信息

已棄用，請使用獲取子賬號分頁列表-帶算力

請求 `AUTH`

POST /v2/subaccount/getSubaccountInfo

參數

參數名

參數類型

必填

默認值

描述

coin

String

false

幣種縮寫，如，btc

subaccount

String

false

子賬號名稱

isGetSubaccountDetailInfo

Boolean

false

是否查詳情

正確響應：

{
    "code": "SUCCESS", 
    "data": [
      {
        "coin": "btc",
        "subaccount": "test001",
        "walletAddress": "33Vxq5DN4vAXkv7swDp4zNZJWkazsDgwLq"
        "realtimeHashrate": "9789798686766", // 實時算力
        "avgHashrate1440": "88667987952", // 24小時平均算力
        "activeWorkerNum": 100,//在線礦工數
        "inactiveWorkerNum": 10//離線礦工數
      },
    ......
]
}

獲取子賬號算力詳細信息

已棄用，請使用获取子账号算力图

請求 `AUTH`

POST /v2/subaccount/getSubaccountHashrateDetailInfo

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種縮寫，如，btc、eth

subaccount

String

true

子賬號名稱

mode

String

false

hourly

mode=hourly表示24小時圖，mode=daily表示30天圖

正確響應：

{
    "code": "SUCCESS",
    "data": {
         "coin": "btc",
         "subaccount": "btc_test001",
         "startTime": 1569674700000,
         "timeInterval": 600, // 每條數據時間間隔，單位：秒，btc為600秒
         "hashrates": ["86989808092", "87758098015", "88708080889", "87167897971", ......]
    }
}

獲取子賬號礦工信息

已棄用，請使用獲取子賬號矿机列表

請求 `AUTH`

POST /v2/worker/getSubaccountWorkerDetailInfo

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種縮寫，如，btc

subaccount

String

true

子賬號名稱

正確響應：

{
  "code": "SUCCESS", 
  "data": [
    {
      "workerName": "test001",
      "realtimeHashrate": "2079080822",
      "avgHashrate1440": "20979879837", // 24小時平均算力
      "avgRejectrate1440": 0.001, // 24小時拒絕率
      "status": "active", // 狀態：active在線；inactive離線；lost失聯
      "lastShareTime": 1578653368 // 最新share時間
    },
    ......
]
}

獲取子賬號礦機算力詳細信息

已棄用，請使用獲取子賬號礦機算力圖

請求

POST /v2/worker/getSubaccountWorkerHashrateDetailInfo

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種縮寫，如，btc

subaccount

String

true

子賬號名稱

worker

String

true

礦機名稱

mode

String

false

hourly mode=hourly表示24小時圖，mode=daily表示30天圖（僅BTC支持）

正確響應：

{
    "code": "SUCCESS",
    "data": {
       	       "coin": "btc",
               "subaccount": "subaccount01",
                "worker": "test01",
      		"startTime": 1581742800000,
		"timeInterval": 1800,
		"hashrates": [
			"32369622321725",  // 平均算力 （H/s）
			"30336747489926"
		]
	}
}

拉取歷史算力數據

已棄用，請使用獲取子賬號歷史算力圖

請求

POST /v2/subaccount/getHashrate

參數

參數名

參數類型

必填

默認值

描述

coin

String

true

幣種

subaccount

String

true

子賬戶名

mode

String

true

day/hour

startTimestamp

Integer

true

秒級時間戳

endTimestamp

Integer

false

秒級時間戳

正確響應：

{ 
    "code": "SUCCESS", 
    "data": [ 
        { 
            "coin": "btc", 
            "userName": "test01", 
            "timestamp": 1709078400, 
            "shareAcceptDiff": 47710208, // 接受的難度 
            "shareRejectDiff": 47710208, // 拒絕的難度 
            "shareAcceptHashRate": 683045943484525.2, // 接受的算力（H/s） 
            "shareRejectHashRate": 683045943484525.2, // 拒絕的算力（H/s） 
            "rejectRate": 1, // 拒絕率 
        }, 
        ...... 
    ] 
}

最后更新于1个月前

接口地址

說明

註意

API

創建子賬號

請求 AUTH

修改子賬號

請求 AUTH

觀察者模式

請求 AUTH

獲取子賬號列表

請求 AUTH

獲取子賬號分页列表-带算力

請求 AUTH

獲取子賬號收益詳細信息

請求 AUTH

獲取子賬號支付記錄

請求 AUTH

獲取子賬號收益信息

請求 AUTH

獲取子賬號日收益信息

請求 AUTH

獲取子賬號小時收益信息

請求 AUTH

獲取昨日BTC塊收益與手續費收益比例

請求

獲取主賬號实时算力

請求

獲取子賬號實時算力

請求

獲取子賬號10分鐘、1小時、24小時算力

請求

獲取子賬號算力圖

請求

獲取子賬號歷史算力圖

請求

獲取子賬號在線/離線礦機數量

請求

獲取子賬號礦機列表

請求

獲取子賬號礦機算力圖

請求

獲取優先上鏈費用

請求

優先上鏈

請求

優先上鏈訂單列表

請求

優先上鏈訂單詳情

請求

優先上鏈賬戶信息

請求

子帳戶起付額設定

取得子帳戶起付額

查詢子賬號收益分配列表

移除子賬號收益分配

新增&更新子賬號收益分配

查詢子賬號收益分配剩餘百分比

棄用API

獲取子賬號信息

請求 AUTH

獲取子賬號算力詳細信息

請求 AUTH

獲取子賬號礦工信息

請求 AUTH

獲取子賬號礦機算力詳細信息

請求

拉取歷史算力數據

請求 `AUTH`

請求 `AUTH`

請求 `AUTH`

請求 `AUTH`

請求 `AUTH`

請求 `AUTH`

請求 `AUTH`

請求 `AUTH`

請求 `AUTH`

請求 `AUTH`

請求 `AUTH`

請求 `AUTH`

請求 `AUTH`