Overall Score

Overall score based on weighted formula of aggregation. Liquidity, Security, Decentralization, Tokenomics, Development, Social Score components are aggregated to calculate overall score.

Retrieves the aggregated Overall Score of the protocols.

This endpoint returns the aggregated Overall Score of the protocols from the last 7 days.

GEThttps://api.alterscope.org/scores/overall/{protocol}

Authorization

BearerAuth

Path parameters

protocol*string

the name of the protocol in lowercase

Response

200404505

OK

Body

application/json

statusboolean

dataarray of ScoreData (object)

Request

JavaScriptCurl

const response = await fetch('https://api.alterscope.org/scores/overall/{protocol}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

Response

{
  "status": true,
  "data": [
    {
      "score": 0.22448096615490729,
      "timestamp": "2023-09-11T12:00:06Z"
    }
  ]
}

Sample Request

The sample request below retrieves the aggregated overall score of the protocols. For a comprehensive list of protocols whose data can be requested please refer to supported protocols page.

curl https://api.alterscope.org/scores/overall/uniswap -H "Authorization: Bearer <your_access_token>"

Sample Response

{
   "status":true,
   "data":[
      {
         "score":0.4708198194015,
         "timestamp":"2023-12-18T12:00:04Z"
      },
      {
         "score":0.46655607131899995,
         "timestamp":"2023-12-17T12:00:02Z"
      },
      {
         "score":0.47012516788075,
         "timestamp":"2023-12-16T12:00:07Z"
      },
      {
         "score":0.47001089536724994,
         "timestamp":"2023-12-15T12:00:03Z"
      },
      {
         "score":0.47107155475749996,
         "timestamp":"2023-12-14T12:00:07Z"
      },
      {
         "score":0.47139366365249996,
         "timestamp":"2023-12-13T14:02:01Z"
      },
      {
         "score":0.46844405028974995,
         "timestamp":"2023-12-12T12:00:02Z"
      }
   ]
}

Sample Response Description

score: Alterscope calculates an overall score for a cryptocurrency or blockchain project by considering various factors that contribute to its performance and viability. These factors include decentralization, social engagement, development activity, tokenomics, liquidity, and security. Know more about Alterscope score here.

timestamp: Represents the point in time when the data was recorded.