礦池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" 為操作成功,其余失敗

● 請求示例

    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);

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

1

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

pageNumber

Integer

false

1

頁數

pageSize

Integer

false

10

每頁數量

  • 正確響應:

{
    "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

0

查詢起始時間戳(秒)

endTimestamp

Integer

false

當前時間 查詢結束時間戳(秒)

pageNumber

Integer

false

1

頁號

pageSize

Integer

false

10

每頁展示條數

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

0

查詢起始時間戳(毫秒)

endTimestamp

Integer

false

当前时间

查詢結束時間戳(毫秒)

pageNumber

Integer

false

1

頁號

pageSize

Integer

false

10

每頁展示條數

  • 正確響應:

{
    "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

1

頁數

pageSize

Integer

false

10

每頁條數

  • 正確響應:

{
    "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, // 拒絕率 
        }, 
        ...... 
    ] 
}

最后更新于