# 礦池API 基礎信息 ### 接口地址 ● 密鑰獲取方式 a. 登錄官網在個人中心下面能看到"獲取API密鑰"入口，点击获取后请保存好您的私钥。 ● 線上環境 a. 官網線上：; ### 說明 ● H、KH、MH、GH、TH、PH、EH，算力單位間相差1000 ### 註意 ● 所有接口采用私鑰簽名，公鑰驗簽的方式請求 ● 統一請求格式 ```json { "dataJson": "", "accessKey": "", "timestamp": 1628381288000, "sign": "" } ``` ● 如訪問/v2/addUser接口 ```json { "dataJson": "{"userName":"test001","password":"123456"}", "accessKey": "D1504708600B44B499489C16CE7C32A5", "timestamp": 1628381288000, "sign": "N0n0iqKLUtssteqhbsOHGv2N7UaJh+YnPio90fciAM4hn2L82jAhafG/ynxdgFnBf2ZJ2R2C1d0uRvSNSHnEJKA8rvMx6ytQa2E4gpD8LG0kkdzYwgv9pyEFOGsS4+cUdV+nF/WJiPDRqfx8Cb0gPjBuCj+HboVx5++HOe2v+sA=" } ``` ● 統一返回格式 ```json { "code": "", "msg": "", "data": object, } ``` **code="SUCCESS"** 為操作成功，其余失敗 ● 請求示例 {% tabs %} {% tab title="Java" %} {% file src="" %} ``` 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 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); ``` {% endtab %} {% tab title="Python" %} ``` 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) ``` {% endtab %} {% tab title="Node" %} ``` 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(); ``` {% endtab %} {% tab title="Php" %} ``` $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'); ``` {% endtab %} {% endtabs %} ## API ### 創建子賬號 備註：建立BTC子帳號會同時建立FB子帳號，但建立FB子帳號不會同時建立BTC子帳號 #### **請求 `AUTH`** `POST /v2/subaccount/createSubaccount` **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種，如，btc、fb
subaccountStringtrue-子賬號(5～20由小寫字母數字組成的)
walletAddressStringfalse-錢包地址(請根據鏈環境填符合規則的地址)
* 正確響應： ```json { "code": "SUCCESS" } ``` * 錯誤響應： ```json { "code": "......", // INVALID_SUBACCOUNT / SUBACCOUNT_EXIST / IVAILD_WALLETADDRESS "msg": "......" } ``` ### 修改子賬號 #### **請求 `AUTH`** `POST /v2/subaccount/modifyWalletAddress` **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如，btc、fb
subaccountStringtrue-子賬號名稱
newWalletAddressStringtrue-新的錢包地址(請根據鏈環境填符合規則的地址)
* 正確響應： ```json { "code": "SUCCESS" } ``` * 錯誤響應： ```json { "code": "......", // INVALID_SUBACCOUNT / SUBACCOUNT_EXIST / IVAILD_WALLETADDRESS "msg": "......" } ``` ### 觀察者模式 #### **請求 `AUTH`** `POST /v2/subaccount/subAccountObserverLink` **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如，btc、fb
subaccountStringtrue-子賬號名稱
typeStringtrue-類型：newSign 新增、resetSign 重置、deleteSign 刪除
* 正確響應： ```json { "code":"SUCCESS", "data":{ "subaccount":"btctestchizg002", "sign":"v92480670d100d4c67f9e22d6ae612fd3e78aebb6e1b1fcdba994ba454ade6482", "coin":"btc" } } ``` * 錯誤響應： ```json { "code": "......", // INVALID_SUBACCOUNT / SUBACCOUNT_EXIST / IVAILD_WALLETADDRESS "msg": "......" } ``` ### 獲取子賬號列表 #### **請求 `AUTH`** `POST /v2/sp/subaccount/list` **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如，btc、ltc、etc
* 正確響應： ```json { "code": 200, "msg": "Success", "t": 1748485449635, "data": [ { "subaccount": "test", "coin": "btc", "withdrawAddress": "3CBZ7ayUBz8cUiGfA3F5Fcgo2RQdKYPk94" }, ... ], "success": true } ``` ### 獲取子賬號分页列表-带算力 #### **請求 `AUTH`** `POST /v2/sp/subaccount/pageWithHashRate` **參數**
參數名參數類型必填默認值描述
coinStringfalse-幣種縮寫，如btc、ltc
subaccountStringfalse-子賬號，支持模糊查詢
showStatusIntegerfalse10:隱藏子賬號,1:顯示
pageNumberIntegerfalse1頁數
pageSizeIntegerfalse10每頁數量
* 正確響應： ```json { "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` **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如btc、ltc
subaccountStringtrue-子賬號名稱
startTimestampIntegerfalse0查詢起始時間戳（秒）
endTimestampIntegerfalse當前時間 查詢結束時間戳（秒）
pageNumberIntegerfalse1頁號
pageSizeIntegerfalse10每頁展示條數
bizTypeStringfalsealone_mining业务类型（fb币种使用）。alone_mining：单挖；join_mining：双挖
* 正確響應： ```json { "code": "SUCCESS", "data": { "total": 35, "dayProfitList": [ { "dayDate": 1569600000000, "avgHashrate": "90057979829", "dayProfit": 0.647981779, }, ...... ] } } ``` ### 獲取子賬號支付記錄 #### **請求 `AUTH`** `POST /v2/subaccount/getSubaccountPaymentRecord` **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如btc、ltc
subaccountStringtrue-子賬號名稱
startTimestampIntegerfalse0查詢起始時間戳（毫秒）
endTimestampIntegerfalse当前时间查詢結束時間戳（毫秒）
pageNumberIntegerfalse1頁號
pageSizeIntegerfalse10每頁展示條數
* 正確響應： ```json { "code": "SUCCESS", "data": { "list": [ { "paymentDate": 1564531200000, // 支付時間 "paymentAddress": "mv8W2k7UMkqbHbfbvRXcEzaehPGvZCmkV5" // 支付地址 "paymentMoney": 0.0666348000, // 支付金額 "txId": "097a39595c261f141de2174d8639fd9c18122236b14f9d08c91e82aea2a87e61" // 交易Id } ], "total": 1 // 總記錄數 } } ``` ### 獲取子賬號收益信息 #### **請求 `AUTH`** `POST /v2/subaccount/getSubaccountProfitInfo` **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如btc、ltc
subaccountStringtrue-子賬號名稱
bizTypeStringfalsealone_mining业务类型（fb币种使用）。alone_mining：单挖；join_mining：双挖
* 正確響應： ```json { "code": "SUCCESS", "data": { "yesterdayProfit": 0.61505330, // 24小時收益 "unpaidProfit": 0.57536600, // 未支付收益 "totalProfit": 26.026078521, // 總收益 "dayEstimateProfit": 0.57536600 // 今日收益。fb币种不支持此数据 } } ``` ### 獲取子賬號日收益信息 #### **請求 `AUTH`** `POST` /v2/sp/subaccount/getDayProfitDetailInfo **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如btc、ltc
subaccountStringtrue-子賬號名稱
timeStampinttrue秒級時間戳 UTC+0
bizTypeStringfalsealone_mining业务类型（fb币种使用）。alone_mining：单挖；join_mining：双挖
* 正確響應： ```json { "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 **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如btc、ltc
subaccountStringtrue-子賬號名稱
timeStampinttrue秒級時間戳
* 正確響應： ```json { "code": 200, "msg": "Success", "t": 1717677390714, "data": { "day": 1716861600, "coin": "btc", "userName": "test", "ppsDayProfit": 0.00000021294606027776 // PPS收益 } } ``` ### 獲取昨日BTC塊收益與手續費收益比例 #### **請求** `POST` /v2/subaccount/getFPPSRate **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如btc、ltc
dayIntfalse-時間（秒）
* 正確響應： ```json { "code":"SUCCESS", "data":{ "rate":"0.0329531088", "day":1711324800, "coin":"btc" } } ``` ### 獲取主賬號实时算力 #### **請求** `POST /v2/sp/hashrate/user/realHashRate` **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如btc、ltc
* 正確響應： ```json { "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` **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如btc、ltc
subaccountStringtrue-子賬號名稱
* 正確響應： ```json { "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` **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如btc、ltc
subaccountStringtrue-子賬號名稱
* 正確響應： ```json { "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` **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如btc、ltc
subaccountStringtrue-子賬號名稱
timeLevelStringfalseday_30hour_24：24小時 10分鐘數據
day_7：7天 1小時級別數據
day_30：30天 天級別數據
day_90：90天 天級別數據
* 正確響應： ```json { "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` **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如btc、ltc
subaccountStringtrue-子賬號名稱
timeLevelStringfalsedayday：天級別數據，最近一年數據
hour：小時級別數據，最近30天數據
startTimestampLongtrue秒級時間戳
endTimestampLongtrue秒級時間戳
* 正確響應： ```json { "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` **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如btc、ltc
subaccountStringtrue-子賬號名稱
* 正確響應： ```json { "code": 200, "msg": "Success", "t": 1748488319658, "data": { "subaccount": "test", "totalWorkerCount": 1000, //總礦機數 "onlineWorkerCount": 903, //在線礦機數 "offlineWorkerCount": 97 //離線礦機數 }, "success": true } ``` ### 獲取子賬號礦機列表 #### **請求** `POST /v2/sp/hashrate/worker/list` **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如btc、ltc
subaccountStringtrue-子賬號名稱
workerNameStringfalse-礦機名稱，支持模糊查詢
sortFieldStringfalseworker_name排序字段，
worker_name：礦機名
minute_hash_rate：10分鐘算力
day_hash_rate：24小時算力
day_stale_rate：24小時延遲率
day_reject_rate：24小時拒絕率
share_time：share最後提交時間
sortRuleStringfalseascasc：正序
desc：倒序
statusStringfalse-online：在線
offline：離線
pageNumIntegerfalse1頁數
pageSizeIntegerfalse10每頁條數
* 正確響應： ```json { "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` **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如，btc
subaccountStringtrue-子賬號名稱
workerNameStringtrue礦機名稱
timeLevelStringfalseday_30hour_24：24小時 10分鐘數據
day_7：7天 1小時級別數據
day_30：30天 天級別數據
day_90：90天 天級別數據
* 正確響應： ```json { "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 } ``` ### 獲取子賬號礦機日share數量 #### **請求** `POST /v2/sp/hashrate/worker/dailyShareCount` **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如btc
subaccountStringtrue-子賬號名稱
timeStampinttrue-秒級時間戳 UTC+0
pageNumIntegerfalse1頁數
pageSizeIntegerfalse10每頁條數，最大1000
* 正確響應： ```json { "code": 200, "msg": "Success", "t": 1768210318542, "data": { "total": 1000, "pageNum": 1, "pageSize": 10, "pages": 100, "records": [ { "coin": "btc", "day": 1764547200, "workerName": "w-1", "acceptShareNumber": 418, // 有效share数量 "rejectShareNumber": 1, // 拒绝share数量 "staleShareNumber": 2 // 延迟share数量 }, ... ] }, "success": true } ``` ### 獲取優先上鏈費用 #### **請求** `POST` /v2/sp/txPriorityChain/getChainingFee **參數**
參數名參數類型必填默認值描述
txHashStringtrue交易hash
informEmailStringtrue用戶郵箱
coinStringtruebtc
* 正確響應： ```json { "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": "test@test.com", //用戶郵箱 "timeout": 6000 //下單過期時間 秒 }, "success": true } ``` ### 優先上鏈 #### **請求** `POST` /v2/sp/txPriorityChain/submit **參數**
參數名參數類型必填默認值描述
coinStringtrue btc
txHashStringtrue交易hash
informEmailStringtrue用戶郵箱
curTxSizeIntegertrue當前交易體積
totalFeeBigDecimaltrue支付費用
* 正確響應： ```json { "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": "test@test.com", //用戶郵箱 "status": 3, //訂單狀態 3: 已支付 4: 加速中 5: 已上鏈 "createTime": 1718253029277 //下單時間 }, "success": true } ``` ### 優先上鏈訂單列表 #### **請求** `POST` /v2/sp/txPriorityChain/queryOrderPage **參數**
參數名參數類型必填默認值描述
pageNumberIntegertrue當前頁
pageSizeIntegertrue每頁數量
* 正確響應： ```json { "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": "test@test.com", //用戶郵箱 "status": 5, //訂單狀態 3: 已支付 4: 加速中 5: 已上鏈 "blockHeight": 847608, //區塊高度 "blockTime": 1718185820, //爆塊時間 "createTime": 1718253029000 //下單時間 } ] }, "success": true } ``` ### 優先上鏈訂單詳情 #### **請求** `POST` /v2/sp/txPriorityChain/orderDetail **參數**
參數名參數類型必填默認值描述
txHashStringtrue交易hash
* 正確響應： ```json { "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": "test@test.com", //用戶郵箱 "status": 3, //訂單狀態 3: 已支付 4: 加速中 5: 已上鏈 "blockHeight": 847608, //區塊高度 "blockTime": 1718185820, //爆塊時間 "createTime": 1718253029277 //下單時間 }, "success": true } ``` ### 優先上鏈賬戶信息 #### **請求** `POST` /v2/sp/txPriorityChain/accountInfo **參數**
參數名參數類型必填默認值描述
* 正確響應： ```json { "code": 200, "msg": "Success", "t": 1718254872915, "data": [ { "currency": "BTC", //幣種 "availableBalance": 4.99882903, //可用余額 "totalConsumeAmount": 0.00117097 //總消費金額 } ], "success": true } ``` ### 交易廣播 #### **請求** `POST` /v2/sp/txPriorityChain/submitRawTransaction **參數**
參數名參數類型必填默認值描述
coinStringtrue btc
rawTransactionListListtrue原始交易list
isPrivateboolfalsefalse私有交易不會廣播給其他節點
* 正確響應： ```json { "code": 200, "msg": "Success", "t": 1751597387279, "data": ["hash1", "hash2"], //廣播成功的交易id "success": true } ``` ### 查詢子賬號收益分配列表 **請求** `POST` /v2/sp/incomeDistribute/userList **參數**
參數名參數類型必填默認值描述
coinStringtrue幣種
subaccountStringtrue子賬戶名
* 正確響應： ```json { "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 **參數**
參數名參數類型必填默認值描述
coinStringtrue幣種
subaccountStringtrue子賬戶名
toSubAccountStringtrue接受收益的子賬戶
* 正確響應： ```json { "code":200, "msg":"Success", "t":1740535239034, "data":null, "success":true } ``` ### 新增&更新子賬號收益分配 **請求** `POST` /v2/sp/incomeDistribute/upsert **參數**
參數名參數類型必填默認值描述
coinStringtrue幣種
subaccountStringtrue子賬戶名
toSubAccountStringtrue接受收益的子賬戶
percentageStringtrue分成比例0.01-100
remarkStringfalse最大長度20
* 正確響應： ```json { "code":200, "msg":"Success", "t":1740535239034, "data":null, "success":true } ``` ### 查詢子賬號收益分配剩餘百分比 **請求** `POST` /v2/sp/incomeDistribute/remainingPercent **參數**
參數名參數類型必填默認值描述
coinStringtrue幣種
subaccountStringtrue子賬戶名
* 正確響應： ```json { "code":200, "msg":"Success", "t":1740536889868, "data":7E+1, "success":true } ``` ### 查詢子賬號收益分配轉入記錄 **請求** `POST` /v2/sp/incomeDistribute/transferIncome **參數**
參數名參數類型必填默認值描述
coinStringtrue幣種
subaccountStringtrue子賬戶名
timestampIntegertrueUTC+0 0點秒級時間戳
* 正確響應： ```json { "code": 200, "msg": "Success", "t": 1758533264479, "data": [{ "subaccount": "test2", "coin": "btc", "amount": "0.0000091000", "timestamp": 1757899834, "address": "tb1q……mz7t" }], "success": true } ``` ## 棄用API 以下API待棄用，如仍在使用，請按說明切換到對應新接口。 ### 獲取子賬號信息 已棄用，請使用 [獲取子賬號分頁列表-帶算力](#huo-qu-zi-zhang-hao-fen-ye-lie-biao-dai-suan-li) #### **請求 `AUTH`** `POST /v2/subaccount/getSubaccountInfo` **參數**
參數名參數類型必填默認值描述
coinStringfalse-幣種縮寫，如，btc
subaccountStringfalse-子賬號名稱
isGetSubaccountDetailInfoBooleanfalse-是否查詳情
* 正確響應： ```json { "code": "SUCCESS", "data": [ { "coin": "btc", "subaccount": "test001", "walletAddress": "33Vxq5DN4vAXkv7swDp4zNZJWkazsDgwLq" "realtimeHashrate": "9789798686766", // 實時算力 "avgHashrate1440": "88667987952", // 24小時平均算力 "activeWorkerNum": 100,//在線礦工數 "inactiveWorkerNum": 10//離線礦工數 }, ...... ] } ``` ### 獲取子賬號算力詳細信息 已棄用，請使用 [获取子账号算力图](#huo-qu-zi-zhang-hao-suan-li-tu) #### **請求 `AUTH`** `POST /v2/subaccount/getSubaccountHashrateDetailInfo` **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如，btc、eth
subaccountStringtrue-子賬號名稱
modeStringfalsehourlymode=hourly表示24小時圖，mode=daily表示30天圖
* 正確響應： ```json { "code": "SUCCESS", "data": { "coin": "btc", "subaccount": "btc_test001", "startTime": 1569674700000, "timeInterval": 600, // 每條數據時間間隔，單位：秒，btc為600秒 "hashrates": ["86989808092", "87758098015", "88708080889", "87167897971", ......] } } ``` ### 獲取子賬號礦工信息 已棄用，請使用 [獲取子賬號矿机列表](#huo-qu-zi-zhang-hao-kuang-ji-lie-biao) #### **請求 `AUTH`** `POST /v2/worker/getSubaccountWorkerDetailInfo` **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如，btc
subaccountStringtrue-子賬號名稱
* 正確響應： ```json { "code": "SUCCESS", "data": [ { "workerName": "test001", "realtimeHashrate": "2079080822", "avgHashrate1440": "20979879837", // 24小時平均算力 "avgRejectrate1440": 0.001, // 24小時拒絕率 "status": "active", // 狀態：active在線；inactive離線；lost失聯 "lastShareTime": 1578653368 // 最新share時間 }, ...... ] } ``` ### 獲取子賬號礦機算力詳細信息 已棄用，請使用 [獲取子賬號礦機算力圖](#huo-qu-zi-zhang-hao-kuang-ji-suan-li-tu) #### **請求** `POST /v2/worker/getSubaccountWorkerHashrateDetailInfo` **參數**
參數名參數類型必填默認值描述
coinStringtrue-幣種縮寫，如，btc
subaccountStringtrue-子賬號名稱
workerStringtrue-礦機名稱
modeStringfalsehourly mode=hourly表示24小時圖，mode=daily表示30天圖（僅BTC支持）
* 正確響應： ```json { "code": "SUCCESS", "data": { "coin": "btc", "subaccount": "subaccount01", "worker": "test01", "startTime": 1581742800000, "timeInterval": 1800, "hashrates": [ "32369622321725", // 平均算力 （H/s） "30336747489926" ] } } ``` ### 拉取歷史算力數據 已棄用，請使用 [獲取子賬號歷史算力圖](#huo-qu-zi-zhang-hao-li-shi-suan-li-tu) **請求** `POST` /v2/subaccount/getHashrate **參數**
參數名參數類型必填默認值描述
coinStringtrue幣種
subaccountStringtrue子賬戶名
modeStringtrueday/hour
startTimestampIntegertrue秒級時間戳
endTimestampIntegerfalse秒級時間戳
* 正確響應： ```json { "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, // 拒絕率 }, ...... ] } ```