In my previous article, we concluded that:
To calculate estimated account value, we need to get items from these four parts:
- The assets in wallet( And in SAVINGS)
- The assets in internal market
- The assets(SBD) in conversion processes
- The assets(rewards) to be claimed
I will explain how to get them in this article.
The assets in wallet( And in SAVINGS)
The following assets need to be fetched.
- STEEM
- STEEM POWER
- STEEM DOLLARS
- STEEM in SAVINGS
- STEEM DOLLARS in SAVINGS
There is a API named get_accounts will retrieve the account information which contained the above items.
vector< extended_account > get_accounts( vector< string > names ) const;
To retrieve them we need to put the account name into list, and then call API with this list as arguments. We can read the item value from the result using the corresponding key.
| Item | Key |
|---|---|
| STEEM | balance |
| STEEM POWER | vesting_shares |
| STEEM DOLLARS | sbd_balance |
| STEEM in SAVINGS | savings_balance |
| STEEM DOLLARS in SAVINGS | savings_sbd_balance |
An additional note, STEEM POWER was expressed in the form of VESTS, we need to convert it to equivalent STEEM.
The assets in internal market
To simplify the problem, In order to simplify the problem, we define two type of operations: BUY and SELL.
- BUY: We pay SBD, and want to receive STEEM
- SELL: We pay STEEM, and want to receive SBD
So, We get the following correspondence
| Asset | How to calculate |
|---|---|
| STEEM in internal market | Remaining STEEM in all opening SELL order |
| STEEM DOLLARS in internal market | Remaining SBD in all opening BUY order |
There is a API named get_open_orders, will return all open orders in internal market for specified account.
vector<extended_limit_order> get_open_orders( string owner )const;
The example return information for my account.
We can draw the results from above information: we have 0.586 STEEM and 2 SBD in internal market.
The assets(SBD) in conversion processes
As I mentioned in previous article, if we try to convert some amount SBD to STEEM, it will disappear from the wallet. So to accurately calculate the estimated account value, we need to get this part of SBD.
Fortunately, there is a API called get_conversion_requests.
vector<convert_request_api_obj> get_conversion_requests( const string& account_name )const;
The result should like this one, We can work out the total amount of SBD easily.
The assets(rewards) to be claimed
And after HF18, users need to claim their rewards manually, so to accurately calculate the estimated account value, we need to add this part: Rewards to be claim.
The good news is we can retrieval them directly from user info, with same API get_accounts and the same way.
| Item | Key |
|---|---|
| STEEM Reward to be claimed | reward_steem_balance |
| STEEM DOLLARS to be claimed | reward_sbd_balance |
| STEEM POWER to be claimed | reward_vesting_balance / reward_vesting_steem |
For STEEM POWER to be claimed, we can obtain it from reward_vesting_balance or reward_vesting_steem, but the previous one need to be converted, so the later one is better.
For detailed usage of APIs, Please refer to the steem source code on Github.
中文
上篇文章中我们得出结论，精确计算账户估值，我们需要读取：
- 钱包资产（包括存款账户）
- 内部市场资产
- 转换中的资产
- 待收取的资产
我们可以使用：
get_accounts读回钱包资产（包括存款账户）
get_open_orders读回并计算出内部市场资产
get_conversion_requests读回并计算出 转换中的资产
get_accounts读回待收取的资产
API的详细用法，请参考Github上的steem源码