ETHRank API Documentation

Get ETHRank and Score for a Single Address

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

Try this endpoint in your browser 🔗.

Sample Response

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.

Get Labels for a Single Address

Returns labels for spanning all seasons of a given address in JSON format.[address]

Try this endpoint in your browser 🔗.

Sample Response
  "name": "ETHRank Elite",
  "slug": "ethrank-elite",
  "category": "reputation",
  "points": 50,
  "steps": [
    "name": "Own 1 ETHRank Season 1 Badge",
    "points": 50,
    "type": "own_token_by_address",
    "params": {
      "count": 1,
      "address": "0x26AdbB495C1A66238e4155E407E0702FFeC03dF2"

How to use this API

nameThe name of the achievement, goal, or step
slugA search-engine-friendly version of the name
categoryThe corresponding ETHRank category for this achievement
pointsThe number of points awarded for this achievement
stepsThe steps involved in reaching the 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, 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.


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.