Documentation
PoolNode Fee, Revenue, and Subaccount API
PoolNode fee-account, revenue, payout address, small-withdrawal, subaccount fee, and rebate administration endpoints.
PoolNode Fee, Revenue, and Subaccount API
These calls are used by PoolNode administration inside RustMinerSystem. Email codes, revenue addresses, and withdrawals are sensitive; automation must not log verification codes or complete wallet addresses.
Fee-account registration
Send registration mail:
POST /api/poolnode/send/mail
{
"address": "[email protected]",
"token": "<captcha or verification token>"
}
Register or verify the account:
POST /api/poolnode/user/login
{
"email": "[email protected]",
"code": "123456"
}
Project coin fee
POST /api/poolnode/project/config
{
"email": "[email protected]",
"coin": "PI-BTC",
"r": 0.01
}
r is a 0–1 fraction; 0.01 means 1%.
Revenue and records
| Method | Path | Main body fields |
|---|---|---|
| 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. |
The frontend recognizes all, yesterday, paid, and unpaid profit states. Reward and payout lists use:
{
"records": [],
"total": 0,
"page_no": 1
}
Update payout address
Send a user-email code:
POST /api/poolnode/send/user/mail
{
"address": "[email protected]",
"token": "<captcha or verification token>"
}
Save the payout address and threshold:
POST /api/poolnode/update/address
{
"email": "[email protected]",
"code": "123456",
"coin": "PI-BTC",
"amount": "0.01",
"address": "<payout wallet>"
}
The current frontend submits amount as a string.
Small withdrawal
| Method | Path | Body |
|---|---|---|
| POST | /api/poolnode/withdrawal/can/apply |
{ email, coin }; check eligibility. |
| POST | /api/poolnode/withdrawal/logs |
{ email, coin }; read request history. |
| POST | /api/poolnode/withdrawal/submit |
{ email, coin }; submit a request. |
The frontend interprets eligibility as [status, payload]. With status=0, payload is available balance; with status=-3, it is the next application time.
Subaccount fees
Query subaccounts:
POST /api/poolnode/subaccount/configs
{
"page": 1,
"size": 20,
"coin": "PI-BTC",
"name": "<optional subaccount filter>"
}
Set a subaccount fee:
POST /api/poolnode/subaccount/config
{
"sid": 1,
"coin": "PI-BTC",
"action": 0,
"r": 0.01
}
Set a subaccount rebate:
POST /api/poolnode/subaccount/rebate
{
"sid": 1,
"coin": "PI-BTC",
"email": "[email protected]",
"action": 0,
"r": 0.005
}
Currency parameters use PoolNode codes: BTC is normally PI-BTC, and LTC is VA-LTC.
