Hi(noob here)
I really want to congratulate you on a great site. I find myself using it quite often to calculate profitability for coins
![Smiley](https://bitcointalk.org/Smileys/default/smiley.gif)
I'm hoping to make use of the JSON endpoints and have some questions regarding them.
First off, most important, fair use policies. I respect your work and don't want to be that guy that hits your API unnecessarily. So, here are my questions regarding that.
How often should I query the respective /coins.json, /asic.json, and calculators.json endpoints?
What is a good refresh rate for these endpoints from third-party clients?
To partly answer my own questions. I read on this forum that the rate limit is 80RPM and the coin data is refreshed every 3 minutes.
One more questions about the rate limit. Is 80RPM limit per user/IP across all endpoints?
I've noticed that there are JSON files for the following:
GPU -
http://whattomine.com/coins.jsonASIC -
http://whattomine.com/asic.jsonCoins -
http://whattomine.com/calculators.jsonIndividual Coin -
http://whattomine.com/coins/192.jsonMy guess is that /coins.json and /asic.json gives you all the GPU and ASIC coins on Whattomine form what I could gather from the website links. From here you can determine, by looking at the data, what coins are profitable to mine. See my question about "profitability" and "profitability24" below.
A good workflow would be to cache coins retrieved from these endpoints and then once I have determined the best profitable coins to mine, I build the URL to an individual coin(in your language of choice) from the subset of data and request the data from /coins/<coin_id>.json.
These results need to be cached, and the cache warmed up, all the while respecting your API's fair use policy.
How am I doing so far?
![Smiley](https://bitcointalk.org/Smileys/default/smiley.gif)
"profitability" and "profitability24" values.
It seems those are percentages. Am I correct? What percentages should one look at here? Is 100% and above considered good profitability, or are there other percentage ranges to consider too, for example, 110% - 125%?
On to /calculators.json.
What does the "lagging", "listed" and "testing" values mean in the response to /calculators.json?
I had a look at a coin called Aeon, and although it's "status" is "Active" the "listed" value is false. I don't know what that means.
What does "testing" indicate? Does "testing": true mean you are testing it?
My following question pertains to the estimation calculations for a particular coin. Let's stick with Aeon to simplify things. Only because I have mentioned Aeon above.
These stats are from
http://whattomine.com/coins/192.json, which also reflects the data on the web page.
So, I gathered that the following values correspond to "Day Rewards" under "Estimated Rewards". See my questions inline with the JSON values below.
"pool_fee": "0.000000", // is this the network fee?
"estimated_rewards": "0.823975", // what currency is this and on what calculations is this based?
"btc_revenue": "0.00032526",
"revenue": "$3.63", // For calculating revenue, cost, and profit, what default values were used?
"cost": "$0.79", // for cost=0.79, and revenue=3.63? I know the profit=revenue-cost
"profit": "$2.84",
"status": "Active",
"lagging": false, // I've asked this above, but what does "lagging" mean?
Very best
Bjorn
![Smiley](https://bitcointalk.org/Smileys/default/smiley.gif)