RustMinerSystem

文档

PoolNode 费率、收益与子账号 API

PoolNode 节点费率账号、收益、支付地址、小额提现、子账号费率与返佣管理接口。

PoolNode 费率、收益与子账号 API

本章接口由 RustMinerSystem 的 PoolNode 管理后台调用。邮箱验证码、收益地址和提现属于敏感操作，自动化程序必须避免记录验证码和完整钱包地址。

费率账号注册

发送注册邮件：

POST /api/poolnode/send/mail

{
  "address": "[email protected]",
  "token": "<验证码/人机验证 token>"
}

注册或验证账号：

POST /api/poolnode/user/login

{
  "email": "[email protected]",
  "code": "123456"
}

节点币种费率

POST /api/poolnode/project/config

{
  "email": "[email protected]",
  "coin": "PI-BTC",
  "r": 0.01
}

r 使用 0–1 小数，0.01 表示 1%。

收益汇总和记录

方法 路径 主要主体字段
POST /api/poolnode/profit email, coin。
POST /api/poolnode/address/info email。
POST /api/poolnode/rewards email, coin, page, size。
POST /api/poolnode/payouts email, coin, page, size。

profit 前端识别 all、yesterday、paid、unpaid 状态。收益和支付列表读取：

{
  "records": [],
  "total": 0,
  "page_no": 1
}

修改收益地址

发送用户邮箱验证码：

POST /api/poolnode/send/user/mail

{
  "address": "[email protected]",
  "token": "<验证码/人机验证 token>"
}

保存地址和起付金额：

POST /api/poolnode/update/address

{
  "email": "[email protected]",
  "code": "123456",
  "coin": "PI-BTC",
  "amount": "0.01",
  "address": "<收益钱包地址>"
}

amount 在当前前端中作为字符串提交。

小额提现

方法 路径 主体
POST /api/poolnode/withdrawal/can/apply { email, coin }，查询是否可申请。
POST /api/poolnode/withdrawal/logs { email, coin }，查询申请记录。
POST /api/poolnode/withdrawal/submit { email, coin }，提交申请。

资格查询在当前前端中被解释为数组 [status, payload]。status=0 时 payload 是可提现余额，status=-3 时 payload 是下一次可申请时间。

子账号费率

查询子账号：

POST /api/poolnode/subaccount/configs

{
  "page": 1,
  "size": 20,
  "coin": "PI-BTC",
  "name": "<可选子账号筛选>"
}

设置子账号费率：

POST /api/poolnode/subaccount/config

{
  "sid": 1,
  "coin": "PI-BTC",
  "action": 0,
  "r": 0.01
}

设置子账号返佣：

POST /api/poolnode/subaccount/rebate

{
  "sid": 1,
  "coin": "PI-BTC",
  "email": "[email protected]",
  "action": 0,
  "r": 0.005
}

币种参数沿用 PoolNode 节点代码，例如 BTC 通常使用 PI-BTC，LTC 使用 VA-LTC。