Comment
Author: Admin | 2025-04-28
帐户管理获取子帐户信息添加子帐户获取子帐户列表变更钱包地址新增观察者链接删除观察者链接小额提币暂停支付恢复支付更新起付额更新起付额值资产情况获取用户当前资产信息收支流水账单更新结算方式算力情况算力数据同时查询多帐户的算力数据算力历史数据（曲线数据）矿工列表矿工算力历史数据（曲线数据）算力分配算力分配信息查询算力分配订单查询算力分配结算查询分配算力给挖矿帐户终止算力分配订单收益分配收益分配信息查询分配收益给挖矿帐户取消算力分配记录矿池信息矿池出块分页时间范围内矿池出块用户pplns的收益详情f2pool API 支持通过 HTTPS 请求访问矿池服务，用户可通过网站设置页面获取 API token，或者联系我们的服务人员进行开通。API 认证F2P-API-SECRET Header 值为上一步获取的 API tokenContent-Type 为 application/json如：curl --request POST {url}--header 'Content-Type: application/json'--header 'F2P-API-SECRET: {token}'--data-raw '{"currency": "bitcoin","user_name": "xxx",...}'{url} 地址为 https://api.f2pool.com/v2/{request_name}当发生错误的时候，会返回给统一格式的数据{"code": {ERR_CODE},"msg": "错误类型: 错误描述"}API 中 currency 字段可取值支持：bitcoin,aleo,alephium,bells-mm,bitcion,bitcoin-cash,conflux,dash,elacoin,ethereum-classic,ethw,fractal-bitcoin,fractal-bitcoin-mm,hathor,ironfish,junkcoin,kadena,kaspa,litecoin,luckycoin,nervos,nexa,nmccoin,pepecoin,zcash,zen算力情况模块目前仅支持：bitcoin,bitcoin-cash,litecoin算力分配模块目前仅支持：bitcoin帐户管理公共结构ReadOnlyPage观察者链接数据名称类型备注解释keystring/mining-user-{currency}/{key} 为观察者链接 URIpermissionsstring不同权限以逗号隔开* 1 表示拥有矿工详情权限* 2 表示拥有收益列表包含支付信息权限* 3 表示拥有收益列表不包含支付信息权限page_namestring观察者链接备注Wallet钱包数据名称类型备注解释currencystring币种addressstring地址thresholdstring起付额名称类型备注解释keystringvaluestringMiningUserInfo挖矿子帐户数据名称类型备注解释mining_user_namestring子帐户名pagesReadOnlyPagerepeated观察者链接walletsWalletrepeated所有币种钱包信息descriptionstring子帐户备注WalletParams名称类型备注解释mining_user_namestring子帐户名walletsWalletrepeated钱包配置列表ResultsEntry名称类型备注解释keystringvaluestringWalletResp名称类型备注解释currencystring币种addressstring钱包地址resultstring成功/失败msgstring失败信息MiningUserWalletResp名称类型备注解释mining_user_namestring子帐户名wallet_resultWalletResprepeatedResultsEntry名称类型备注解释keystringvalueMiningUserWalletResp获取子帐户信息POST /v2/mining_user/get请求参数名称类型备注解释mining_user_namestring子账号名响应参数名称类型备注解释mining_user_namestring子帐户名pagesReadOnlyPagerepeated观察者链接walletsWalletrepeated所有币种钱包信息descriptionstring子帐户备注添加子帐户POST /v2/mining_user/add请求参数名称类型备注解释mining_user_namestring创建子帐户，帐户名必须在 2~15 个字符之间（数字和小写字母），以小写字母开头响应参数名称类型备注解释mining_user_namestring子帐户名pagesReadOnlyPagerepeated观察者链接walletsWalletrepeated所有币种钱包信息descriptionstring子帐户备注获取子帐户列表POST /v2/mining_user/list响应参数名称类型备注解释mining_user_listMiningUserInforepeated获取子帐户列表变更钱包地址POST /v2/mining_user/wallet/update请求参数名称类型备注解释paramsWalletParamsrepeated响应参数名称类型备注解释resultsResultsEntryrepeated新增观察者链接POST /v2/mining_user/read_only_page/add请求参数名称类型备注解释mining_user_namestring子帐户名page_namestring观察者链接备注permissionsstring权限配置，同 ReadOnlyPage响应参数名称类型备注解释mining_user_namestring子帐户名pageReadOnlyPage观察者链接删除观察者链接POST /v2/mining_user/read_only_page/delete请求参数名称类型备注解释mining_user_namestring子帐户名keystringReadOnlyPage 中的 key响应参数名称类型备注解释mining_user_namestring子帐户名小额提币POST /v2/mining_user/balance/withdraw请求参数名称类型备注解释mining_user_namestring子帐户名currencystring币种响应参数名称类型备注解释paid_timeint64支付时间戳暂停支付POST /v2/mining_user/payment/pause请求参数名称类型备注解释currencystring币种mining_user_namesstringrepeated子帐户名列表响应参数名称类型备注解释resultsResultsEntryrepeated结果恢复支付POST /v2/mining_user/payment/resume请求参数名称类型备注解释currencystring币种mining_user_namesstringrepeated子帐户名列表响应参数名称类型备注解释resultsResultsEntryrepeated结果更新起付额POST /v2/mining_user/threshold/update请求参数名称类型备注解释mining_user_namestring子帐户名currencystring币种thresholdstring请使用网站定义的合法值响应参数名称类型备注解释thresholdstring起付额更新起付额值POST /v2/mining_user/threshold/update_value请求参数名称类型备注解释mining_user_namestring子帐户名currencystring币种响应参数名称类型备注解释thresholdstring起付额资产情况公共结构BalanceInfo挖矿收益名称类型备注解释balancedouble当前余额（UTC 0 点之前） immature_balance double 当前未成熟余额（UTC 0 点之前） paiddouble已支付收益total_incomedouble总收益yesterday_incomedouble昨日收益estimated_today_incomedouble今日预估收益（根据算力预估）名称类型备注解释mining_dateint64产生收益日期时间戳settle_dateint64结算收益日期时间戳ppsdoublePPS 收益pps_fee_ratefloatPPS 矿池费率tx_feedouble矿工费奖励tx_fee_ratefloat矿工费部分的矿池费率hash_ratedouble当日平均算力名称类型备注解释valuedouble支出金额addressstring收款地址或收款子账号tx_idstring链上交易 IDpaid_timeint64支付时间戳wallet_typestring钱包类型（链上钱包或第三方钱包）tipdouble交易手续费TransactionItem名称类型备注解释idint64typestringchanged_balancedoublechanged_balance 大于 0 为收入， 小于 0 为支出created_atint64交易生成时间戳mining_extraMiningExtra收入明细payout_extraPayoutExtra支出明细获取用户当前资产信息POST /v2/assets/balance请求参数名称类型备注解释currencystringmining_user_namestring帐户名（用户名信息只能使用帐户名 mining_user_name 或钱包地址 wallet address 之一）addressstring钱包地址响应参数名称类型备注解释balance_infoBalanceInfo收支流水账单POST /v2/assets/transactions/list请求参数名称类型备注解释currencystring必填mining_user_namestring帐户名（用户名信息只能使用帐户名 mining_user_name 或钱包地址 wallet address 之一）addressstring钱包地址typestring多个类型以 "," 分割- all 全部- revenue 挖矿收益- reward 活动奖励或补偿- dividend 股份分成- flash_exchange 闪兑- payout 支出返回值中有更详细的账目类型以实际业务为准start_timeint64开始时间戳end_timeint64结束时间戳响应参数名称类型备注解释transactionsTransactionItemrepeated更新结算方式POST /v2/assets/settle_mode/switch请求参数名称类型备注解释currencystring币种modestring模式mining_user_namestring子账户activated_atint64生效时间响应参数名称类型备注解释modestringactivated_atint64生效时间算力情况公共结构HashRateInfo名称类型备注解释namestring帐户名，或者矿工名hash_ratedouble实时算力h1_hash_ratedouble过去 1 小时平均算力h24_hash_ratedouble过去 24 小时平均算力h1_stale_hash_ratedouble过去 1 小时平均拒绝算力h24_stale_hash_ratedouble过去 24 小时平均拒绝算力h24_delay_hash_ratedouble过去 24 小时延迟算力local_hash_ratedouble实时本地算力h24_local_hash_ratedouble过去 24 小时本地平均算力MiningHistoryItem名称类型备注解释timestampint64时间戳hash_ratedouble算力stale_hash_ratedouble拒绝算力delay_hash_ratedouble延迟算力local_hash_ratedouble本地算力normal_rewarddouble算力对应收益delay_rewarddouble延迟算力对应收益online_minersuint32在线矿机数UserMiningReq名称类型备注解释mining_user_namestring帐户名（用户名信息只能使用帐户名 mining_user_name 或钱包地址 wallet address 之一）addressstring钱包地址currencystring币种WorkerMiningInfo名称类型备注解释hash_rate_infoHashRateInfo算力信息last_share_atint64最近一次算力提交时间戳statusWorkerStatus当前状态hoststringIP 地址算力数据POST /v2/hash_rate/info请求参数名称类型备注解释mining_user_namestring帐户名（用户名信息只能使用帐户名 mining_user_name 或钱包地址 wallet address 之一）addressstring钱包地址currencystring币种响应参数名称类型备注解释infoHashRateInfo算力信息currencystring币种同时查询多帐户的算力数据POST /v2/hash_rate/info_list请求参数名称类型备注解释reqsUserMiningReqrepeated需要查询的子帐户名或匿名地址列表，最多 100响应参数名称类型备注解释infoHashRateInforepeated算力历史数据（曲线数据）POST /v2/hash_rate/history请求参数名称类型备注解释mining_user_namestring帐户名（用户名信息只能使用帐户名 mining_user_name 或钱包地址 wallet address 之一）addressstring钱包地址currencystring币种intervalint64单位为秒，间隔应该是 10 分钟的倍数durationint64单位为秒，时长最多是30天响应参数名称类型备注解释historyMiningHistoryItemrepeated历史数据矿工列表POST /v2/hash_rate/worker/list请求参数名称类型备注解释mining_user_namestring帐户名（用户名信息只能使用帐户名 mining_user_name 或钱包地址 wallet address 之一）addressstring钱包地址currencystring币种响应参数名称类型备注解释workersWorkerMiningInforepeated矿机列表矿工算力历史数据（曲线数据）POST /v2/hash_rate/worker/history请求参数名称类型备注解释mining_user_namestring帐户名（用户名信息只能使用帐户名 mining_user_name 或钱包地址 wallet address 之一）addressstring钱包地址currencystring币种worker_namestring矿机名称intervalint64单位为秒，间隔应该是 10 分钟的倍数durationint64单位为秒，时长最多是3天响应参数名称类型备注解释historyMiningHistoryItemrepeated算力分配公共结构HashRateDistributionOrder请求算力分配订单名称类型备注解释idint64start_dateint64开始时间戳end_dateint64结束时间戳（必须大于开始时间）distributorstring分配算力的挖矿帐户recipientstring算力接受者的挖矿帐户hash_ratedouble算力terminate_atint64如果提前结束了订单，那么会有值，否则为 0HashRateDistributionSettlement名称类型备注解释idint64orderHashRateDistributionOrder订单hashesdouble注意这里是 hash 数，而不是算力incomedouble所得收益timestampint64算力分配结算时间戳算力分配信息查询POST /v2/hash_rate/distribution/info请求参数名称类型备注解释currencystring币种distributorstring分配算力的挖矿帐户recipientstring算力接受者的挖矿帐户start_dateint64开始时间戳end_dateint64结束时间戳（必须大于开始时间）hash_ratedouble算力值响应参数名称类型备注解释current_hash_ratedouble总算力sold_hash_ratedouble已分配出去的算力remaining_hash_ratedouble剩余算力算力分配订单查询POST /v2/hash_rate/distribution/orders请求参数名称类型备注解释currencystring币种distributorstring分配算力的挖矿帐户响应参数名称类型备注解释ordersHashRateDistributionOrderrepeated算力分配结算查询POST /v2/hash_rate/distribution/settlements请求参数名称类型备注解释currencystring币种distributorstring分配算力的挖矿帐户响应参数名称类型备注解释settlementsHashRateDistributionSettlementrepeated分配算力给挖矿帐户POST /v2/hash_rate/distribute请求参数名称类型备注解释currencystring币种distributorstring分配算力的挖矿帐户recipientstring算力接受者的挖矿帐户start_dateint64开始时间戳end_dateint64结束时间戳（必须大于开始时间）hash_ratedouble算力值响应参数名称类型备注解释orderHashRateDistributionOrder终止算力分配订单POST /v2/hash_rate/distribution/terminate请求参数名称类型备注解释order_idint64响应参数名称类型备注解释reasonstring收益分配公共结构RevenueDistribution名称类型备注解释idstringidcurrencystring币种distributorstring分配收益的挖矿帐户recipientstring收益接受者的挖矿帐户descriptionstring描述proportiondouble比例收益分配信息查询POST /v2/revenue/distribution/info请求参数名称类型备注解释currencystring币种distributorstring分配收益的挖矿帐户recipientstring收益接受者的挖矿帐户响应参数名称类型备注解释dataRevenueDistributionrepeated配置列表分配收益给挖矿帐户POST /v2/revenue/distribution/add请求参数名称类型备注解释currencystring币种distributorstring分配收益的挖矿帐户recipientstring收益接受者的挖矿帐户descriptionstring描述proportiondouble比例响应参数名称类型备注解释idstringidcurrencystring币种distributorstring分配收益的挖矿帐户recipientstring收益接受者的挖矿帐户descriptionstring描述proportiondouble比例取消算力分配记录POST /v2/revenue/distribution/delete请求参数名称类型备注解释idint64distributorstring分配收益的挖矿帐户响应参数名称类型备注解释reasonstring矿池信息公共结构LuckyEntry名称类型备注解释keystringvaluefloatBlock名称类型备注解释heightint64block_hashstringbase_rewarddoubletotal_rewarddoubletimestampint64settle_timestampint64矿池出块分页POST /v2/blocks/paging请求参数名称类型备注解释pageint32pagesizeint32currencystring币种响应参数名称类型备注解释luckyLuckyEntryrepeatedblocklistBlockrepeatedsumint32时间范围内矿池出块POST /v2/blocks/date_range请求参数名称类型备注解释start_timeint64end_timeint64currencystring币种响应参数名称类型备注解释luckyLuckyEntryrepeatedblocklistBlockrepeatedsumint32用户pplns的收益详情POST /v2/blocks/user请求参数名称类型备注解释currencystring币种mining_user_namestring用户mining_rewardint64收益start_timeint64开始时间end_timeint64结束时间响应参数名称类型备注解释blocklistBlockrepeated
Add Comment