ETHRank API Documentation

Get ETHRank and Score for a Single Address

Returns the ETHRank and score of a given address in JSON format.

https://ethrank.io/api/address/0xfe6b2924685dc14cd3ea4688539de5307c40312a

Try this endpoint in your browser 🔗.

Sample Response
{"score":610,"rank":1151,"progress":["040","111","146","240","041","042","04","001"]}

How to use this API

scoreThe cumulative score calculated by the sum of all steps, goals and acheivements completed.
rankThe current rank of the user for this season (1=top score)
progressA string array mapping to the indexes of the steps, goals and achievements in the JSON definition for the current season.

Example: 000
0 - First Achievement in the list
0 - First Goal in the First Achievement
0 - First Step in the Second Goal of the First Achievement

Using the Season 2 JSON definitions as an example, this user has completed the "Own 1 Metagon" Step of the "ETHRank Supporter" Goal which is part of the "The Enthusiast" Achievement.

Usage Limits

Please be considerate in your use of the ETHRank API. Do not exceed 1 request per 5 seconds, or 10 requests per minute. Attempts to go beyond these limits are restricted.

Copyright Notice

Use of this API must be accompanied by a link back to ETHRank.io, or the text "Powered by ETHRank" must be clearly visible on any websites, dapps, projects, businesses, reports, or any other work product that uses this API.

Disclaimer

This API is provided free of charge, and is subject to change and/or cancellation at any time. ETHRank API is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.